Herramientas bancarias

Incluye operaciones sensibles

Estas herramientas no vienen activadas. Se habilitan bajo solicitud y sólo funcionan para usuarios con credenciales del API bancario de Tilopay registradas por Tilopay del lado del servidor. Con el acceso MCP estándar el grupo no aparece; y si la herramienta se invoca sin esas credenciales, responde que no existen. Para pedirlo, escribinos desde contacto e indicá que necesitás el API bancario.

Qué cubre#

Diecinueve herramientas sobre el API bancario: contextos (assignments), diagnóstico de credenciales, cuentas, saldos, número de cuenta completo, pagos, estados de cuenta, un informe analítico de pagos, la validación de una cuenta destino, la transferencia con su autorización, cancelación y aviso de resultado, la aprobación en doble control y el cierre de la sesión bancaria.

Trece de las diecinueve sólo extraen información. baas_request_statement genera un documento de consulta y no mueve dinero. baas_send_transfer crea la intención de una transferencia, sin ejecutar el pago. El portal Banca Cliente envía un código de autorización al correo del comercio y baas_confirm_transfer ejecuta la transferencia con ese código. Si la operación queda en doble control, el aprobador la decide con banca_decide_approval y un código que llega a su correo. Así, no puede ejecutarse por decisión del modelo.

La cuenta propia se elige por precedencia: 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. baas_get_account_number acepta sólo currency o accountIndex. Las fechas son RFC 3339 (2026-01-01T00:00:00Z) y assignmentId se envía únicamente cuando el usuario tiene varios contextos.

Herramientas#

El flujo de autorización por correo y doble control descrito aquí corresponde al MCP y Banca Cliente. La creación directa de pagos en el API Bancario no tiene doble control: procesa el pago si el token, los permisos y los datos son válidos.

Los estados de cuenta se generan de forma asíncrona: el API responde 202 ACCEPTED con request_id y PENDING. La consulta responde 200 con PENDING, PROCESSING, DONE o ERROR; en DONE, download_url es válida por 48 horas.

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.

Otras operaciones
baas_list_assignmentsbaas_diagnosticsbaas_list_accountsbaas_get_balancebaas_get_account_numberbaas_get_statement_statusbaas_cancel_transferbanca_decide_approvalbaas_close_session
Contextos (assignments), diagnóstico de credenciales, listado de cuentas, saldo de una cuenta, número de cuenta completo, estado de una solicitud de estado de cuenta, cancelación de la transferencia pendiente, aprobación en doble control y cierre de la sesión bancaria.
Saldos de las cuentas BaaSSólo lectura
baas_list_balances
Lista los saldos en tiempo real de las cuentas accesibles del API BaaS (cuenta, montos y fecha de corte).
Listar pagos BaaSSólo lectura
baas_list_payments
Consulta (solo lectura) los movimientos/pagos de una cuenta bancaria propia. Indica la moneda (CRC/USD) o el número de cuenta de la lista: no escribe el IBAN. Filtros de fecha, estado, moneda, método y dirección, con paginación por cursor.
Buscar un pago BaaSSólo lectura
baas_search_payment
Busca un pago BaaS dentro de una cuenta por exactamente uno de: paymentId (UUID), publicId (número) o clientReference. Identificadores solo de datos que una herramienta ya devolvió.
Detalle de un pago BaaSSólo lectura
baas_get_payment
Obtiene el detalle de un pago BaaS por su UUID interno (solo lectura). Usa únicamente identificadores que otra herramienta devolvió en este mismo turno.
Solicitar estado de cuenta BaaSEscritura
baas_request_statement
Solicita la generación asíncrona de un estado de cuenta (rango máximo 60 días) para una cuenta BaaS. No mueve dinero: solo genera un documento de consulta. El API responde siempre 202 ACCEPTED con request_id y status PENDING. Consultá baas_get_statement_status para obtener la descarga; en DONE, download_url es válida por 48 horas.
Analista de pagos BaaSSólo lectura
baas_analyze_payments
Analiza (solo lectura) los pagos BaaS de una cuenta en un rango de fechas y devuelve un informe en lenguaje natural: éxito, fallas, reversiones, montos netos y recomendaciones verificables.
Validar cuenta destino BaaSSólo lectura
baas_validate_destination
Valida una cuenta destino antes de transferir: PHONE para SINPE Móvil o IBAN para transferencia a cuenta. Devuelve el nombre del titular que el banco confirma.
Enviar transferencia BaaSSensible
baas_send_transfer
Crea la intención de una transferencia desde la cuenta bancaria del comercio en el portal Banca Cliente (todavía no es el pago). El portal valida el destino y envía un código de 6 dígitos al correo del comercio; el pago se ejecuta sólo cuando se llama baas_confirm_transfer con ese código (vigencia de 30 minutos). Método por defecto: SINPE Móvil (destino por teléfono); para transferencia a cuenta, destinationAccountType=IBAN. baas_validate_destination es opcional para mostrar el titular antes; esta herramienta valida el destino por su cuenta.
Estado de transferencia BaaSSólo lectura
baas_get_transfer_status
No consulta al banco: indica que el resultado de la transferencia llega como aviso en cuanto el banco lo confirma. paymentId es opcional y no se usa.
Autorizar la transferencia pendienteSensible
baas_confirm_transfer
Ejecuta la transferencia cuya intención creó baas_send_transfer, con el código de 6 dígitos que el portal Banca Cliente envió al correo del comercio. Nunca escribas ni repitas el código en la respuesta.

Última verificación: 2026-10-22

Ver como Markdown crudo