Skip to main content
POST
/
api
/
master-entities
/
{master_entity_id}
/
banking-info
Registrar cuenta bancaria
curl --request POST \
  --url https://api.tupana.ai/api/master-entities/{master_entity_id}/banking-info/ \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "bank_code": "BANCO_BCI",
  "account_type": "corriente",
  "account_number": "1234567890",
  "holder_rut": "12345678-9",
  "holder_name": "María Pérez"
}
'
{
  "id": 456,
  "bank_code": "BANCO_BCI",
  "account_type": "corriente",
  "account_number": "1234567890",
  "holder_rut": "12345678-9",
  "holder_name": "María Pérez",
  "status": "pending_verification",
  "updated_at": "2026-04-06T12:00:00Z"
}

​
¿Para qué se usa?

Registra la cuenta bancaria a la que Tu Pana depositará los fondos una vez confirmado el pago. Es un prerequisito para poder crear sesiones de cobro para ese destinatario.

​
Qué hace

  • Registra una cuenta bancaria para el destinatario identificado por master_entity_id.
  • La cuenta queda en estado pending_verification mientras Tu Pana la valida.
  • Una vez en verified, el destinatario está listo para recibir depósitos.

​
Consideraciones importantes

​
Verificación de la cuenta

La verificación es automática pero puede tardar algunos minutos. Podés consultar el estado con GET /api/master-entities/{id}/banking-info/.

​
Un registro por destinatario

Cada destinatario tiene una cuenta bancaria activa. Si querés cambiar los datos, usá PATCH /api/master-entities/{id}/banking-info/{banking_info_id}/.

Authorizations

​
Authorization
string
header
required

API Key para autenticación. Formato: Api-Key YOUR-API-KEY

Path Parameters

​
master_entity_id
string
required

ID del destinatario (MasterEntity).

Body

application/json
​
bank_code
string
required

Código del banco. Ej: BANCO_BCI, BANCO_SANTANDER, BANCO_ESTADO.

Example:

"BANCO_BCI"

​
account_type
enum<string>
required

Tipo de cuenta bancaria.

Available options:
corriente,
ahorro,
vista
Example:

"corriente"

​
account_number
string
required

Número de cuenta, sin guiones ni espacios.

Example:

"1234567890"

​
holder_rut
string
required

RUT del titular de la cuenta.

Example:

"12345678-9"

​
holder_name
string
required

Nombre del titular de la cuenta.

Example:

"María Pérez"

Response

Cuenta bancaria registrada

​
id
integer
Example:

456

​
bank_code
string
Example:

"BANCO_BCI"

​
account_type
string
Example:

"corriente"

​
account_number
string
Example:

"1234567890"

​
holder_rut
string
Example:

"12345678-9"

​
holder_name
string
Example:

"María Pérez"

​
status
enum<string>

pending_verification: Tu Pana está verificando la cuenta. verified: el destinatario puede recibir depósitos.

Available options:
pending_verification,
verified
Example:

"verified"

​
updated_at
string<date-time>
Example:

"2026-04-06T12:00:00Z"