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, usá el formulario de solicitud e indicá que necesitás el API bancario.

Qué cubre#

Catorce herramientas sobre el API bancario: contextos (assignments), diagnóstico de credenciales, cuentas, saldos, pagos, estados de cuenta, un informe analítico de pagos, la validación de una cuenta destino y el envío de una transferencia con su consulta de estado.

Once de las catorce sólo extraen información. baas_request_statement genera un documento de consulta y no mueve dinero. La única que mueve dinero es baas_send_transfer: valida antes la cuenta destino y exige un código de confirmación que llega al correo del comercio, así que 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_statement_status
Contextos (assignments), diagnóstico de credenciales, listado de cuentas, saldo de una cuenta y estado de una solicitud de estado de cuenta.
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 pagos BaaS de una cuenta propia identificada por IBAN, con filtros de fecha, estado, moneda, método y dirección. 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.
Detalle de un pago BaaSSólo lectura
baas_get_payment
Obtiene el detalle de un pago BaaS por su UUID interno (solo lectura).
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 use accountType=IBAN. Requiere código de 6 dígitos por correo. Valida límites por transferencia y acumulado diario.
Estado de transferencia BaaSSólo lectura
baas_get_transfer_status
Consulta el estado actual de una transferencia por su payment_id (solo lectura).

Última verificación: 2026-09-03 · Responsable: equipo-integraciones

Ver como Markdown crudo