Skip to main content
PUT
/
master-entities
/
{master_entity_id}
/
banking-info
Actualizar cuenta bancaria
curl --request PUT \
  --url https://api.tupana.ai/v1/master-entities/{master_entity_id}/banking-info/ \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "account_number": "9876543210"
}
'
{
  "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?

Actualiza uno o más campos de la cuenta bancaria registrada para un destinatario. Solo se modifican los campos que incluís en el request.

Qué hace

  • Actualiza parcialmente los datos de la cuenta bancaria. Como cada destinatario tiene una sola cuenta, no hace falta enviar un id de cuenta en la URL.
  • Para cambiar el banco podés enviar sbif_code (ej "037") o bank (ID interno). Mirá la tabla de códigos SBIF en el endpoint de creación.

Consideraciones importantes

Impacto en cobros activos

Las sesiones de cobro creadas antes de actualizar la cuenta no se ven afectadas. Los nuevos depósitos van a la cuenta actualizada.

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

Todos los campos son opcionales: solo se actualizan los enviados.

sbif_code
enum<string>

Código SBIF del banco (3 dígitos).

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

"037"

bank
integer
Example:

7

account_type
enum<string>
Available options:
checking,
savings,
current
account_number
string
Example:

"9876543210"

include_in_emails
boolean

Response

Cuenta bancaria actualizada

id
integer
Example:

456

bank
integer

ID en BD del banco.

Example:

7

bank_detail
object

Información expandida del banco.

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"