> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zbx.boomfi.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Settlement Accounts

> List, create, and manage merchant settlement accounts via dashboard or API.

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

```bash theme={null}
curl "https://mapi.zbx.boomfi.xyz/v1/accounts" \
  -H "X-API-KEY: sk_test_xxx" \
  -H "Accept: application/json"
```

Filter by exact `reference`:

```bash theme={null}
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

```bash theme={null}
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](/pricing/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](/payments/paylinks), pass `account_ids` or `account_ref` so checkout uses the correct settlement targets.

## Next steps

* [Virtual Accounts](/settlement/virtual-accounts)
* [Payments Overview](/payments/overview)