This document provides specific details for using the Fluz Gift Card Vendor API Adapter with TangoCard as the vendor.

Original TangoCard API vs Fluz API Adapter

Base URL

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

Authentication

Original TangoCard

• Uses Basic Authentication with username and password.

Username: QAPlatform2
Password: apYPfT6HNONpDRUj3CLGWYt7gvIHONpDRUYPfT6Hj

Fluz API Adapter

• Uses Basic Authentication with the Authorization header (same as all vendor integrations).

	Authorization: Basic <FLUZ-API-Key>

API Endpoint Comparison

Operation	TangoCard Endpoint	Fluz Endpoint	Notes
Get Order	`GET /v2/orders/:referenceOrderID`	`GET /v2/orders/:referenceOrderID`	Retrieve details for a specific order
Get All Orders	`GET /v2/orders/`	`GET /v2/orders`	Retrieve all orders
Create Order	`GET /v2/orders/`	`POST /v2/orders/`	Create a new gift card order (processed as a background operation)
Get Balance (All Accounts)	`GET /v2/accounts`	`GET /v2/accounts`	Get balance information for all accounts
Get Balance (By Account)	`GET /v2/accounts/:accountId`	`GET /v2/accounts/:id`	Get balance for a specific account

Request Examples

Create Order

Original TangoCard Request:

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

Fluz API Adapter Request:

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

Background Processing for TangoCard Orders

All purchase operations through the TangoCard integration are processed as background operations. However, for compatibility with TangoCard's API behavior, the Fluz API Adapter may return full results synchronously by default.

📘
Note: Even when results appear synchronous, all purchases are still scheduled and tracked as background operations internally for improved reliability and better handling of retries.

Example Usage with cURL

Example 1: Get a Specific Order

# 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>"

Example 2: Get All Orders

# 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>"

Example 3: Get Balance for All Accounts

# 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>"

Example 4: Get Balance for a Specific Account

# 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>"

Example 5: Create a New Order

# 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"
  }'