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

Autenticación

TangoCard original

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

Username: QAPlatform2
Password: apYPfT6HNONpDRUj3CLGWYt7gvIHONpDRUYPfT6Hj

Adaptador de API de Fluz

Usa Autenticación Básica con el encabezado Authorization (igual que en 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 los detalles de una orden específica
Obtener todas las órdenes	`GET /v2/orders/`	`GET /v2/orders`	Recupera todas las órdenes
Crear orden	`GET /v2/orders/`	`POST /v2/orders/`	Crea una nueva orden de tarjeta de regalo (procesada como una operación en segundo plano)
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 solicitudes

Crear orden

Solicitud original de TangoCard:

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

Solicitud del Adaptador de API de Fluz:

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

Procesamiento en segundo plano para órdenes de TangoCard

Todas las operaciones de compra a través de la integración con TangoCard se procesan como operaciones en segundo plano. Sin embargo, para compatibilidad con el comportamiento de la API de TangoCard, el Adaptador de API de Fluz puede devolver resultados completos de forma síncrona de manera predeterminada.

Nota: Incluso cuando los resultados parezcan síncronos, todas las compras siguen programadas y se rastrean internamente como operaciones en segundo plano para mejorar la confiabilidad y un mejor manejo de reintentos.

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

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 solicitudes

Crear orden

Solicitud original de TangoCard:

Solicitud del Adaptador de API de Fluz:

Procesamiento en segundo plano para órdenes de TangoCard

Ejemplo 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 solicitudes

​Crear orden

​Solicitud original de TangoCard:

​Solicitud del Adaptador de API de Fluz:

​Procesamiento en segundo plano para órdenes de TangoCard

​Ejemplo 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 solicitudes

Crear orden

Solicitud original de TangoCard:

Solicitud del Adaptador de API de Fluz:

Procesamiento en segundo plano para órdenes de TangoCard

Ejemplo 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