Events

Subscribe to the topics your app needs. Each delivery is signed and arrives within seconds. Every topic requires a scope, and payloads never include fields the merchant did not grant.

Order event sequence

The order in which order events fire for a typical paid order. Free or manual orders can skip steps, so never assume every event arrives.

abandoned_cart.createdCart not paidThe store marked an unpaid cart as abandoned, at its first reminder threshold.
order.createdOrder createdA new order was created, either paid or awaiting payment.
order.paidPaidThe order payment was confirmed.
order.digital.deliveredDigital deliveryDigital content was delivered to the customer.
order.status.updatedStatus changedThe order status changed.
order.refundedRefundedA refund was recorded on the order.

All topics

Topic	Scope	Fires when
`order.created`	`orders:read`	A new order was created, either paid or awaiting payment.
`order.paid`	`orders:read`	The order payment was confirmed.
`order.status.updated`	`orders:read`	The order status changed.
`order.refunded`	`orders:read`	A refund was recorded on the order.
`order.digital.delivered`	`orders:read`	Digital content was delivered to the customer.
`abandoned_cart.created`	`carts:read`	The store marked an unpaid cart as abandoned, at its first reminder threshold.
`product.created`	`products:read`	A product was created, from the merchant dashboard or by an app.
`product.updated`	`products:read`	Any product field changed: name, price, images or status.
`product.deleted`	`products:read`	A product was deleted.
`category.created`	`products:read`	A category was created.
`category.updated`	`products:read`	A category name, image, sort order or visibility changed.
`category.deleted`	`products:read`	A category was deleted.
`inventory.physical.updated`	`inventory:read` `products:read`	A physical product quantity changed: a sale, a manual adjustment or an app.

Subscribing, signature verification and retries are covered in Webhooks.