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
- Production: https://api-adapter.fluzapp.com/tangocard

Authentication

Original TangoCard

Uses Basic Authentication with username and password.

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

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 the 100 most recent orders
Create Order	`POST /v2/orders/`	`POST /v2/orders/`	Create a new gift card order
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"
}

Orders are funded from the account your Fluz API key is issued for, so accountIdentifier and customerIdentifier are kept for compatibility with your existing request shape. Correlate an order using referenceOrderID from the response.

Response timing

Create order is synchronous, always running to completion. The call does not return until the purchase has finished, which can take up to 150 seconds, so set your client’s read timeout above that.

Order status values are Fluz’s, not TangoCard’s. The status field returns PENDING, IN_PROGRESS, COMPLETED, FAILED, or CANCELED. A check against a TangoCard value such as COMPLETE will not match. See Connector behaviour for status values, error responses, limits, and request constraints.

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

Developers

Recipes

Tango Card

Original TangoCard API vs Fluz API Adapter

Base URL

Authentication

Original TangoCard

Fluz API Adapter

API Endpoint Comparison

Request Examples

Create Order

Original TangoCard Request:

Fluz API Adapter Request:

Response timing

Example Usage with cURL

Example 1: Get a Specific Order

Example 2: Get All Orders

Example 3: Get Balance for All Accounts

Example 4: Get Balance for a Specific Account

Example 5: Create a New Order

​Original TangoCard API vs Fluz API Adapter

​Base URL

​Authentication

​Original TangoCard

​Fluz API Adapter

​API Endpoint Comparison

​Request Examples

​Create Order

​Original TangoCard Request:

​Fluz API Adapter Request:

​Response timing

​Example Usage with cURL

​Example 1: Get a Specific Order

​Example 2: Get All Orders

​Example 3: Get Balance for All Accounts

​Example 4: Get Balance for a Specific Account

​Example 5: Create a New Order

Original TangoCard API vs Fluz API Adapter

Base URL

Authentication

Original TangoCard

Fluz API Adapter

API Endpoint Comparison

Request Examples

Create Order

Original TangoCard Request:

Fluz API Adapter Request:

Response timing

Example Usage with cURL

Example 1: Get a Specific Order

Example 2: Get All Orders

Example 3: Get Balance for All Accounts

Example 4: Get Balance for a Specific Account

Example 5: Create a New Order