APICuentas para recibir
Abrir una cuenta en otra moneda y dar sus datos a quien te paga.
Una cuenta para recibir son los datos que le das a quien te paga. Tu CLABE en MXN ya viene con tu empresa; las demás se abren por API, una por moneda.
1. Consulta las que ya tienes
GET /v1/receiving-accounts da cada cuenta, con su moneda. Pide el scope accounts:read.
2. Abre la que falta
POST /v1/receiving-accounts con currency en USD, EUR, BRL, GBP o COP. Pide el scope accounts:write, firma e Idempotency-Key. Las llaves que ya tienes no traen ese scope: crea una que lo incluya.
| Respuesta | Qué significa | Qué haces |
|---|---|---|
201 | Se abrió, con status: active | Usa sus datos |
200 | Ya existía, con already_existed: true | Usa sus datos: es la misma cuenta |
202 | Aún no se confirma, con status: processing y los datos en null | No compartas nada. Repite con la misma clave |
403 not_enabled | Esa moneda no está activada para tu empresa | Pídela a tu ejecutivo FITAL |
409 receiving_account_in_progress | Otra alta de esa moneda sigue en curso | Reintenta en unos segundos |
422 currency_not_supported | Esa moneda no se abre por API, como MXN | Usa tu CLABE |
422 receiving_account_rejected | No se pudo abrir | Contacta a tu ejecutivo FITAL |
3. Comparte los datos de cada moneda
| Moneda | Campos |
|---|---|
USD | account_number y routing_number |
EUR | iban y bic |
GBP | account_number y sort_code |
BRL | pix_key y br_code |
COP | account_number y bre_b_key |
Un campo que no aplica llega en null. holder también puede llegar en null: no lo sustituyas con otro nombre.