List Banks

View as Markdown
Lists beneficiary banks or financial institutions by country code. **Authentication:** - **REQUIRED**: Provide client_id and client_secret via: - Basic Auth: `Authorization: Basic base64(client_id:client_secret)` **Query Parameters:** - `country_code` (required): Country code (ID, PH, or VN) **Response:** - `banks`: Array of bank/financial institution objects with unified `code` field - `country_code`: The country code requested - `total`: Total number of banks returned **Bank Code Standardization:** All banks in the response use a unified `code` field. Provider-specific differences are normalized to the `code` field for consistency. **Supported Countries:** - ID (Indonesia) - PH (Philippines) - VN (Vietnam) **Note:** listBanks applies only to ID, PH, and VN. LATAM, Thailand, Cambodia, Africa, and other corridors do not use this endpoint — routing is resolved from the QR or country_code at decode time.

Authentication

AuthorizationBasic

Basic Auth: base64(client_id:client_secret)

Query parameters

country_codeenumRequired
Allowed values:

Response

OK

Errors

400
Bad Request Error