Two Order States
A Two order moves through a series of states from creation to completion or cancellation. Understanding these states helps you track, troubleshoot, and automate your order flows.
Typical Order Journey
- Order Created → UNVERIFIED
- Buyer Verified → VERIFIED
- (Optional) Buyer Confirms → CONFIRMED
- Merchant Fulfills → FULFILLING → FULFILLED
- Refunded or Cancelled → REFUNDED / CANCELLED
Tip: UNVERIFIED orders auto-cancel after 48 hours if not verified.
Order Statuses
- APPROVED: Order is approved and can proceed.
- REJECTED: Order is rejected due to credit or fraud concerns.
State Reference Table
| State | Description |
|---|---|
| UNVERIFIED | Order created, awaiting buyer ID verification. |
| VERIFIED | Buyer ID verified. |
| CONFIRMED | (Optional) Buyer has confirmed the order. |
| FULFILLING | Merchant is fulfilling the order (pre-fulfilment state). |
| FULFILLED | Order is complete, invoice issued, payout scheduled. |
| REFUNDED | Order is partially or fully refunded. |
| CANCELLED | Order is cancelled (auto-cancels if UNVERIFIED for 48h). |
Example: Order State Payload
Show example JSON
{
"id": "order_123",
"state": "FULFILLED",
"status": "APPROVED",
...
}Visual: Miro Order State Diagram
Troubleshooting:
- If your order is stuck in UNVERIFIED, check buyer verification steps.
- If an order is CANCELLED or REJECTED, review credit/fraud status and try again.
- For more on webhooks, refunds, and state transitions, see the related guides in the sidebar.