Underpayment Tolerance

Overview

Underpayment tolerance is a quantitative boundary for accepting a payment whose verified receipt is slightly below the obligation. The rule reduces customer friction and manual work when network fees, rounding, or minor price movement create an economically immaterial difference. It should be deterministic enough that the same evidence produces the same result.

A tolerance can be denominated in invoice currency, received asset units, a fixed amount, a percentage, or a combination such as the lower of two caps. The rule must identify the valuation source and timestamp, decimal precision, rounding direction, treatment of sender and recipient fees, quote expiration, and whether several transactions can be aggregated.

For example, a merchant could accept a shortfall up to 0.5% but no more than five dollars. A 50-cent difference on a small order may pass, while the same percentage on a large invoice exceeds the absolute cap. The original invoice amount remains unchanged; the system records the accepted shortfall as a discount, write-off, or other defined accounting effect.

Tolerance should be narrower for high-value, irreversible, regulated, or fraud-sensitive goods. It may be disabled for unsupported assets, expired quotes, wrong-network transfers, or payments whose attribution is uncertain. Attackers should not be able to split transactions or manipulate rounding repeatedly to obtain systematic discounts.

The threshold is part of the broader underpayment policy. It does not determine how customers top up, how refunds work, who approves an exception above the limit, or when fulfillment is canceled. Those actions belong to recovery and policy workflows.

Teams should monitor accepted shortfall value, frequency, asset and network concentration, and changes after checkout releases. This shows whether the tolerance is reducing trivial work or masking a pricing, fee, or integration defect.

The threshold is evaluated only after the underlying underpayment has been calculated from authoritative receipt and quote evidence.