Este documento proporciona detalles específicos para usar el Adaptador de API de Proveedor de Tarjetas de Regalo de Fluz con TangoCard como proveedor.

API original de TangoCard vs Adaptador de API de Fluz

URL base

API original de TangoCard: https://integration-api.tangocard.com/rass
Adaptador de API de Fluz:
- Staging: https://api-adapter.staging.fluzapp.com/tangocard
- Producción: https://api-adapter.fluzapp.com/tangocard

Autenticación

TangoCard original

Usa Autenticación Básica con nombre de usuario y contraseña.

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

Adaptador de API de Fluz

Usa Autenticación Básica con el encabezado Authorization (igual que todas las integraciones de proveedores).

Authorization: Basic <FLUZ-API-Key>

Comparación de endpoints de API

Operación	Endpoint de TangoCard	Endpoint de Fluz	Notas
Obtener orden	`GET /v2/orders/:referenceOrderID`	`GET /v2/orders/:referenceOrderID`	Recupera detalles de una orden específica
Obtener todas las órdenes	`GET /v2/orders/`	`GET /v2/orders`	Recupera las 100 órdenes más recientes
Crear orden	`POST /v2/orders/`	`POST /v2/orders/`	Crea una nueva orden de tarjeta de regalo
Obtener saldo (todas las cuentas)	`GET /v2/accounts`	`GET /v2/accounts`	Obtiene información de saldo para todas las cuentas
Obtener saldo (por cuenta)	`GET /v2/accounts/:accountId`	`GET /v2/accounts/:id`	Obtiene el saldo de una cuenta específica

Ejemplos de request

Crear orden

Request original de TangoCard:

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

Request del Adaptador de API de Fluz:

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

Las órdenes se financian desde la cuenta para la que se emitió tu clave de la API de Fluz, por lo que accountIdentifier y customerIdentifier se mantienen para compatibilidad con la forma de tu request existente. Correlaciona una orden usando referenceOrderID de la respuesta.

Tiempos de respuesta

Crear orden es sincrónico y siempre se ejecuta hasta completarse. La llamada no regresa hasta que la compra haya finalizado, lo que puede tomar hasta 150 segundos; por lo tanto, configura el tiempo de espera de lectura de tu cliente por encima de ese valor.

Los valores de estado de la orden son de Fluz, no de TangoCard. El campo status devuelve PENDING, IN_PROGRESS, COMPLETED, FAILED o CANCELED. Una verificación contra un valor de TangoCard como COMPLETE no coincidirá. Consulta Comportamiento del conector para valores de estado, respuestas de error, límites y restricciones de request.

Ejemplos de uso con cURL

Ejemplo 1: Obtener una orden específica

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

Ejemplo 2: Obtener todas las órdenes

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

Ejemplo 3: Obtener saldo de todas las cuentas

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

Ejemplo 4: Obtener saldo de una cuenta específica

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

Ejemplo 5: Crear una nueva orden

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

Desarrolladores

Recetas

Tango Card

API original de TangoCard vs Adaptador de API de Fluz

URL base

Autenticación

TangoCard original

Adaptador de API de Fluz

Comparación de endpoints de API

Ejemplos de request

Crear orden

Request original de TangoCard:

Request del Adaptador de API de Fluz:

Tiempos de respuesta

Ejemplos de uso con cURL

Ejemplo 1: Obtener una orden específica

Ejemplo 2: Obtener todas las órdenes

Ejemplo 3: Obtener saldo de todas las cuentas

Ejemplo 4: Obtener saldo de una cuenta específica

Ejemplo 5: Crear una nueva orden

​API original de TangoCard vs Adaptador de API de Fluz

​URL base

​Autenticación

​TangoCard original

​Adaptador de API de Fluz

​Comparación de endpoints de API

​Ejemplos de request

​Crear orden

​Request original de TangoCard:

​Request del Adaptador de API de Fluz:

​Tiempos de respuesta

​Ejemplos de uso con cURL

​Ejemplo 1: Obtener una orden específica

​Ejemplo 2: Obtener todas las órdenes

​Ejemplo 3: Obtener saldo de todas las cuentas

​Ejemplo 4: Obtener saldo de una cuenta específica

​Ejemplo 5: Crear una nueva orden

API original de TangoCard vs Adaptador de API de Fluz

URL base

Autenticación

TangoCard original

Adaptador de API de Fluz

Comparación de endpoints de API

Ejemplos de request

Crear orden

Request original de TangoCard:

Request del Adaptador de API de Fluz:

Tiempos de respuesta

Ejemplos de uso con cURL

Ejemplo 1: Obtener una orden específica

Ejemplo 2: Obtener todas las órdenes

Ejemplo 3: Obtener saldo de todas las cuentas

Ejemplo 4: Obtener saldo de una cuenta específica

Ejemplo 5: Crear una nueva orden