Order Status Updated Event

Event Type: order.status_updated

When sent: When order status changes through internal processes (payment confirmation, fulfillment updates).

NOT sent when: Order status is updated via SDK API calls (to prevent webhook loops).

Status change notifications help you keep external systems synchronized and trigger appropriate customer communications.

Example webhook payload

Webhook Payload Schema

Order status updated event data

Property

Type

Description

storeIdrequired

string (uuid)

Store identifier

customerId

string (uuid)

Customer identifier

occurredAtrequired

string (date-time)

When the event occurred

externalReference

string

External reference for tracking

orderIdrequired

string (uuid)

Order identifier

orderNumberrequired

string

Order number

previousStatusrequired

string

Previous order status

newStatusrequired

string

New order status

statusUpdatedAtrequired

string (date-time)

When the status was updated

statusChangeReason

string

Reason for status change