UCP Orders & Webhooks

Before writing code

Fetch live spec: Web-search site:ucp.dev specification order and fetch the page for the exact order data model, webhook envelope, and signature format.

Also fetch https://ucp.dev/specification/reference/ for adjustment types, fulfillment event types, and line item status derivation rules.

Conceptual Architecture

Order Capability (dev.ucp.shopping.order)

Orders represent the post-purchase lifecycle. An order is created when a checkout completes successfully. The order contains:

• Line items with quantity tracking (total, fulfilled)
• Fulfillment expectations (estimated delivery) and fulfillment events (shipped, delivered, etc.)
• Adjustments (refunds, returns, credits, disputes, cancellations)
• Totals (subtotal, tax, discount, fulfillment, fee, total)