Dynamic Invoice
Pronunciation: dye-NAM-ik IN-voys
Definition
A dynamic invoice is an invoice whose amount, currency, payment instructions, status, or other fields are generated or updated from current order, rate, usage, tax, or customer data. It is useful for variable charges and crypto conversion, but changes must be versioned. Once a payment is authorized, the system should not silently alter the obligation associated with that payment attempt.
Overview
Meaning and scope
A dynamic invoice is an invoice whose amount, currency, payment instructions, status, or other fields are generated or updated from current order, rate, usage, tax, or customer data. It is useful for variable charges and crypto conversion, but changes must be versioned. Once a payment is authorized, the system should not silently alter the obligation associated with that payment attempt.
Mechanism and operation
A dynamic invoice can calculate metered usage, current inventory, late fees, taxes, discounts, or a fiat-to-crypto amount at creation time. The invoice should have a stable identity even when revisions are issued. Each version should show what changed, when it changed, and whether the previous payment instructions remain valid. For crypto, a new quote or pay currency can require a new address or payment session. Reusing an old transaction reference after repricing creates matching and refund errors. Systems should preserve invoice version, source data, calculation, rate, approval, effective time, superseded status, payment attempts, and final settled version.
Practical payment example
An order system requests a new payment invoice with a fixed amount and expiry instead of reusing an old quote after a price change.
Operational checks
For Dynamic Invoice, the operational boundary with Dynamic Checkout and Dynamic Payment Address should be explicit. Identifiers for Dynamic Invoice should connect those records without allowing either linked status to overwrite its own state. For Dynamic Invoice, the invoice and the payment used to settle it should remain separate records.
Distinctions and limits
Risks include unauthorized changes, stale customer views, duplicate versions, inconsistent accounting, late payments to superseded instructions, and dispute over the accepted price. When Dynamic Invoice interacts with Dynamic Checkout, the invoice defines the commercial obligation, parties, amount, denomination, tax, due date, and revision history; payment records hold quotes, addresses, transaction identifiers, confirmations, fees, refunds, and settlement.
Related reading
Related definitions: Dynamic Payment Address, Payment Address.
Example
An order system requests a new payment invoice with a fixed amount and expiry instead of reusing an old quote after a price change.
Comparison
Once a payment is authorized, the system should not silently alter the obligation associated with that payment attempt. Risks include unauthorized changes, stale customer views, duplicate versions, inconsistent accounting, late payments to superseded instructions, and dispute over the accepted price.
Key Takeaway
Dynamic invoices require versioned calculations and payment instructions so repricing, revisions, superseded links, and accepted payments remain unambiguous.
Sources
- Peppol BIS Billing 3.0 — OpenPeppol (2026-08-01)
- OxaPay API Reference: Generate Invoice — OxaPay (2026-08-01)