List Banks
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_code
Allowed values:
Response
OK
Errors
400
Bad Request Error

