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

> Un token de validación embebida gastó sus intentos sin un pago verificado

payment\_verification.failed

## Qué significa

Tu cliente usó un token de [validación embebida](https://docs.cobrix.co/api-guides/embedded-payment-verification.md) y gastó sus intentos sin un pago verificado ni un Zelle en revisión. El token quedó `exhausted`.

* **Llega como mucho una vez por token.** Nunca por cada intento fallido.
* **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": "payment_verification.failed",
  "created_at": "2026-11-17T12:09:00.000Z",
  "api_version": "2025-01-21",
  "data": {
    "tokenId": "0f8fad5b-…",
    "externalReference": "PED-1001",
    "amountMinor": 150000,
    "currency": "VES",
    "receiverAccountKey": "bank:3d9a7c52-…",
    "attemptsUsed": 5,
    "maxAttempts": 5
  }
}
```

| Campo | Qué significa |
| - | - |
| `tokenId` | El `id` del token. |
| `externalReference` | Tu referencia del pedido, la que enviaste al emitir el token. |
| `amountMinor`, `currency` | El monto y la moneda del pedido. |
| `receiverAccountKey` | La cuenta receptora del token. |
| `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 una validación: el token pudo dejar una validación por intento, y ninguna quedó `verified`. No trae datos del pagador: ni referencias, ni teléfono, ni cédula.

## Qué hacer

* No entregues el pedido.
* Si tu cliente quiere intentarlo otra vez, emite un token nuevo.
* El detalle de cada intento está en `lastErrorCode` del token y en `GET /payment-verifications/{verificationId}`.
* 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 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ó un pedido, consulta `GET /payment-verifications/tokens/{tokenId}`. No esperes este evento.


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