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

1. Order Created → UNVERIFIED (Initial state, awaiting verification)
2. Buyer Verified → VERIFIED (Requires buyer action via payment_url)
3. (Optional) Merchant Confirms → CONFIRMED (Internal merchant step, triggered by POST /v1/order/:order_id/confirm)
4. Merchant Fulfills → FULFILLING → FULFILLED (Invoice issued, payout scheduled)
5. 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. See Decline Reasons for details.

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. See Child Orders for details on partial refunds.
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.