本文档提供在以 TangoCard 作为供应商时，如何使用 Fluz 礼品卡供应商 API 适配器的具体细节。

原生 TangoCard API 与 Fluz API 适配器

基础 URL

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

认证

原生 TangoCard

使用用户名和密码的基本认证（Basic Authentication）。

Username: <TANGOCARD-USERNAME>
Password: <TANGOCARD-PASSWORD>

Fluz API 适配器

使用带有 Authorization 头的基本认证（与所有供应商集成相同）。

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`	获取最近的 100 个订单
Create Order	`POST /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 适配器请求：

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

订单由发给你 Fluz API 密钥所对应的账户出资，因此保留 accountIdentifier 和 customerIdentifier 以兼容你现有的请求结构。使用响应中的 referenceOrderID 来关联订单。

响应时机

创建订单为同步操作，始终运行至完成。调用在购买完成前不会返回，可能需要最长 150 秒，因此请将客户端的读取超时设置在该值以上。

订单状态值是 Fluz 的，而非 TangoCard 的。 status 字段返回 PENDING、IN_PROGRESS、COMPLETED、FAILED 或 CANCELED。与 TangoCard 的值如 COMPLETE 进行比较将不会匹配。有关状态值、错误响应、限制和请求约束，请参见 Connector behaviour。

使用 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 call blocks until the purchase completes. Allow up to 150 seconds.
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 适配器

基础 URL

认证

原生 TangoCard

Fluz API 适配器

API 端点对比

请求示例

创建订单

原生 TangoCard 请求：

Fluz API 适配器请求：

响应时机

使用 cURL 的示例

示例 1：获取指定订单

示例 2：获取所有订单

示例 3：获取所有账户余额

示例 4：获取指定账户余额

示例 5：创建新订单

​原生 TangoCard API 与 Fluz API 适配器

​基础 URL

​认证

​原生 TangoCard

​Fluz API 适配器

​API 端点对比

​请求示例

​创建订单

​原生 TangoCard 请求：

​Fluz API 适配器请求：

​响应时机

​使用 cURL 的示例

​示例 1：获取指定订单

​示例 2：获取所有订单

​示例 3：获取所有账户余额

​示例 4：获取指定账户余额

​示例 5：创建新订单

原生 TangoCard API 与 Fluz API 适配器

基础 URL

认证

原生 TangoCard

Fluz API 适配器

API 端点对比

请求示例

创建订单

原生 TangoCard 请求：

Fluz API 适配器请求：

响应时机

使用 cURL 的示例

示例 1：获取指定订单

示例 2：获取所有订单

示例 3：获取所有账户余额

示例 4：获取指定账户余额

示例 5：创建新订单