Crear una cuenta bancaria | Documentación API de Recurrente

Registra una cuenta bancaria externa como destino de retiro. Usa GET /banks para los valores válidos de bank_name. Las cuentas son inmutables salvo is_preferred — archiva y crea una nueva para cambiar otros datos.

Authentication

X-SECRET-KEYstring

Tu clave secreta de API

Request

This endpoint expects an object.

holder_namestringRequired

numberstringRequired

bank_namestringRequired

currencyenumRequired

Allowed values:

account_typeenumRequired

Allowed values:

is_preferredbooleanOptional

Response

Cuenta bancaria creada

idstring

ID único de la cuenta bancaria

bank_namestring or null

Nombre del banco

holder_namestring

Nombre del titular

created_atdatetime

Fecha de creación

statusenum

Estado de la cuenta bancaria

currencyenum

Moneda de la cuenta bancaria

account_typeenum or null

Tipo de cuenta bancaria

is_preferredboolean

Indica si es la cuenta preferida para su moneda

ownership_typeenum

Tipo de cuenta bancaria

Errors

400

Bad Request Error

$	curl -X POST https://app.recurrente.com/api/bank_accounts \
>	-H "X-SECRET-KEY: <apiKey>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"holder_name": "Acme, S.A.",
>	"number": "1234567890",
>	"bank_name": "Banco Industrial",
>	"currency": "GTQ",
>	"account_type": "checking"
>	}'

1	{
2	"id": "ba_lmgbvesmihkqzma3",
3	"bank_name": "Banco Industrial",
4	"holder_name": "Acme Restaurant, S.A.",
5	"created_at": "2024-01-15T09:30:00Z",
6	"status": "active",
7	"currency": "GTQ",
8	"account_type": "checking",
9	"is_preferred": true,
10	"ownership_type": "external"
11	}