Otras operaciones

Incluye operaciones sensibles
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ámetroTipoObligatorioDescripción
assignmentIdstring—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ámetroTipoObligatorioDescripción
accountTypestring—Filtro por esquema (IBAN)
accountValuestring—Filtro por identificador
limitinteger—1–100, junto con offset
offsetinteger—Desplazamiento de paginación
assignmentIdstring—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. La cuenta se elige por precedencia: accountValue (sólo si coincide con una cuenta del usuario) → currency (primera cuenta en esa moneda) → accountIndex (base 1) → cuenta única.

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

Parámetros

ParámetroTipoObligatorioDescripción
currencystring—Moneda de la cuenta (CRC o USD): primera cuenta en esa moneda. Precedencia para elegir la cuenta propia: accountValue (sólo si coincide con una cuenta del usuario) → currency (primera cuenta en esa moneda) → accountIndex (base 1: el número que muestra baas_list_accounts) → si hay una sola cuenta, esa.
accountIndexinteger—Número de la cuenta en la lista que muestra baas_list_accounts (base 1). Precedencia para elegir la cuenta propia: accountValue (sólo si coincide con una cuenta del usuario) → currency (primera cuenta en esa moneda) → accountIndex (base 1: el número que muestra baas_list_accounts) → si hay una sola cuenta, esa.
accountValuestring—Sólo si una herramienta ya lo devolvió y coincide con una cuenta del usuario; no escribir números de cuenta de memoria. Precedencia para elegir la cuenta propia: accountValue (sólo si coincide con una cuenta del usuario) → currency (primera cuenta en esa moneda) → accountIndex (base 1: el número que muestra baas_list_accounts) → si hay una sola cuenta, esa.
assignmentIdstring—Contexto BaaS (opcional)

Devuelve

{ account: { value, currency }, amounts: { available, posted }, as_of }

account = la cuenta consultada; amounts.available = saldo disponible; amounts.posted = saldo registrado; as_of = fecha de corte.

Estado de la solicitud de estado de cuenta

Sólo lectura

baas_get_statement_status

Consulta el estado de una solicitud asíncrona de estado de cuenta BaaS. El API responde 200 con status PENDING, PROCESSING, DONE o ERROR. Cuando está DONE incluye download_url, válida por 48 horas, 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ámetroTipoObligatorioDescripción
requestIdstringsírequest_id devuelto al solicitarlo
assignmentIdstring—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 su 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. Acepta sólo currency o accountIndex para elegir la cuenta.

Parámetros

ParámetroTipoObligatorioDescripción
confirmbooleansítrue solo si el comercio pidió explícitamente su número de cuenta completo
currencystring—Moneda de la cuenta (CRC o USD)
accountIndexinteger—Número de la cuenta en la lista
assignmentIdstring—Contexto BaaS (opcional)

Devuelve

{ result: { account_id, currency, iban } }

result = la cuenta propia con su IBAN completo.

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ámetroTipoObligatorioDescripción
intentIdstring—Identificador de la intención (opcional)

Devuelve

{ message }

message = confirmación de la cancelación.

Aprobar o rechazar una operación pendiente

Sensible

banca_decide_approval

El aprobador del doble control aprueba o rechaza una transferencia pendiente, con el código de 6 dígitos que llegó a su correo. Nunca escribas el código en la respuesta.

Exige confirmación: Confirmaciones que exige Tilopay

Parámetros

ParámetroTipoObligatorioDescripción
decisionstring (aprobar | rechazar)síDecisión del aprobador
codestringsíCódigo de 6 dígitos del correo del aprobador
approvalIdstring—Identificador de la aprobación (opcional; si se omite, se toma la aprobación pendiente más reciente)
reasonstring—Motivo del rechazo (máx. 255 caracteres, opcional)

Devuelve

{ status, message }

status = resultado de la decisión; message = texto de confirmación.

Cerrar sesión bancaria

Escritura

baas_close_session

Cierra de inmediato la sesión bancaria activa (solo en el Asistente de WhatsApp).

Parámetros

Sin parámetros.

Devuelve

Estado y descarga del documento#

baas_get_statement_status consulta una solicitud creada de forma asíncrona (202 ACCEPTED, request_id, PENDING). El API responde 200 con PENDING, PROCESSING, DONE o ERROR; en DONE incluye download_url, válida por 48 horas.

Última verificación: 2026-10-22

Ver como Markdown crudo