Order Change Events
orderUpdate is a general event for any change to an existing order. Subscribe to it to learn that an order changed, or subscribe to the specific events listed below to receive only the changes you need. Each change raises its specific event first, then orderUpdate, whose metadata.change field says what changed:
metadata.change | Raised when | Specific event |
|---|---|---|
| orderStatus | The order’s status changes | orderStatusUpdate |
| orderCommission | The order’s commissioned associates are added, changed or removed | orderCommissionsUpdate |
| lineItemCommission | The commissioned associates on one of the order’s line items are added, changed or removed | orderLineItemCommissionsUpdate |
| layawayPayment | A payment or refund is applied to a layaway order | orderLayawayPaymentApplied |
| layawayComplete | A layaway order is fully paid | orderLayawayComplete |
More values may be added over time.
Example orderUpdate event
{
"uuid" : "6b0d1c2e-8f3a-4b5c-9d7e-1a2b3c4d5e6f",
"subscription": "1fec24e8-f02c-4ff6-a1a5-37bbdac42b1b",
"createdAt":"2026-10-29T13:45:30Z",
"eventType": "orderUpdate",
"resourceType":"Order",
"resource": {
"uuid": "b7f1a1c2-3d4e-4f50-8a6b-7c8d9e0f1a2b",
"externalId":"ORD-42"
},
"source": "TULIP_API",
"metadata": {
"change": "layawayPayment"
}
}