Accept payments
Payment lifecycle
Use paid for completion. payment_detected is not a paid order.
States
| Status | Meaning | Fulfill? |
|---|---|---|
| pending | Open, awaiting a qualifying transfer | No |
| payment_detected | Transfer seen; confirmation or settlement continues | No |
| partial | Below quoted amount | No |
| paid | Merchant settlement complete | Yes, once |
| expired | Window ended | No |
| cancelled | Unpaid invoice cancelled | No |
| reverted | Chain reconciliation invalidated the payment | No |
| manual_review | Needs your decision: short or late payment, or a settlement exception (see paymentException) | No, decide first |
What to show
Checkout may show Payment received at payment_detected. Show a completed receipt only at paid. Browser closure does not interrupt detection. Restore the existing invoice when checkout reopens.