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: 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

{
   "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"
   }
}