Order Status

Order and session status values and their meanings.

Order Status

const OrderStatus = {
  SIGNAL_SUBMITTED: 'SIGNAL_SUBMITTED',
  SIGNAL_MINED: 'SIGNAL_MINED',
  PAYMENT_SENT: 'PAYMENT_SENT',
  PROOF_VERIFIED: 'PROOF_VERIFIED',
  FULFILL_SUBMITTED: 'FULFILL_SUBMITTED',
  FULFILLED: 'FULFILLED',
  CANCELLED: 'CANCELLED',
  EXPIRED: 'EXPIRED',
  FAILED: 'FAILED',
} as const;

Status Descriptions

Status	Description
SIGNAL_SUBMITTED	Intent transaction submitted, awaiting confirmation
SIGNAL_MINED	Intent confirmed on-chain, awaiting payment
PAYMENT_SENT	User indicated they sent fiat payment
PROOF_VERIFIED	Payment proof verified by attestation service
FULFILL_SUBMITTED	Fulfillment transaction submitted
FULFILLED	Payment complete, USDC transferred
CANCELLED	Order cancelled by user or system
EXPIRED	Order expired before completion
FAILED	Order failed (verification or tx error)

Status Flow

                    ┌──────────────────┐
                    │ SIGNAL_SUBMITTED │
                    └────────┬─────────┘
                             ↓
                    ┌─────────────────┐
              ┌─────│  SIGNAL_MINED   │─────┐
              │     └────────┬────────┘     │
              ↓              ↓              ↓
         ┌─────────┐  ┌─────────────┐  ┌─────────┐
         │ EXPIRED │  │ PAYMENT_SENT│  │CANCELLED│
         └─────────┘  └──────┬──────┘  └─────────┘
                             ↓
                    ┌─────────────────┐
                    │ PROOF_VERIFIED  │
                    └────────┬────────┘
                             ↓
                    ┌──────────────────┐
              ┌─────│FULFILL_SUBMITTED │─────┐
              │     └────────┬─────────┘     │
              ↓              ↓               ↓
         ┌─────────┐  ┌───────────┐    ┌─────────┐
         │ FAILED  │  │ FULFILLED │    │ FAILED  │
         └─────────┘  └───────────┘    └─────────┘

Terminal States

Status	Is Terminal	Description
FULFILLED	Yes	Success - payment complete
CANCELLED	Yes	User or system cancelled
EXPIRED	Yes	Timed out
FAILED	Yes	Error occurred

---

Session Status

const SessionStatus = {
  CREATED: 'CREATED',
  ACTIVE: 'ACTIVE',
  COMPLETED: 'COMPLETED',
  EXPIRED: 'EXPIRED',
  CANCELLED: 'CANCELLED',
} as const;

Status Descriptions

Status	Description
CREATED	Session created, awaiting user
ACTIVE	User started checkout, order in progress
COMPLETED	Payment successful
EXPIRED	Session expired (1 hour default)
CANCELLED	User cancelled checkout

---

Proof Attempt Status

const ProofAttemptStatus = {
  PENDING: 'PENDING',
  VERIFYING: 'VERIFYING',
  VERIFIED: 'VERIFIED',
  REJECTED: 'REJECTED',
} as const;

Status Descriptions

Status	Description
PENDING	Proof received, awaiting processing
VERIFYING	Proof being verified
VERIFIED	Proof verified successfully
REJECTED	Proof verification failed (can retry)

---

Webhook Delivery Status

const WebhookDeliveryStatus = {
  PENDING: 'PENDING',
  DELIVERED: 'DELIVERED',
  FAILED: 'FAILED',
} as const;

Status	Description
PENDING	Awaiting delivery or retry
DELIVERED	Successfully delivered (2xx response)
FAILED	All retry attempts exhausted