What statuses mean
Documents, network observations and accounting outcomes have separate states.
Document status
Open, Expired and Cancelled describe an invoice lifecycle. A confirmed Payout fixes recipients and amounts. None of these states alone proves payment or submission.
Common invoice observation states
| State | Meaning |
|---|---|
| not_started | Synchronization has not started. |
| syncing | History is still progressing toward its target. |
| review_required | Coverage or evidence needs review; do not treat a final total as established. |
| none_observed | No matching receipts were found in the examined history. |
| partial_observed | Observed receipts are below the invoice amount. |
| amount_observed | Observed receipts match the invoice amount. This is not payment acceptance. |
| excess_observed | Observed receipts exceed the invoice amount; no refund runs automatically. |
Observation and payment acceptance
Recorded, confirmed or final in an observation context describe saved check data. Payment acceptance needs current independent evidence. Changed history, incomplete coverage or an expired conclusion require review.
Unknown outcome
A timeout, lost response or missing lookup does not prove failure. The operation may have been accepted or submitted. Preserve its original request, key, version and hash; inspect that same operation.
A waiting period ending does not free a reservation or authorize a replacement. Recovery uses only the actions provided for the original operation.
Corrections and network reorganization
When confirmed chain evidence changes, a new revision may compensate a previous accounting result. Earlier entries remain in history. Compare revision, compensation direction, amount and fee.
A stored Settlement describes a historical posting. It is not a fresh network-finality check.