Skip to main content
GET
List supported beneficiary banks
Returns the bank codes accepted for an enabled external-bank Payment country. Use the selected code unchanged as destination.bankCode; numeric directory record IDs are never payment identifiers. Stableyard verifies the beneficiary account before collecting funds. Some bank directories are production-only, and routes stay disabled until they are certified for the environment. A bank lookup may create a pending external transaction, so an uncertain result fails closed and is not retried automatically. See Off-ramps.

Authorizations

Authorization
string
header
required

HTTP Basic auth. Username is the Stableyard app ID. Password is the app secret. The optional Stableyard-Version request header must match the environment pin.

Headers

Stableyard-Version
enum<string>

Optional contract-version assertion. Omit it to use the app environment's pinned version. A different supported version is accepted only after that environment is explicitly migrated.

Available options:
2026-09-09

Query Parameters

country
string
required
Required string length: 2
Pattern: ^[A-Za-z]{2}$
Example:

"VN"

Response

Supported banks

country
string
required
Pattern: ^[A-Z]{2}$
Example:

"VN"

currency
string
required
Pattern: ^[A-Z]{3}$
Example:

"VND"

banks
object[]
required