Whitelist a Fiat Bank Account

Register a bank account you control as a fiat payout destination. See Overview for why registration is the security-sensitive step.

Register

curl -X POST "https://mapi.boomfi.xyz/v1/accounts/external-account" \
  -H "X-API-KEY: sk_test_xxx" \
  -H "X-Step-Up-Token: <step-up-token>" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "Fiat",
    "reference": "treasury-eur",
    "name": "Treasury (EUR)",
    "currencies": ["EUR"],
    "account_number": "DE89370400440532013000",
    "bank_name": "Example Bank",
    "account_holder_name": "Example Trading Ltd",
    "country": "DE",
    "beneficiary_type": "business",
    "payment_rail": "SEPA"
  }'

curl -X POST "https://mapi.boomfi.xyz/v1/accounts/external-account" \
  -H "X-API-KEY: sk_test_xxx" \
  -H "X-Step-Up-Token: <step-up-token>" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "Fiat",
    "reference": "founder-payout-eur",
    "name": "Founder payout (EUR)",
    "currencies": ["EUR"],
    "account_number": "DE89370400440532013000",
    "bank_name": "Example Bank",
    "account_holder_name": "Jane Doe",
    "country": "DE",
    "beneficiary_type": "individual",
    "first_name": "Jane",
    "last_name": "Doe",
    "payment_rail": "SEPA"
  }'

X-Step-Up-Token is required when you authenticate with a Bearer session; it is ignored for API-key auth. The account is enabled immediately — registering it is the approval.

Field	Type	Required	Description
`type`	string	yes	`Fiat`
`reference`	string	yes	Your own reference for this account. Used to address it on a payout
`name`	string	yes	Display name
`currencies`	array	yes	Exactly one settlement currency
`account_number`	string	yes	Bank account number or IBAN. Encrypted at rest; responses return a masked hint
`account_holder_name`	string	yes	Legal account holder. Encrypted at rest; responses return a masked hint
`country`	string	yes	Bank country, ISO 3166-1 alpha-2
`bank_name`	string	no	Name of the beneficiary bank
`beneficiary_type`	string	no	`individual` or `business` (defaults to `business`)
`first_name`, `last_name`	string	required if `individual`	Beneficiary name
`business_name`	string	no	Defaults to `account_holder_name` for a business beneficiary
`payment_rail`	string	no	`SEPA` or `SEPA_INSTANT` (defaults to `SEPA`)

A second registration with the same reference returns 409.

List

curl "https://mapi.boomfi.xyz/v1/accounts/external-account?type=Fiat" \
  -H "X-API-KEY: sk_test_xxx"

Response fields for a fiat account: id, reference, name, currencies, account_number_hint, account_holder_name_hint, bank_name, country, beneficiary_type, payment_rail, enabled, created_at. The account number and holder name are never returned in full.

Remove

curl -X DELETE "https://mapi.boomfi.xyz/v1/accounts/external-account/123" \
  -H "X-API-KEY: sk_test_xxx" \
  -H "X-Step-Up-Token: <step-up-token>"

Payouts already in flight are unaffected; new payouts can no longer name this account.

Next steps

Once registered and enabled, pay out to this account by its id or reference.

Get Started

Dashboard

Settlement

Payments

Deposit Accounts

External Account

Webhooks

Payouts

Integrations

Pricing and Policies

Whitelist a Fiat Bank Account

Register

List

Remove

Next steps

​Register

​List

​Remove

​Next steps

Register

List

Remove

Next steps