Settlement Accounts - ZBX

Settlement accounts define where payment proceeds can settle. You can manage them in the dashboard under Settings → Payments / settlement, or with the Accounts API. Base path: https://mapi.zbx.boomfi.xyz/v1/accounts

List settlement accounts

curl "https://mapi.zbx.boomfi.xyz/v1/accounts" \
  -H "X-API-KEY: sk_test_xxx" \
  -H "Accept: application/json"

Filter by exact reference:

curl "https://mapi.zbx.boomfi.xyz/v1/accounts?reference=my_personal_accounts" \
  -H "X-API-KEY: sk_test_xxx" \
  -H "Accept: application/json"

Create a settlement account

curl -X POST "https://mapi.zbx.boomfi.xyz/v1/accounts" \
  -H "X-API-KEY: sk_test_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "CryptoPayIn",
    "name": "primary_settlement",
    "reference": "my_personal_accounts",
    "chain_id": 8453,
    "address": "0x4649f19a2c42C8C88b668a9198fBad51103D8E33",
    "currencies": ["ETH", "USDC"]
  }'

Use a controlled address you own. chain_id values are documented under Networks and Currencies.

Get, update, delete

GET https://mapi.zbx.boomfi.xyz/v1/accounts/{id}
PATCH https://mapi.zbx.boomfi.xyz/v1/accounts/{id}
DELETE https://mapi.zbx.boomfi.xyz/v1/accounts/{id}

Replace {id} with the numeric account id from create/list responses.

Paylinks attachment

When you create a Payment Links, pass account_ids or account_ref so checkout uses the correct settlement targets.

Next steps