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

# Token de vuelto agotado

> Un token de vuelto embebido se quedó sin envíos sin crear un vuelto

customer\_payout\_token.failed

## Qué significa

La persona usó un token de [vuelto embebido](https://docs.cobrix.co/api-guides/embedded-customer-payout.md) y el token se quedó sin envíos sin crear un vuelto. El token quedó `exhausted`: cuando caduca se lee `expired`, y si lo revocas, `revoked`. No salió dinero.

Pasa en dos casos:

* **Gastó sus 3 intentos:** el banco de la cuenta de origen no aceptó los datos que escribió la persona.
* **Llegó a su tope de envíos**, también cuando todos los intentos se devolvieron por un límite de tu empresa, por ejemplo el tope diario.

Llega como mucho una vez por token, nunca por cada intento. Puede no llegar: consulta [Cuándo no se envía](#cuándo-no-se-envía).

## Payload completo

```json theme={null}
{
  "id": "evt_91ab4c2d-7e3f-4a5b-8c6d-0e1f2a3b4c5d",
  "event": "customer_payout_token.failed",
  "created_at": "2026-11-17T12:03:00.000Z",
  "api_version": "2025-01-21",
  "data": {
    "tokenId": "0f8fad5b-…",
    "externalReference": "PED-1001",
    "amountMinor": 150000,
    "currency": "VES",
    "customerId": "2c7a9e1b-…",
    "attemptsUsed": 3,
    "maxAttempts": 3
  }
}
```

| Campo | Qué significa |
| - | - |
| `tokenId` | El `id` del token. |
| `externalReference` | Tu referencia, la que enviaste al emitir el token. |
| `amountMinor`, `currency` | El monto del vuelto, en bolívares. |
| `customerId` | El cliente del vuelto. |
| `attemptsUsed`, `maxAttempts` | Los intentos gastados y los que tenía. `attemptsUsed` puede ser menor que `maxAttempts`: el token llegó a su tope de envíos. |

`data` no es un vuelto: el token no creó ninguno. No trae datos de quien recibe: ni banco, ni teléfono, ni cédula.

## Qué hacer

* No hay vuelto que dar por pagado ni que reintentar.
* Si la persona quiere intentarlo otra vez, emite un token nuevo.
* El motivo del último intento está en `lastErrorCode` del token. Con `payout_daily_limit_exceeded`, el tope diario de tu empresa ya no admite ese vuelto hoy.
* Deduplica por el `id` del evento. Consulta [Entrega y reintentos](https://docs.cobrix.co/guides/webhooks/delivery.md).

## Cuándo no se envía

| Caso | Cómo queda el token |
| - | - |
| El token creó su vuelto. Llegan los eventos `customer_payout.*` de ese vuelto. | `used` |
| El token caducó con intentos sin usar. | `expired` |
| Revocaste el token, o la llave que lo emitió dejó de servir. | `revoked` |
| Cobrix no pudo registrar el cierre del token. Es poco frecuente y no se reintenta. | `exhausted` |

> [!WARNING]
>
> **La fuente de verdad es el token.** Si necesitas saber cómo terminó, consulta `GET /customer-payouts/tokens/{tokenId}`. No esperes este evento.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.