> ## Documentation Index
> Fetch the complete documentation index at: https://docs.boomfi.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Payments Settings

> Configure crypto settlement chains and underpayment tolerance.

Open **Settings → Payments / Settlement** to configure how crypto payments settle and how far underpaid invoices can still complete.

`https://app.boomfi.xyz/dashboard/settings/settlement`

<img src="https://mintcdn.com/boom-fi/yPLvmX4qzaQfr3uG/dashboard/images/settings-settlement-boomfi.png?fit=max&auto=format&n=yPLvmX4qzaQfr3uG&q=85&s=432a42ff77aff7a9d750a04d0b0a5f63" alt="BoomFi settlement settings" width="1440" height="900" data-path="dashboard/images/settings-settlement-boomfi.png" />

## Crypto settlements

For each supported blockchain you enable:

1. Toggle the network on
2. Set the **settlement address** for that chain
3. Select the **currencies** you accept on that chain
4. Save

See also [Settlement Accounts](/settlement/settlement-accounts) and [Networks and Currencies](/pricing/networks-and-currencies).

<img src="https://mintcdn.com/boom-fi/yPLvmX4qzaQfr3uG/dashboard/images/settings-settlement-crypto-boomfi.png?fit=max&auto=format&n=yPLvmX4qzaQfr3uG&q=85&s=0736fe6c4cbb9083ea937669a816b77e" alt="BoomFi crypto settlement settings" width="1440" height="900" data-path="dashboard/images/settings-settlement-crypto-boomfi.png" />

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

<img src="https://mintcdn.com/boom-fi/yPLvmX4qzaQfr3uG/dashboard/images/settings-underpayment-boomfi.png?fit=max&auto=format&n=yPLvmX4qzaQfr3uG&q=85&s=ab920dbcf76b6d41c05eb34a88b6a02e" alt="BoomFi underpayment settings" width="1440" height="900" data-path="dashboard/images/settings-underpayment-boomfi.png" />

### Field names (API / config)

```typescript theme={null}
interface UnderpayThresholds {
  underpay_tolerance_percent?: number; // acceptable underpayment percentage
  underpay_tolerance_usd?: number; // maximum allowable underpayment amount
}
```

## Related

* [Settlement Overview](/settlement/overview)
* [Payment Links](/payments/paylinks)
