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

# Dispersión devuelta

> El banco devolvió el dinero de una transferencia

payout.returned

Se emite una vez por cada transferencia cuyo dinero devolvió el banco. `data.returnedTransfer` es esa transferencia, la misma que aparece en `data.payout.transfers`. Ese dinero vuelve a salir. Mientras tanto, esa transferencia se ve `in_review` si Cobrix la reenvía en esta dispersión, o `retrying` si sale en la siguiente. `payout.completed` llega cuando todo terminó.

## Payload completo

```json theme={null}
{
  "id": "evt_7d8e9f0a-1b2c-4d3e-8f4a-5b6c7d8e9f0a",
  "event": "payout.returned",
  "created_at": "2026-11-05T11:30:00.000Z",
  "api_version": "2025-01-21",
  "data": {
    "payout": {
      "payoutId": "4e7a2c90-1d3b-4f8e-a6c5-9b0d2e1f3a74",
      "createdAt": "2026-11-04T22:00:00.000Z",
      "status": "in_review",
      "currency": "VES",
      "paymentsCount": 37,
      "salesMinor": 1250000,
      "costMinor": 33911,
      "receivedMinor": 1216089,
      "transfers": [
        {
          "beneficiaryId": "f3d2a0e2-5b7d-4a8e-9f1c-2d3e4f5a6b7c",
          "kind": "principal",
          "bankCode": "0138",
          "bankName": "Banco Plaza",
          "maskedAccount": "•••• 0066",
          "alias": null,
          "status": "received",
          "amountMinor": 730530,
          "otherBankFeeMinor": 0,
          "bankReference": "004412883",
          "receivedAt": "2026-11-05T09:12:40.000Z"
        },
        {
          "beneficiaryId": "a90c1e2f-3a4b-4c5d-8e6f-7a8b9c0d1e2f",
          "kind": "api",
          "bankCode": "0102",
          "bankName": "Banco de Venezuela",
          "maskedAccount": "•••• 2345",
          "alias": "Socio Llanos",
          "status": "in_review",
          "amountMinor": 485559,
          "otherBankFeeMinor": 1461,
          "bankReference": "004412884",
          "receivedAt": null
        }
      ]
    },
    "returnedTransfer": {
      "beneficiaryId": "a90c1e2f-3a4b-4c5d-8e6f-7a8b9c0d1e2f",
      "kind": "api",
      "bankCode": "0102",
      "bankName": "Banco de Venezuela",
      "maskedAccount": "•••• 2345",
      "alias": "Socio Llanos",
      "status": "in_review",
      "amountMinor": 485559,
      "otherBankFeeMinor": 1461,
      "bankReference": "004412884",
      "receivedAt": null
    }
  }
}
```

## Qué hacer

| Condición | Acción |
| - | - |
| Llega `payout.returned` | No des por recibida esa transferencia. |
| Llega `payout.completed` después | Ahí la dispersión ya terminó; concilia con ese aviso. |


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