Invoice Amount

Overview

Meaning and scope

Invoice amount is the monetary value the customer is asked to pay under an invoice. It can represent the final total or a specifically labeled subtotal, tax amount, balance due, or installment. The field must include a currency or asset and a calculation definition. In crypto billing, the fiat invoice amount should remain separate from the temporary crypto pay amount.

Mechanism and operation

The amount can be calculated from line items, quantities, unit prices, discounts, shipping, tax, fees, credits, and previous payments. Rounding should be applied consistently at the required level. An invoice can be partially paid, overpaid, credited, or adjusted. The original amount, paid amount, and current balance due should remain separate values. When a fiat-priced invoice is paid in crypto, the system uses an exchange rate and precision rules to create the expected pay amount. This quote can expire without changing the original invoice total. Systems should preserve original amount, currency, components, calculation version, adjustments, paid amount, balance, crypto quote, and settlement value.

Practical payment example

A service quotes 125 USDT for an annual subscription. The payment matcher compares on-chain received units with the invoice tolerance, rather than blindly treating any transfer as a full payment.

Operational checks

The workflow for Invoice Amount commonly touches Invoice Checkout and Invoice Underpayment. Documenting those handoffs keeps duplicate events, delayed updates, and manual corrections for Invoice Amount traceable to the correct object. For Invoice Amount, the invoice and the payment used to settle it should remain separate records.

Distinctions and limits

Risks include currency omission, double-added tax, inconsistent rounding, negative balances, stale crypto quotes, and overwriting the original amount after a credit note.

Related reading

Related definitions: Invoice Checkout, Invoice Underpayment.