Register External Account
Register a payout destination the merchant controls: a wallet address (type Digital) or a bank account (type Fiat). Registering is the whitelisting step — /accounts/virtual/payout only sends to accounts created here — so this endpoint requires X-Step-Up-Token when authenticated with a Bearer session.
Authorizations
Headers
Step-up token required for Bearer/session auth (ignored for API-key auth)
Body
body
Currencies this account can receive. A Fiat account takes exactly one.
1Display name.
255"Treasury (Base)"
Merchant's own reference. Payouts can name this account by it.
255"treasury-base"
Kind of destination, mirroring our currency_type enum: Digital (a wallet) or Fiat (a bank account).
Digital, Fiat "Digital"
Name on the bank account. Fiat only, required.
Bank account number or IBAN. Fiat only, required. Encrypted at rest; only a hint is ever returned.
Destination wallet address. Digital only, required.
Name of the beneficiary bank. Fiat only.
Who owns the bank account. Fiat only; defaults to business.
individual, business Beneficiary business name. Fiat only; defaults to account_holder_name for a business.
Chain id. Digital only, required.
8453
ISO 3166-1 alpha-2 country of the bank account. Fiat only, required.
"DE"
Beneficiary first name. Fiat only, required when beneficiary_type is individual.
Beneficiary last name. Fiat only, required when beneficiary_type is individual.
Payment rail to settle on. Fiat only; defaults to SEPA.
SEPA, SEPA_INSTANT