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

Related

• Payment Links
• Paylink Features
• Settlement Overview