Account-Specific Paylinks

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 before binding them on a paylink.

`account_ids`

Pass an array of internal account ids:

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:

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"
  }'

Some internal payloads may store the reference as account_reference. Prefer the create-paylink field names in the OpenAPI reference.

Operational notes

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

Get Started

Dashboard

Settlement

Payments

Deposit Accounts

Trading

Webhooks

Integrations

Pricing and Policies

Account-Specific Paylinks

Who this is for

Attach accounts when creating a paylink

`account_ids`

`account_ref`

Operational notes

​Who this is for

​Attach accounts when creating a paylink

​account_ids

​account_ref

​Operational notes

​Related

Who this is for

Attach accounts when creating a paylink

`account_ids`

`account_ref`

Operational notes

Related