UCP Order Management

Order management covers everything after checkout: confirmation, updates, cancellations, and refunds.

Figure: Order lifecycle states.

State diagram of order lifecycle from confirmed to completed or canceled.

Core Actions

  • Confirm: return a stable order ID and expected fulfillment timeline.
  • Status: expose current state (processing, shipped, completed, canceled).
  • Modify: allow agent-initiated changes with clear rules.
  • Cancel/Refund: implement standard paths and restrictions.

Reliability Principles

  • Make status updates idempotent.
  • Provide consistent state transitions.
  • Track every update with timestamps and trace IDs.

Operational Notes

  • Prefer webhooks for updates; fall back to polling if needed.
  • Separate "payment state" from "fulfillment state".

Related