Skip to main content
POST
Save a third-party bank beneficiary
See saved beneficiaries for supported markets and the payment flow.

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

Idempotency-Key
string
required
Required string length: 1 - 256
Pattern: ^[!-~]+$
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

Path Parameters

accountId
string
required

Body

application/json
label
string
required
Required string length: 1 - 100
country
enum<string>
required
Available options:
PH,
VN
currency
enum<string>
required

Must match country: PH/PHP or VN/VND.

Available options:
PHP,
VND
bankCode
string
required

Read the enabled external-bank directory for the country.

Pattern: ^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$
accountNumber
string
required
write-only
Required string length: 4 - 64
beneficiaryName
string
required

Caller assertion; the provider-verified name is authoritative on payment.

Required string length: 1 - 200

Response

Saved beneficiary

beneficiary
object
required