API bancario (BaaS)

baas_list_assignments

Lista los contextos tenant/cuenta (assignments) disponibles para las credenciales del API bancario 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.

baas_diagnostics

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

Parámetros

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.

baas_list_accounts

Lista las cuentas accesibles del API bancario, 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

Devuelve

{ result }

result = respuesta del API bancario tal cual.

baas_list_balances

Lista los saldos en tiempo real de las cuentas accesibles: cuenta, montos y fecha de corte.

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

Parámetros

Devuelve

{ result }

result = respuesta del API bancario tal cual.

baas_get_balance

Obtiene el saldo actual de una cuenta del API bancario identificada por IBAN.

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

Parámetros

Devuelve

{ result }

result = respuesta del API bancario tal cual.

baas_list_payments

Consulta, sólo lectura, los pagos de una cuenta propia identificada por IBAN, con filtros de fecha, estado, moneda, método y dirección. Paginación por cursor.

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

Parámetros

Devuelve

{ result }

result = respuesta del API bancario tal cual, con su cursor de paginación.

baas_search_payment

Busca un pago dentro de una cuenta por exactamente uno de: paymentId (UUID), publicId (número) o clientReference. Si se envía más de uno, la herramienta devuelve error.

Operación del API: POST /api/public/v1/transactions/payments/search — ver la página de la operación

Parámetros

Devuelve

{ result }

result = respuesta del API bancario tal cual.

baas_get_payment

Obtiene el detalle de un pago del API bancario por su UUID interno, sólo lectura.

Operación del API: GET /api/public/v1/transactions/payments/{payment_id} — ver la página de la operación

Parámetros

Devuelve

{ result }

result = respuesta del API bancario tal cual.

baas_request_statement

Solicita la generación de un estado de cuenta para una cuenta del API bancario, con rango máximo de 60 días. No mueve dinero: genera un documento de consulta y devuelve request_id con status PENDING.

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

Parámetros

Devuelve

{ result }

result = respuesta del API bancario con request_id y status. La herramienta solicita el documento sin notificación por correo.

baas_get_statement_status

Consulta el estado de una solicitud de estado de cuenta. 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

Devuelve

{ result }

result = respuesta del API bancario tal cual.

baas_analyze_payments

Analiza, sólo lectura, los pagos de una cuenta en un rango de fechas y devuelve un informe en lenguaje natural: éxito, fallas, reversiones, montos netos y recomendaciones. Usa un modelo de lenguaje sobre las cifras calculadas.

Parámetros

Devuelve

{ summary }

summary trae account, range, totals {count, succeeded, failed, reversed, pending, successRate}, byCurrency con succeededAmount, reversedAmount, netAmount y averageTicket, failureReasons y sample. El informe redactado viene en el texto. Si no hay pagos en el rango, avisa y no analiza.