Underpayment Rate
Pronunciation: UN-dur-pay-ment RAYT
Definition
Underpayment rate is the percentage of eligible payment attempts or invoices that receive less than the required amount during a defined period. The denominator, tolerance rule, valuation method, and status cutoff must be stated for the metric to be meaningful. Underpayment Rate reporting should distinguish the number and value of exceptions, their root causes, recovery methods, customer impact, and any loss absorbed by the merchant.
Overview
Underpayment rate is the percentage of eligible payment attempts or invoices that receive less than the required amount during a defined period. The denominator, tolerance rule, valuation method, and status cutoff must be stated for the metric to be meaningful. When implementing Underpayment Rate alongside Underpayment Policy, reporting should distinguish the number and value of exceptions, their root causes, recovery methods, customer impact, and any loss absorbed by the merchant.
A complete record for Underpayment Rate should show where it depends on Underpayment Tolerance and how it differs from Underpayment Policy. That distinction lets teams reconcile Underpayment Rate without treating a related interface or event as final financial evidence.
For Underpayment Rate, tolerance must be explicit and deterministic. When Underpayment Rate interacts with Underpayment Tolerance, teams should define whether it is absolute or percentage-based, which valuation time applies, whether network or token fees affect the recognized amount, and whether several transfers can be combined. In the relationship between Underpayment Rate and Underpayment Policy, limits should prevent systematic underpayment, tolerance abuse, repeated manual acceptance, and inconsistent outcomes for similar customers.
For Underpayment Rate, exception reporting should separate frequency, value, cause, recovery method, loss, and processing time. When Underpayment Rate interacts with Underpayment Tolerance, controls should use unique references, idempotent crediting, asset and network allowlists, immutable links among invoice and transfer records, dual approval for material manual decisions, and customer communication that does not falsely present a discrepancy as final settlement.
For Underpayment Rate, payment discrepancy handling should compare the original obligation with observed transfers using exact asset and network identity, amount, timing, reference, memo, fee behavior, and quote rules. When Underpayment Rate interacts with Underpayment Tolerance, the system should never rewrite the original invoice merely to make a mismatch disappear. In the relationship between Underpayment Rate and Underpayment Policy, resolution may require another payment, merchant acceptance, a credit, a refund, or a reviewed adjustment, each recorded as a separate event.
Key Takeaway
Underpayment Rate should be handled according to the fact that the percentage of eligible payment attempts or invoices that receive less than the required amount during a defined period, with the corresponding validation and exception controls.
Sources
- OxaPay API Reference: Generate Invoice — OxaPay (2026-08-01)
- OxaPay API Reference: Payment Status Table — OxaPay (2026-08-01)