Payments Settings - ZBX

Open Settings → Payments / Settlement to configure how crypto payments settle and how far underpaid invoices can still complete. https://merchants.zbx.boomfi.xyz/dashboard/settings/settlement

ZBX settlement settings

Crypto settlements

For each supported blockchain you enable:

Toggle the network on
Set the settlement address for that chain
Select the currencies you accept on that chain
Save

See also Settlement Accounts and Networks and Currencies.

ZBX crypto settlement settings

Underpayments

Underpayment settings define how much shortfall you accept at checkout when a customer pays less than the invoice amount.

Setting	Meaning
Acceptable underpayment percentage	Relative tolerance (for example 1% of a $100 invoice → accept$ 99+)
Maximum allowable underpayment amount	Hard USD (or stable-unit) cap on the shortfall

Combining percentage and amount

If both are set, the percentage tolerance applies, and the fixed amount acts as a hard cap. Example with 1% and $5:

$100 invoice → accept about$ 99 and above
$1,000 invoice →$ 995 and above (1% = $10, but the$ 5 cap wins)

ZBX underpayment settings

Field names (API / config)

interface UnderpayThresholds {
  underpay_tolerance_percent?: number; // acceptable underpayment percentage
  underpay_tolerance_usd?: number; // maximum allowable underpayment amount
}