Skip to main content

Order Lifecycle

How orders progress from creation to completion.

States​

PENDING → IN_PROGRESS → DELIVERED → COMPLETED
                ↓
            CANCELLED
StateMeaningEntered WhenExits To
PENDINGCreated, no deliveries yet. Escrow held if charge-on-creation enabled. Visible to all, cancellable (if allowed).Order createdIN_PROGRESS on first delivery, CANCELLED, or expires
IN_PROGRESSPartial deliveries made; deliverers paid for what's delivered so far; still accepting deliveries.First delivery occursDELIVERED when all items in, CANCELLED (may be restricted), or expires
DELIVEREDAll items delivered, deliverers fully paid, awaiting creator collection.Last item deliveredCOMPLETED when fully collected; auto-deleted once collection finishes and payment clears
COMPLETEDAll items collected, all payments processed.All items collectedDeleted automatically (cleanup)
CANCELLEDCancelled by creator or admin; escrow refunded if enabled; no further deliveries.Cancel action (any prior state)Deleted (optional, configurable)

Expiration​

Governed by order-life (see Order Configuration):

  • Periodic check finds expired orders.
  • Escrow auto-refunded if enabled.
  • Orders with uncollected items are kept (not deleted) until collected.

Concurrency​

  • Multiple players can deliver to the same order simultaneously.
  • Optimistic locking prevents over-delivery.
  • All state changes are transactional (DB-safe).

See Also​