Herramientas bancarias

Escritura

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. La única que envía dinero es baas_send_transfer, y no se ejecuta sola: el portal Banca Cliente envía un código de autorización al correo del comercio, y la transferencia sólo sale cuando el comercio responde ese código y se confirma con baas_confirm_transfer. 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.

Las cuentas se identifican con accountType: "IBAN" más accountValue, las fechas son RFC 3339 (2026-01-01T00:00:00Z) y assignmentId se envía únicamente cuando el usuario tiene varios contextos.

Herramientas#

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_confirm_transferbaas_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, autorización y 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 de un estado de cuenta (rango máximo 60 días) para una cuenta BaaS. No mueve dinero: solo genera un documento de consulta. Devuelve request_id y status PENDING.
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
Envía una transferencia desde la cuenta bancaria del comercio. Método por defecto: SINPE Móvil (destino por teléfono). Para transferencia a cuenta usa accountType=IBAN. El portal Banca Cliente envía el código de autorización al correo del comercio y aplica sus límites; el comercio responde el código y se confirma con baas_confirm_transfer.
Estado de transferencia BaaSSólo lectura
baas_get_transfer_status
El resultado de una transferencia no se consulta: el banco lo avisa por aquí en cuanto lo tiene (evento del portal).

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

Ver como Markdown crudo