Payments
List supported beneficiary banks
List the bank codes accepted for an external-bank Payment in a country.
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
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
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
Required string length:
2Pattern:
^[A-Za-z]{2}$Example:
"VN"