# Cuentas 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`](/docs/operaciones/listar-cuentas-para-recibir/) da cada cuenta, con su moneda. Pide el scope `accounts:read`.

## 2. Abre la que falta

[`POST /v1/receiving-accounts`](/docs/operaciones/abrir-cuenta-para-recibir/) 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.