# Find a payment

> Finds a payment inside an account by exactly one of: paymentId (UUID), publicId (number) or clientReference. Sending more than one returns an error.

- kind: mcp-tool
- status: stable
- access: read
- last_verified: 2026-10-07
- url: https://tilopay.com/en/developers/agentes/mcp/api-bancario/search-payment

> 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: Tilopay banking API credentials registered by Tilopay for that user.

- `baas_search_payment`
- Access: Read only
- API operation: `POST /api/public/v1/transactions/payments/search` — https://tilopay.com/en/developers/api-bancario/pagos

Searches for a BaaS payment within an account by exactly one of: paymentId (UUID), publicId (number) or clientReference. Identifiers only from data a tool already returned.

**Parameters**

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `currency` | string | — | Currency of the account to query (CRC or USD). Recommended form. |
| `accountIndex` | integer | — | Account number in the user's account list |
| `accountValue` | string | — | Only if already returned by a tool and matching one of your accounts. Account precedence: accountValue → currency (first matching account) → accountIndex (1-based) → sole account. |
| `assignmentId` | string | — | Banking API context (assignment); only needed when there are several |
| `paymentId` | string | — | Internal payment UUID |
| `publicId` | string | — | Numeric public identifier |
| `clientReference` | string | — | Merchant reference |

**Returns**

`{ result }`

result = the banking API response as returned.