Other BaaS operations

Read only

These tools are enabled on request and only work for users with Tilopay banking API credentials. They are not part of the default MCP access: Tilopay enables the group case by case. Requires: Credenciales del API bancario de Tilopay registradas por Tilopay para ese usuario.

Banking API contexts (assignments)

Read only

baas_list_assignments

Lists the tenant/account contexts (assignments) available for the user's banking API credentials. Use it when another tool asks for assignmentId.

Parameters

No parameters.

Returns

{ assignments[] }

assignments = available contexts with assignment_id, tenant_code, owner_type, country_code and status.

Banking API diagnostics

Read only

baas_diagnostics

Checks the user's banking API credentials, the login, the token exchange and access to accounts. Use it when a query fails.

Parameters

Parameter	Type	Required	Description
`assignmentId`	string	—	Banking API context (assignment); only needed when there are several

Returns

{ checks[], failed }

checks = one row per check (credentials, login + assignments, accounts) with ok and detail; failed = how many failed. The credential email comes back masked.

List banking API accounts

Read only

baas_list_accounts

Lists the accessible banking API accounts, without balances: identifier type, value and currency.

API operation: GET /api/public/v1/accounts — see the operation page

Parameters

Parameter	Type	Required	Description
`accountType`	string	—	Filter by scheme (IBAN)
`accountValue`	string	—	Filter by identifier
`limit`	integer	—	Page size, between 1 and 100
`offset`	integer	—	Desplazamiento de paginación
`assignmentId`	string	—	Banking API context (assignment); only needed when there are several

Returns

{ result }

result = the banking API response as returned.

Balance of one account

Read only

baas_get_balance

Gets the current balance of a banking API account identified by IBAN.

API operation: GET /api/public/v1/accounts/balance — see the operation page

Parameters

Parameter	Type	Required	Description
`currency`	string	—	Moneda de la cuenta (CRC o USD)
`accountIndex`	integer	—	Número de la cuenta en la lista
`accountValue`	string	—	Account identifier (IBAN)
`assignmentId`	string	—	Banking API context (assignment); only needed when there are several

Returns

{ result }

result = the banking API response as returned.

Statement request status

Read only

baas_get_statement_status

Reads the status of an account statement request. When it is DONE it includes the signed download link and its expiry.

API operation: GET /api/public/v1/accounts/statements/{request_id} — see the operation page

Parameters

Parameter	Type	Required	Description
`requestId`	string	yes	request_id returned when the statement was requested
`assignmentId`	string	—	Banking API context (assignment); only needed when there are several

Returns

{ result }

result = the banking API response as returned.

Merchant's full account number

Read only

baas_get_account_number

Shows the FULL IBAN of one of the merchant's own accounts. Use it ONLY when the merchant explicitly asks for their account number (for example to give it to a customer or supplier) and with confirm=true. It is recorded in the audit log. In any other answer the masked number is used.

Parameters

Parameter	Type	Required	Description
`confirm`	boolean	yes	true solo si el comercio pidió explícitamente tu número de cuenta completo
`currency`	string	—	Moneda de la cuenta (CRC o USD)
`accountIndex`	integer	—	Número de la cuenta en la lista
`assignmentId`	string	—	Contexto BaaS (opcional)

Returns

Authorize the pending transfer

Sensitive

baas_confirm_transfer

Authorizes the pending transfer with the 6-digit code that arrived AT THE MERCHANT'S EMAIL and was answered in the chat. Never write or repeat the code in the answer.

Parameters

Parameter	Type	Required	Description
`code`	string	yes	Código de 6 dígitos que respondió el comercio
`intentId`	string	—	Identificador de la intención (si se omite, se usa la pendiente)

Returns

Cancel the pending transfer

Write

baas_cancel_transfer

Cancels the transfer that is waiting for the authorization code. Use it when the merchant says they do not want to make it.

Parameters

Parameter	Type	Required	Description
`intentId`	string	—	Identificador de la intención (opcional)

Returns

Approve or reject a pending operation

Sensitive

banca_decide_approval

Approves or rejects a transfer held under dual control, with the 6-digit code that arrived AT THE APPROVER'S EMAIL. Never write the code in the answer.

Parameters

Parameter	Type	Required	Description
`decision`	string (aprobar \| rechazar)	yes	Decisión del aprobador
`code`	string	yes	Código de 6 dígitos del correo del aprobador
`approvalId`	string	—	Identificador de la aprobación (si se omite, se usa la pendiente)
`reason`	string	—	Motivo del rechazo (opcional)

Returns

Close banking session

Write

baas_close_session

Immediately closes the WhatsApp assistant's active banking session.

Parameters

No parameters.

Returns

Last verified: 2026-10-07 · Owner: equipo-integraciones

View as raw Markdown