本文档提供将 Fluz 礼品卡供应商 API 适配器与 TangoCard 作为供应商一起使用的具体细节。

原生 TangoCard API 与 Fluz API 适配器

基础 URL

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

认证

原生 TangoCard

使用用户名和密码的 Basic Authentication。

Username: QAPlatform2
Password: apYPfT6HNONpDRUj3CLGWYt7gvIHONpDRUYPfT6Hj

Fluz API 适配器

使用带有 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 适配器请求：

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

TangoCard 订单的后台处理

通过 TangoCard 集成的所有购买操作都会作为后台操作处理。不过，为了与 TangoCard 的 API 行为保持兼容，Fluz API 适配器默认可能会同步返回完整结果。

注意： 即使结果看起来是同步的，所有购买仍会在内部作为后台操作进行调度和跟踪，以提高可靠性并更好地处理重试。

使用 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 适配器

基础 URL

认证

原生 TangoCard

Fluz API 适配器

API 端点对比

请求示例

创建订单

原生 TangoCard 请求：

Fluz API 适配器请求：

TangoCard 订单的后台处理

使用 cURL 的示例

示例 1：获取特定订单

示例 2：获取所有订单

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

示例 4：获取特定账户的余额

示例 5：创建新订单

​原生 TangoCard API 与 Fluz API 适配器

​基础 URL

​认证

​原生 TangoCard

​Fluz API 适配器

​API 端点对比

​请求示例

​创建订单

​原生 TangoCard 请求：

​Fluz API 适配器请求：

​TangoCard 订单的后台处理

​使用 cURL 的示例

​示例 1：获取特定订单

​示例 2：获取所有订单

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

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

​示例 5：创建新订单

原生 TangoCard API 与 Fluz API 适配器

基础 URL

认证

原生 TangoCard

Fluz API 适配器

API 端点对比

请求示例

创建订单

原生 TangoCard 请求：

Fluz API 适配器请求：

TangoCard 订单的后台处理

使用 cURL 的示例

示例 1：获取特定订单

示例 2：获取所有订单

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

示例 4：获取特定账户的余额

示例 5：创建新订单