Otras operaciones

Sólo lectura

Estas herramientas se activan bajo solicitud y sólo funcionan para usuarios con credenciales del API bancario de Tilopay. No forman parte del acceso MCP por defecto: Tilopay habilita el grupo caso por caso. Requiere: Credenciales del API bancario de Tilopay registradas por Tilopay para ese usuario.

Contextos (assignments) del API BaaS

Sólo lectura

baas_list_assignments

Lista los contextos tenant/cuenta (assignments) disponibles para las credenciales BaaS del usuario. Úsalo cuando otra herramienta pida assignmentId.

Parámetros

Sin parámetros.

Devuelve

{ assignments[] }

assignments = contextos disponibles con assignment_id, tenant_code, owner_type, country_code y status.

Diagnóstico del API BaaS

Sólo lectura

baas_diagnostics

Verifica las credenciales BaaS del usuario, el login, el intercambio de token y el acceso a cuentas. Úsalo cuando una consulta BaaS falle.

Parámetros

Parámetro	Tipo	Obligatorio	Descripción
`assignmentId`	string	—	Contexto a probar (opcional)

Devuelve

{ checks[], failed }

checks = una fila por verificación (credenciales, login + assignments, cuentas) con ok y detalle; failed = cuántas fallaron. El correo de la credencial se devuelve enmascarado.

Listar cuentas BaaS

Sólo lectura

baas_list_accounts

Lista las cuentas accesibles del API BaaS (sin saldos): tipo de identificador, valor y moneda.

Operación del API: GET /api/public/v1/accounts — ver la página de la operación

Parámetros

Parámetro	Tipo	Obligatorio	Descripción
`accountType`	string	—	Filtro por esquema (IBAN)
`accountValue`	string	—	Filtro por identificador
`limit`	integer	—	—
`offset`	integer	—	Desplazamiento de paginación
`assignmentId`	string	—	Contexto BaaS (opcional)

Devuelve

{ result }

result = respuesta del API bancario tal cual.

Saldo de una cuenta BaaS

Sólo lectura

baas_get_balance

Obtiene el saldo actual de una cuenta BaaS identificada por IBAN.

Operación del API: GET /api/public/v1/accounts/balance — ver la página de la operación

Parámetros

Parámetro	Tipo	Obligatorio	Descripción
`currency`	string	—	Moneda de la cuenta (CRC o USD)
`accountIndex`	integer	—	Número de la cuenta en la lista
`accountValue`	string	—	Solo si una herramienta ya lo devolvió. No escribe números de cuenta de memoria: indica la moneda (CRC/USD) o el número de la cuenta en la lista; el sistema resuelve el IBAN real.
`assignmentId`	string	—	Contexto BaaS (opcional)

Devuelve

{ result }

result = respuesta del API bancario tal cual.

Estado de la solicitud de estado de cuenta

Sólo lectura

baas_get_statement_status

Consulta el estado de una solicitud de estado de cuenta BaaS. Cuando está DONE incluye el enlace de descarga firmado y su vencimiento.

Operación del API: GET /api/public/v1/accounts/statements/{request_id} — ver la página de la operación

Parámetros

Parámetro	Tipo	Obligatorio	Descripción
`requestId`	string	sí	request_id devuelto al solicitarlo
`assignmentId`	string	—	Contexto BaaS (opcional)

Devuelve

{ result }

result = respuesta del API bancario tal cual.

Número de cuenta completo del comercio

Sólo lectura

baas_get_account_number

Muestra el IBAN COMPLETO de una cuenta propia del comercio. Úsala SOLO cuando el comercio pide explícitamente tu número de cuenta (por ejemplo para dárselo a un cliente o proveedor) y con confirm=true. Queda registrada en la auditoría. En cualquier otra respuesta se usa el número enmascarado.

Parámetros

Parámetro	Tipo	Obligatorio	Descripción
`confirm`	boolean	sí	true solo si el comercio pidió explícitamente tu número de cuenta completo
`currency`	string	—	Moneda de la cuenta (CRC o USD)
`accountIndex`	integer	—	Número de la cuenta en la lista
`assignmentId`	string	—	Contexto BaaS (opcional)

Devuelve

Autorizar la transferencia pendiente

Sensible

baas_confirm_transfer

Autoriza la transferencia pendiente con el código de 6 dígitos que llegó AL CORREO DEL COMERCIO y fue respondido en el chat. Nunca escribas ni repitas el código en la respuesta.

Parámetros

Parámetro	Tipo	Obligatorio	Descripción
`code`	string	sí	Código de 6 dígitos que respondió el comercio
`intentId`	string	—	Identificador de la intención (si se omite, se usa la pendiente)

Devuelve

Cancelar la transferencia pendiente

Escritura

baas_cancel_transfer

Cancela la transferencia que está esperando el código de autorización. Úsala cuando el comercio diga que no la quiere hacer.

Parámetros

Parámetro	Tipo	Obligatorio	Descripción
`intentId`	string	—	Identificador de la intención (opcional)

Devuelve

Aprobar o rechazar una operación pendiente

Sensible

banca_decide_approval

Aprueba o rechaza una transferencia que quedó en doble control, con el código de 6 dígitos que llegó AL CORREO DEL APROBADOR. Nunca escribas el código en la respuesta.

Parámetros

Parámetro	Tipo	Obligatorio	Descripción
`decision`	string (aprobar \| rechazar)	sí	Decisión del aprobador
`code`	string	sí	Código de 6 dígitos del correo del aprobador
`approvalId`	string	—	Identificador de la aprobación (si se omite, se usa la pendiente)
`reason`	string	—	Motivo del rechazo (opcional)

Devuelve

Cerrar sesión bancaria

Escritura

baas_close_session

Cierra de inmediato la sesión bancaria activa del asistente de WhatsApp.

Parámetros

Sin parámetros.

Devuelve

Última verificación: 2026-10-07 · Responsable: equipo-integraciones

Ver como Markdown crudo