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

# Vuelto fallido

> Un vuelto que pediste por la API no salió de la cuenta

customer\_payout.failed

## Qué significa

No salió dinero de la cuenta de tu empresa: el banco rechazó el vuelto, el vuelto nunca llegó al banco o se canceló antes de salir. Si el vuelto estuvo antes en `unknown`, Cobrix lo concilió con el banco y confirmó que no se pagó.

`failed` es final.

## Payload completo

```json theme={null}
{
  "id": "evt_3d5f7a9c-1b2e-4c4d-8e6f-0a1b2c3d4e5f",
  "event": "customer_payout.failed",
  "created_at": "2026-11-14T10:00:07.000Z",
  "api_version": "2025-01-21",
  "data": {
    "id": "5a9e3c1d-7f2b-4e86-b0c4-9d8a7f6e5b41",
    "status": "failed",
    "amountMinor": 437825,
    "currency": "VES",
    "sourceAmountMinor": 500,
    "sourceCurrency": "USD",
    "rateEffectiveAt": "2026-11-14T04:00:00.000Z",
    "customerId": "2c7a9e1b-4d6f-4a3c-8b5e-1f0d9c8b7a65",
    "accountId": "8d4f1a6c-3b7e-4c92-a5d0-6e1f2a3b4c5d",
    "beneficiaryMasked": "0102 · ***0000 · V*****78",
    "externalReference": "PED-1001",
    "failureCode": "CODIGO_DEL_BANCO",
    "bankReferenceMasked": null,
    "createdAt": "2026-11-14T10:00:00.000Z",
    "finishedAt": "2026-11-14T10:00:07.000Z"
  }
}
```

## Qué hacer

* Marca el vuelto como no pagado.
* `failureCode` es diagnóstico y depende del banco: guárdalo para soporte y no programes lógica sobre él. Puede venir en `null`.
* Para enviarlo de nuevo, haz un `POST /customer-payouts` con una `Idempotency-Key` nueva. En un vuelto embebido, emite un token nuevo.

> [!NOTE]
>
> Un vuelto de `POST /customer-payouts` que Cobrix no llegó a poner en la cola del banco pasa a `failed` a los 30 minutos sin enviar este evento. Encuéntralo con `GET /customer-payouts?idempotencyKey=`. En un [vuelto embebido](https://docs.cobrix.co/api-guides/embedded-customer-payout.md#webhooks), ese caso sí envía este evento.

Los campos y los estados están en [Vueltos por API](https://docs.cobrix.co/api-guides/customer-payouts.md).


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