Registrar cuenta bancaria

curl --request POST \
  --url https://api.tupana.ai/v1/master-entities/{master_entity_id}/banking-info/ \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "sbif_code": "037",
  "account_type": "checking",
  "account_number": "1234567890",
  "include_in_emails": true
}
'

{
  "id": 456,
  "bank": 7,
  "bank_detail": {
    "id": 7,
    "name": "BANCO SANTANDER-CHILE",
    "sbif_code": "037",
    "additional_brands": "Banefe",
    "is_active": true
  },
  "account_type": "checking",
  "account_type_display": "Cuenta Corriente",
  "account_number": "1234567890",
  "include_in_emails": true,
  "created_at": "2026-04-06T12:00:00Z",
  "updated_at": "2026-04-06T12:00:00Z"
}

POST

master-entities

{master_entity_id}

banking-info

Registrar cuenta bancaria

curl --request POST \
  --url https://api.tupana.ai/v1/master-entities/{master_entity_id}/banking-info/ \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "sbif_code": "037",
  "account_type": "checking",
  "account_number": "1234567890",
  "include_in_emails": true
}
'

{
  "id": 456,
  "bank": 7,
  "bank_detail": {
    "id": 7,
    "name": "BANCO SANTANDER-CHILE",
    "sbif_code": "037",
    "additional_brands": "Banefe",
    "is_active": true
  },
  "account_type": "checking",
  "account_type_display": "Cuenta Corriente",
  "account_number": "1234567890",
  "include_in_emails": true,
  "created_at": "2026-04-06T12:00:00Z",
  "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: si el destinatario no tiene cuenta bancaria registrada, la creación del cobro retornará el error RECIPIENT_MISSING_BANKING_INFO.

Qué hace

Registra una cuenta bancaria para el destinatario identificado por master_entity_id.
Cada destinatario tiene una sola cuenta bancaria activa. Para cambiar los datos, usá PUT /v1/master-entities/{master_entity_id}/banking-info/.
El titular de la cuenta es el propio destinatario (la master_entity con master_entity_id).

Cómo identificar el banco

El parámetro del banco se puede enviar de dos formas:

sbif_code (recomendado): código SBIF de tres dígitos (ej "037"). Es el identificador estable y estándar de la Superintendencia de Bancos chilena.
bank: ID interno del banco en Tu Pana. El ID puede variar entre ambientes, así que preferí sbif_code.

Enviá uno de los dos. Si enviás ambos, deben referirse al mismo banco.

Códigos SBIF disponibles

`sbif_code`	Banco
`001`	Banco de Chile
`009`	Banco Internacional
`014`	Scotiabank Chile
`016`	Banco de Crédito e Inversiones (BCI)
`028`	Banco BICE
`031`	HSBC Bank (Chile)
`037`	Banco Santander-Chile
`039`	Banco Itaú Chile
`049`	Banco Security
`051`	Banco Falabella
`053`	Banco Ripley
`055`	Banco Consorcio
`059`	Banco BTG Pactual Chile
`062`	Tanner Banco Digital
`730`	Tenpo
`875`	MercadoPago

Tipos de cuenta

`account_type`	Tipo
`checking`	Cuenta Corriente
`savings`	Cuenta de Ahorros
`current`	Cuenta Vista

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

Para identificar el banco, envía uno de los dos campos: sbif_code (recomendado para integraciones) o bank (ID en la base de datos de Tu Pana). El titular de la cuenta es el mismo destinatario (master_entity).

account_type

enum<string>

required

Tipo de cuenta: checking (cuenta corriente), savings (cuenta de ahorros), current (cuenta vista).

Available options:

checking,

savings,

current

Example:

"checking"

account_number

string

required

Número de cuenta, sin guiones ni espacios.

Example:

"1234567890"

sbif_code

enum<string>

Código SBIF del banco (3 dígitos). Identificador estable y recomendado para integraciones externas.

Código	Banco
`001`	Banco de Chile
`009`	Banco Internacional
`014`	Scotiabank Chile
`016`	Banco de Crédito e Inversiones (BCI)
`028`	Banco BICE
`031`	HSBC Bank (Chile)
`037`	Banco Santander-Chile
`039`	Banco Itaú Chile
`049`	Banco Security
`051`	Banco Falabella
`053`	Banco Ripley
`055`	Banco Consorcio
`059`	Banco BTG Pactual Chile
`062`	Tanner Banco Digital

Available options:

001,

009,

014,

016,

028,

031,

037,

039,

049,

051,

053,

055,

059,

062

Example:

"037"

bank

integer

ID en BD del banco. Obtenible vía GET /api/banks/. Si envías sbif_code no es necesario.

Example:

7

include_in_emails

boolean

default:true

Si true (default), Tu Pana incluye los datos de la cuenta en los correos de cobranza al destinatario.

Response

Cuenta bancaria registrada

integer

Example:

456

bank

integer

ID en BD del banco.

Example:

7

bank_detail

object

Información expandida del banco.

Show child attributes

account_type

enum<string>

Available options:

checking,

savings,

current

Example:

"checking"

account_type_display

string

Etiqueta legible en español del tipo de cuenta.

Example:

"Cuenta Corriente"

account_number

string

Example:

"1234567890"

include_in_emails

boolean

Example:

true

created_at

string<date-time>

Example:

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

updated_at

string<date-time>

Example:

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

Consultar cuenta bancaria Actualizar cuenta bancaria

​¿Para qué se usa?

​Qué hace

​Cómo identificar el banco

​Códigos SBIF disponibles

​Tipos de cuenta

Authorizations

Path Parameters

Body

Response

¿Para qué se usa?

Qué hace

Cómo identificar el banco

Códigos SBIF disponibles

Tipos de cuenta