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

​
¿Para qué se usa?

Consulta la cuenta bancaria registrada para un destinatario. Útil para verificar el estado de verificación antes de crear cobros.

​
Qué hace

  • Retorna la cuenta bancaria activa del destinatario.
  • El campo status indica si la cuenta está lista para recibir depósitos.

​
Estados de cuenta

EstadoDescripción
pending_verificationTu Pana está verificando la cuenta. El destinatario aún no puede recibir depósitos.
verifiedLa cuenta está verificada. El destinatario puede recibir depósitos.

​
Consideraciones importantes

​
Requisito previo para crear cobros

Para crear una sesión de cobro, el destinatario debe tener una cuenta bancaria en estado verified. Si no la tiene, la creación del cobro retornará el error RECIPIENT_NOT_VERIFIED.

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