Skip to main content
GET
/
master-entities
/
{master_entity_id}
/
banking-info
Consultar cuenta bancaria
curl --request GET \
  --url https://api.tupana.ai/v1/master-entities/{master_entity_id}/banking-info/ \
  --header 'Authorization: <api-key>'
{
  "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?

Consulta la cuenta bancaria registrada para un destinatario. Útil para verificar antes de crear cobros que el destinatario ya tiene cuenta bancaria.

​
Qué hace

  • Retorna la cuenta bancaria activa del destinatario y los datos del banco asociado (bank_detail).
  • Devuelve 404 si el destinatario aún no registró cuenta bancaria.

​
Consideraciones importantes

​
Requisito previo para crear cobros

Para crear una sesión de cobro, el destinatario debe tener una cuenta bancaria registrada. Si no la tiene, POST /v1/payment-requests/ retornará el error RECIPIENT_MISSING_BANKING_INFO.

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).

Response

Cuenta bancaria del destinatario

​
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"