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

# Registrar Cuentas Bancarias para Transferencias Fiat

> Vincula la cuenta bancaria fiat de un cliente a SpherePay para habilitar transferencias on-ramp y off-ramp vía rieles de pago ACH, Wire, SEPA o PIX.

Una cuenta bancaria (`bank_account`) en SpherePay es un registro de la cuenta bancaria fiat existente de tu cliente. SpherePay no abre ni gestiona cuentas bancarias — vincula una cuenta que tu cliente ya tiene a su perfil de SpherePay para que pueda usarse como origen o destino para transferencias fiat. Debes registrar al menos una cuenta bancaria antes de crear cualquier transferencia que involucre moneda fiat.

> [!NOTE]
>
> SpherePay registra una cuenta bancaria existente — no abre una nueva cuenta en nombre de tu cliente. La cuenta debe existir ya en el banco del cliente antes del registro.

## Registrar una cuenta bancaria

`POST https://api.spherepay.co/v2/bank-account`

Para el esquema completo de solicitud y respuesta, consulta la [referencia API de Crear Cuenta Bancaria](https://docs.spherepay.co/es/api-reference/bank-account/post.md).

## Rieles y divisas soportados

| Divisa | Rieles Soportados |
| - | - |
| USD | ACH, Wire |
| EUR | SEPA |
| BRL | PIX |

## Campos requeridos por divisa

Los campos requeridos para registrar una cuenta bancaria dependen de la divisa. Usa las pestañas a continuación para ver los campos requeridos y un ejemplo de solicitud para cada uno.

> [tab] USD
>
> Tanto ACH como Wire usan los mismos detalles de cuenta. Incluye ambos en `networks` para registrar para ambos rieles con una sola solicitud.
>
> | Campo | Requerido |
> | - | - |
> | `customerId` | Sí |
> | `bankName` | Sí |
> | `accountName` | Sí |
> | `accountOwner.accountHolderName` | Sí |
> | `accountOwner.address` | Sí |
> | `currency` | Sí — `"usd"` |
> | `accountDetails.accountNumber` | Sí |
> | `accountDetails.routingNumber` | Sí |
> | `accountDetails.accountType` | Sí — `"checking"` o `"savings"` |
> | `networks` | Sí — `["ach"]`, `["wire"]`, o `["ach", "wire"]` |
>
> ```json theme={"dark"}
> {
>   "customerId": "customer_1234567890",
>   "bankName": "Chase",
>   "accountName": "Jane Doe Checking",
>   "accountOwner": {
>     "accountHolderName": "Jane Doe",
>     "address": {
>       "line1": "233 South Wacker Drive",
>       "city": "Chicago",
>       "state": "IL",
>       "postalCode": "60606",
>       "country": "USA"
>     }
>   },
>   "currency": "usd",
>   "accountDetails": {
>     "accountNumber": "1234567890",
>     "routingNumber": "123456789",
>     "accountType": "checking"
>   },
>   "networks": ["ach", "wire"]
> }
> ```

> [tab] EUR
>
> Las cuentas EUR usan IBAN y BIC para transferencias SEPA.
>
> | Campo | Requerido |
> | - | - |
> | `customerId` | Sí |
> | `bankName` | Sí |
> | `accountName` | Sí |
> | `accountOwner.accountHolderName` | Sí |
> | `accountOwner.address` | Sí |
> | `currency` | Sí — `"eur"` |
> | `accountDetails.iban` | Sí |
> | `accountDetails.bic` | Sí |
> | `networks` | Sí — `["sepa"]` |
>
> ```json theme={"dark"}
> {
>   "customerId": "customer_1234567890",
>   "bankName": "Deutsche Bank",
>   "accountName": "Jane Doe SEPA",
>   "accountOwner": {
>     "accountHolderName": "Jane Doe",
>     "address": {
>       "line1": "10 Rue de Rivoli",
>       "city": "Paris",
>       "postalCode": "75001",
>       "country": "FRA"
>     }
>   },
>   "currency": "eur",
>   "accountDetails": {
>     "iban": "DE89370400440532013000",
>     "bic": "COBADEFFXXX"
>   },
>   "networks": ["sepa"]
> }
> ```

> [tab] BRL
>
> Las cuentas BRL usan PIX, la red de pago instantáneo de Brasil. En lugar de un número de cuenta y número de enrutamiento, proporcionas una clave PIX y el tipo de clave.
>
> | Campo | Requerido |
> | - | - |
> | `customerId` | Sí |
> | `bankName` | Sí |
> | `accountName` | Sí |
> | `accountOwner.accountHolderName` | Sí |
> | `accountOwner.address` | Sí — `postalCode` es requerido |
> | `currency` | Sí — `"brl"` |
> | `accountDetails.pixKey` | Sí |
> | `accountDetails.pixKeyType` | Sí — `"cpf"`, `"cnpj"`, `"email"`, `"phone"` o `"random"` |
> | `networks` | Sí — `["pix"]` |
>
> ```json theme={"dark"}
> {
>   "customerId": "customer_1234567890",
>   "bankName": "Itaú",
>   "accountName": "Alice Santos PIX",
>   "accountOwner": {
>     "accountHolderName": "Alice Santos",
>     "address": {
>       "line1": "Rua Augusta 100",
>       "city": "Sao Paulo",
>       "state": "SP",
>       "postalCode": "01304-001",
>       "country": "BRA"
>     }
>   },
>   "currency": "brl",
>   "accountDetails": {
>     "pixKey": "alice@example.com",
>     "pixKeyType": "email"
>   },
>   "networks": ["pix"]
> }
> ```
>
> > [!NOTE]
> >
> > Las transferencias BRL requieren un perfil de verificación separado (`kyc_profile_b` para individuos, `kyb_profile_b` para empresas). Contacta a tu representante de SpherePay para habilitar el acceso BRL/PIX. Consulta [Restricciones de transferencias BRL/PIX](https://docs.spherepay.co/es/concepts/transfers/overview.md#brlpix-transfer-constraints) para la lista completa de reglas.

## Usar el ID devuelto

El `id` devuelto en la respuesta es tu referencia persistente a esta cuenta bancaria. Guárdalo contra el registro del cliente y pásalo como `source.id` o `destination.id` al crear transferencias.

```json theme={"dark"}
{
  "id": "bank_account_abc123",
  "customerId": "customer_1234567890",
  "currency": "usd",
  "networks": ["ach", "wire"],
  ...
}
```


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