> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fluz.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Tango Card

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](https://integration-api.tangocard.com/rass)
* Adaptador de API de Fluz:
  * Staging: [https://api-adapter.staging.fluzapp.com/tangocard](https://api-adapter.staging.fluzapp.com/tangocard)

## Autenticación

### TangoCard original

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

```text theme={null}
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).

```text theme={null}
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:

```text theme={null}
{
  "sendEmail": false,
  "accountIdentifier": "testing1234account",
  "customerIdentifier": "johnr002",
  "utid": "U561593",
  "amount": 50
}
```

### Solicitud del Adaptador de API de Fluz:

```text theme={null}
{
  "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.

<Callout icon="📘">
  **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.
</Callout>

## Ejemplo de uso con cURL

### Ejemplo 1: Obtener una orden específica

```text theme={null}
# 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

```text theme={null}
# 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

```text theme={null}
# 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

```text theme={null}
# 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

```text theme={null}
# 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"
  }'
```