本文件提供將 Fluz Gift Card Vendor API Adapter 與 TangoCard 作為供應商時的特定使用細節。

原生 TangoCard API 與 Fluz API Adapter 比較

基本 URL

原生 TangoCard API：https://integration-api.tangocard.com/rass
Fluz API Adapter：
- Staging：https://api-adapter.staging.fluzapp.com/tangocard

認證

原生 TangoCard

使用 Basic Authentication（使用者名稱與密碼）。

Username: QAPlatform2
Password: apYPfT6HNONpDRUj3CLGWYt7gvIHONpDRUYPfT6Hj

Fluz API Adapter

使用 Authorization 標頭的 Basic Authentication（與所有供應商整合相同）。

Authorization: Basic <FLUZ-API-Key>

API 端點比較

Operation	TangoCard Endpoint	Fluz Endpoint	Notes
Get Order	`GET /v2/orders/:referenceOrderID`	`GET /v2/orders/:referenceOrderID`	取得特定訂單的詳細資訊
Get All Orders	`GET /v2/orders/`	`GET /v2/orders`	取得所有訂單
Create Order	`GET /v2/orders/`	`POST /v2/orders/`	建立新的禮品卡訂單（以背景作業處理）
Get Balance (All Accounts)	`GET /v2/accounts`	`GET /v2/accounts`	取得所有帳戶的餘額資訊
Get Balance (By Account)	`GET /v2/accounts/:accountId`	`GET /v2/accounts/:id`	取得特定帳戶的餘額

請求範例

建立訂單

原生 TangoCard 請求：

{
  "sendEmail": false,
  "accountIdentifier": "testing1234account",
  "customerIdentifier": "johnr002",
  "utid": "U561593",
  "amount": 50
}

Fluz API Adapter 請求：

{
  "sendEmail": false,
  "accountIdentifier": "testing1234account",
  "customerIdentifier": "johnr002",
  "utid": "1800FL-US",
  "amount": 40,
  "externalRefID": "d8e118ab-732b-4884-8e8a-70746b5f359e"
}

TangoCard 訂單的背景處理

透過 TangoCard 整合進行的所有購買操作都會以背景作業的方式處理。然而，為了與 TangoCard 的 API 行為相容，Fluz API Adapter 可能會預設同步回傳完整結果。

注意： 即使結果看似同步，所有購買仍會在內部排程並追蹤為背景作業，以提升可靠性並更好地處理重試。

使用 cURL 的範例

範例 1：取得特定訂單

# Get a specific order with TangoCard via Fluz API Adapter
curl -X GET "https://api-adapter.staging.fluzapp.com/tangocard/v2/orders/72991f5a-b389-404e-98b0-ac5444839ca9" \
  -H "Authorization: Basic <FLUZ-API-Key>"

範例 2：取得所有訂單

# Get all orders with TangoCard via Fluz API Adapter
curl -X GET "https://api-adapter.staging.fluzapp.com/tangocard/v2/orders" \
  -H "Authorization: Basic <FLUZ-API-Key>"

範例 3：取得所有帳戶餘額

# Get Balance for all accounts with TangoCard via Fluz API Adapter
curl -X GET "https://api-adapter.staging.fluzapp.com/tangocard/v2/accounts" \
  -H "Authorization: Basic <FLUZ-API-Key>"

範例 4：取得特定帳戶餘額

# Get Balance for a specific account with TangoCard via Fluz API Adapter
curl -X GET "https://api-adapter.staging.fluzapp.com/tangocard/v2/accounts/testing1234account" \
  -H "Authorization: Basic <FLUZ-API-Key>"

範例 5：建立新訂單

# Create Order with TangoCard via Fluz API Adapter
# Note: This operation runs as a background process but may return complete results
curl -X POST "https://api-adapter.staging.fluzapp.com/tangocard/v2/orders" \
  -H "Authorization: Basic <FLUZ-API-Key>" \
  -H "Content-Type: application/json" \
  -d '{
    "sendEmail": false,
    "accountIdentifier": "testing1234account",
    "customerIdentifier": "johnr002",
    "utid": "1800FL-US",
    "amount": 40,
    "externalRefID": "d8e118ab-732b-4884-8e8a-70746b5f359e"
  }'

開發者

實用範例

Tango Card

原生 TangoCard API 與 Fluz API Adapter 比較

基本 URL

認證

原生 TangoCard

Fluz API Adapter

API 端點比較

請求範例

建立訂單

原生 TangoCard 請求：

Fluz API Adapter 請求：

TangoCard 訂單的背景處理

使用 cURL 的範例

範例 1：取得特定訂單

範例 2：取得所有訂單

範例 3：取得所有帳戶餘額

範例 4：取得特定帳戶餘額

範例 5：建立新訂單

​原生 TangoCard API 與 Fluz API Adapter 比較

​基本 URL

​認證

​原生 TangoCard

​Fluz API Adapter

​API 端點比較

​請求範例

​建立訂單

​原生 TangoCard 請求：

​Fluz API Adapter 請求：

​TangoCard 訂單的背景處理

​使用 cURL 的範例

​範例 1：取得特定訂單

​範例 2：取得所有訂單

​範例 3：取得所有帳戶餘額

​範例 4：取得特定帳戶餘額

​範例 5：建立新訂單

原生 TangoCard API 與 Fluz API Adapter 比較

基本 URL

認證

原生 TangoCard

Fluz API Adapter

API 端點比較

請求範例

建立訂單

原生 TangoCard 請求：

Fluz API Adapter 請求：

TangoCard 訂單的背景處理

使用 cURL 的範例

範例 1：取得特定訂單

範例 2：取得所有訂單

範例 3：取得所有帳戶餘額

範例 4：取得特定帳戶餘額

範例 5：建立新訂單