> ## 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.

# Account-Specific Paylinks

> Bind paylinks to settlement accounts with account_ids or account_ref.

Account-specific paylinks let platforms that run **many settlement accounts** (multi-merchant, multi-chain, multi-currency) attach which accounts may receive settlement for a given pay link.

## Who this is for

* Platforms routing payments to the correct merchant account
* Operators who need explicit control over settlement targets
* Businesses accepting payments across many chains and currencies with separate settlement wallets

## Attach accounts when creating a paylink

See settlement account creation in [Settlement Accounts](/settlement/settlement-accounts) before binding them on a paylink.

### `account_ids`

Pass an array of internal account ids:

```bash theme={null}
curl --request POST \
  --url "https://mapi.zbx.boomfi.xyz/v1/paylinks" \
  --header "accept: application/json" \
  --header "content-type: application/json" \
  --header "X-API-KEY: sk_test_xxx" \
  --data '{
    "name": "Multi-account link",
    "amount": "100",
    "currency": "USD",
    "account_ids": [1, 2, 3]
  }'
```

### `account_ref`

Pass a shared merchant-defined **account reference** that groups accounts:

```bash theme={null}
curl --request POST \
  --url "https://mapi.zbx.boomfi.xyz/v1/paylinks" \
  --header "accept: application/json" \
  --header "content-type: application/json" \
  --header "X-API-KEY: sk_test_xxx" \
  --data '{
    "name": "Ref-scoped link",
    "amount": "100",
    "currency": "USD",
    "account_ref": "my_acc_reference"
  }'
```

<Note>
  Some internal payloads may store the reference as `account_reference`. Prefer the create-paylink field names in the OpenAPI reference.
</Note>

## Operational notes

* You own routing correctness: wrong ids/refs send settlement to the wrong wallets.
* More flexibility means more careful account lifecycle management.

## Related

* [Payment Links](/payments/paylinks)
* [Paylink Features](/payments/paylink-features)
* [Settlement Overview](/settlement/overview)