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

# Cuentas

## Posibles eventos

Eventos dosponibles

* `account.pending`
* `account.connected`
* `account.disconnected`
* `account.validated`
* `account.uncompleted`

## Posibles estados de una cuenta.

* `PENDING`
* `CONNECTED`
* `DISCONNECTED`
* `VALIDATED`
* `UNCOMPLETED`

### Seguridad y reintentos

La autenticación de las entregas, el calendario de reintentos y la desactivación automática del
endpoint son iguales para todos los eventos y están en
[Webhooks](/client/webhooks/index): valida siempre `x-webhook-token` y, si configuraste un
`secret`, también el header `Signature`.

* Los eventos pueden llegar más de una vez. Deduplica por `event.type` + el `id` de la cuenta y evita procesar el mismo evento dos veces.
* Responde `200 OK` solo cuando hayas persistido los cambios; de lo contrario envía `500` para forzar un nuevo intento automático.

## Ejemplo

```json theme={null}
{
   "account":{
      "bank_id":"9b90ba74-4a99-4beb-827d-2df3236c2549",
      "subtype":"SAVINGS",
      "authorization":false,
      "id":"9b90ba74-5743-4eb3-a6a8-a1503919c98f",
      "status":"PENDING",
      "title":"Swift Group **** 7890",
      "created_at":"2024-03-14T23:30:57.000000Z",
      "method_type":"account",
      "bank":{
         "id":"9b90ba74-4a99-4beb-827d-2df3236c2549",
         "name":"Swift Group",
         "supported_types":[
            "SAVINGS"
         ],
         "mask":null,
         "transaction_avg":null,
         "available":0,
         "connection_type":"CONFIRMATION",
         "logo":null,
         "instructions":null
      }
   },
   "event":{
      "type":"account.pending",
      "timestamp":1689262934,
      "environment":"live|test"
   }
}
```
