Invoice Status
Pronunciation: IN-voys STAY-tus
Also known as: Billing Status
Definition
Invoice Status is a controlled state describing where an invoice is in its lifecycle.
Overview
How it works and why it matters
Invoice status describes the obligation as a whole. It may be open, partially paid, paid, expired, void or in review, depending on product rules. It must be derived from one or more qualifying payment events and adjustments, not inferred from a single browser return or transfer attempt.
Important technical and operational details
Invoice status should not be inferred from a single payment attempt because one invoice can have multiple attempts, partial payments, credits, or reversals.
In accounts receivable and invoice operations, it commonly covers draft, open or issued, partially paid, paid, overdue, void, uncollectible, disputed, or refunded states. The concept commonly includes draft, open or issued, partially paid, paid, overdue, void, uncollectible, disputed, or refunded states.
Practical decision points
Design status transitions before implementing callbacks. 'Draft' may become 'open'; 'open' may become 'partially paid' or 'paid'; 'void' or 'expired' should follow the product's published policy. A reversal, overpayment or reconciliation correction may require additional states such as 'review' instead of forcing an impossible transition. Keep a status history with event source, effective time and operator override reason. Multiple on-chain transfers can contribute to one invoice, while one ambiguous transfer must not be credited to two invoices. This ledger of changes lets support explain why an invoice state differs from an individual blockchain transaction's state.
Related concepts
Invoice; Invoice Due Date; Order Status
Further reading
Example
An invoice for $80 receives $30 first and $50 later. Each transfer has its own confirmation history; the invoice moves to paid only when both accepted values satisfy the rule. If $50 arrives on an unsupported chain, the invoice may remain partially paid pending investigation.
Comparison
Invoice status is not the same as transaction status, settlement status or order-fulfillment status. Those processes can move on different timelines.
Key Takeaway
Invoice status aggregates qualifying payments and adjustments, not just one transaction result.
Sources
- Invoicing — Stripe (2026-08-02)
- DraftOrder - GraphQL Admin — Shopify (2026-08-02)