Skip to main content

Cart, checkout, and order lifecycle

Generated from COPE public event contracts. Do not edit this page by hand.
A cart’s state and a checkout’s status are what the Checkout SDK and the cart API return; an order’s state is what the commerce API returns. Not every transition has its own event.

Cart States

A cart can also become expired, when it can no longer be used, or merged, when it was merged into another cart. Neither is announced by an event.

Checkout States

Order States

Refunds and chargebacks do not change an order’s state. They are payment events: payment.refund.* and payment.chargeback.*, on the payment lifecycle.

Consumption Notes

  • Treat cart.order.completed as the primary fulfillment signal.
  • Use payment events when your integration needs payment-state reconciliation rather than order fulfillment.