Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.clear-box.io/llms.txt

Use this file to discover all available pages before exploring further.

After ClearBox authorizes and settles a guest’s payment, the merchant’s share of the value needs to land somewhere. That somewhere is a settlement account, and the cadence at which value lands is the payout schedule.

​
Settlement accounts

A merchant can settle into one of three destinations:
DestinationDescription
bank_achA US bank account, settled via ACH. Standard for most US merchants.
bank_wireA bank account settled via wire. Used for higher-value or international payouts.
stablecoinA merchant-controlled stablecoin address. Used when the merchant wants to keep funds on-chain.

​
Add a bank settlement account

POST /v1/merchants/mer_7d3a/settlement-accounts

{
  "destination": "bank_ach",
  "bank_routing_number": "021000021",
  "bank_account_number": "000123456789"
}
ClearBox runs micro-deposit verification (or instant verification via the merchant’s Quiltt-linked bank) before activating the account. While verification is pending, the account status is pending_verification.

​
Add a stablecoin settlement account

POST /v1/merchants/mer_7d3a/settlement-accounts

{
  "destination": "stablecoin",
  "stablecoin_address": "0xMerchantWalletAddress",
  "stablecoin_chain": "polygon"
}
Settlement to a merchant-controlled stablecoin address is irreversible once a payout is on-chain. Verify the address with the merchant before activating.

​
Payout cadence

ClearBox supports daily, weekly, and on-demand payouts depending on your program’s configuration. The default is daily for bank destinations and per-transaction for stablecoin destinations (since on-chain settlement is already real-time).

​
What a payout includes

Each payout is the net of:
  • The gross of all settled transactions in the payout window for that merchant.
  • Minus the ClearBox orchestration margin (1.5–3% depending on volume tier).
  • Minus any chargebacks, refunds, or holds.
Reporting breaks this down per payout — see Reporting.

​
Reserves and rolling holds

For some merchant categories, your program may require a rolling reserve — a small percentage of each settlement held back to cover potential chargebacks. Reserves are configured at the merchant level and reported alongside payouts.

Next: Reporting

Reconcile transactions and payouts.