Order management event
Order update notifications report key milestones in the order lifecycle. Use the Order management webhook to receive near-real time notifications when order lifecycle events occur. Walmart sends a JSON payload at your destination URL for each update. The payload includes a source block with event metadata (source.eventType is ORDER_UPDATES) and a payload.order block with order details plus a concrete payload.subEventType such as PO_CREATED, PO_LINE_AUTOCANCELLED, INTENT_TO_CANCEL, or FRAUD_CANCEL.
Use these events to start fulfillment, pause or cancel lines, update customer messaging, and reconcile post-purchase workflows. Near real-time updates reduce polling and speed downstream actions and helps teams meet delivery SLAs.
Event metadata
- Event type: ORDER_UPDATES
- Event version: V1
- Resource name: ORDER
Supported order sub-events (subEventType)
subEventType)| Value | When it occurs | Typical use |
|---|---|---|
PO_CREATED | A new purchase order is created | Start acknowledgment and fulfillment workflows |
PO_LINE_AUTOCANCELLED | A line was auto-cancelled by the system | Notify customer; update inventory and refund if needed |
INTENT_TO_CANCEL | A cancellation intent was recorded | Pause fulfillment or confirm cancellation |
FRAUD_CANCEL | Order or line cancelled due to fraud | Block shipment; reconcile payment and inventory |
Response parameters
Applies to all order update sub-events: PO_CREATED, PO_LINE_AUTOCANCELLED, INTENT_TO_CANCEL, FRAUD_CANCEL.
| Name | Description | Type |
|---|---|---|
| source | Metadata about the event envelope. | Object |
| eventType | Event envelope type sent in the source block. Always ORDER_UPDATES. | String |
| eventFilters | Reserved for future use; may be null. | Object or null |
| eventTime | Time the event was generated. ISO 8601 UTC. | String |
| eventId | Unique identifier for the event delivery. Use as an idempotency key. | String |
| payload | Event-specific details. | Object |
| meta | Event metadata container that describes the concrete order update. | Object |
| subEventType | Concrete order update type. One of PO_CREATED, PO_LINE_AUTOCANCELLED, INTENT_TO_CANCEL, FRAUD_CANCEL. | String (enum) |
| order | Order data for this event. | Object |
| orderType | Order type (for example REGULAR). | String |
| customerEmailId | Customer email (masked or relay). | String |
| shippingInfo | Shipping method, delivery estimates, phone, and address. | Object |
| methodCode | Shipment method (for example Standard). | String |
| estimatedShipDate | Estimated ship date, epoch milliseconds. | Long |
| estimatedDeliveryDate | Estimated delivery date, epoch milliseconds. | Long |
| phone | Contact phone number. | String |
| postalAddress | Delivery address container (country, city, address1, state, postalCode, addressType, name). | Object |
| country | Country code (for example USA). | String |
| city | City. | String |
| address1 | Address line 1. | String |
| address2 | Address line 2, if present. | String |
| state | State or region. | String |
| postalCode | Postal code. . | String |
| addressType | Address type (for example RESIDENTIAL). | String |
| name | Recipient name. | String |
| orderLines | Container for line items. | Object |
| orderLine | Array of order line objects. | Array |
| lineNumber | Line number. | String |
| statusDate | Last status update time for the line, epoch milliseconds. | Long |
| item | Product information for the line. | Object |
| productName | Product name. | String |
| sku | Seller SKU. | String |
| condition | Item condition (for example New). | String |
| imageUrl | Product image URL, if present. | String |
| weight | Item weight with unit and value, if present. | Object |
| unit | Weight unit (for example LB). | String |
| value | Weight value. | String |
| charges | Line-level charges. | Object |
| charge | Array of charge components. | Array |
| chargeType | Charge type (for example PRODUCT, FEE). | String |
| chargeName | Charge name (for example ItemPrice, Fee). | String |
| chargeAmount | Monetary amount object for the charge. | Object |
| amount | Numeric amount used inside monetary objects (chargeAmount, taxAmount, taxAndOtherFeesAmount). | Number |
| currency | ISO currency code used inside monetary objects. | String |
| tax | Tax details for the charge, if present. | Object |
| taxAmount | Monetary tax amount. | Object |
| taxName | Name of the tax. | String |
| taxAndOtherFees | Additional fees, if present. | Object |
| taxAndOtherFeesName | Name of the additional fee. | String |
| taxAndOtherFeesAmount | Monetary fee amount. | Object |
| orderLineQuantity | Line quantity information. | Object |
| unitOfMeasurement | Unit of measure for quantities (for example EACH). | String |
| orderLineStatuses | Status history for the line. | Object |
| orderLineStatus | Array of status entries. | Array |
| status | Current status value (for example Created, Cancelled, Shipped, Delivered). | String |
| statusQuantity | Quantity in this status. | Object |
| trackingInfo | Tracking details, if available. carrierName may be an empty object. | Object |
| trackingNumber | Tracking number, if present. | String |
| trackingURL | Tracking URL, if present. | String |
| carrierName | Carrier container; may be empty. | Object |
| fulfillment | Fulfillment attributes for the line. | Object |
| fulfillmentOption | DELIVERY or PICKUP. | String |
| shipMethod | Shipment speed (for example STANDARD). | String |
| shippingProgramType | Program speed (for example THREE_TO_FIVE_DAY). | String |
| shippingSLA | Shipping SLA value, if present. | String |
| shippingConfigSource | SELLER or WALMART. | String |
| pickUpDateTime | Pickup date and time, epoch milliseconds, if present. | Long |
| shipWithWalmartCrossBorderEnrolled | Whether the line is enrolled in cross-border. | Boolean |
| shipNode | Fulfillment node details. | Object |
| id | Ship node identifier. | String |
| type | Ship node type (for example SellerFulfilled, Store, FC). | String |
| customerOrderId | Unique identifier for the customer order. | String |
| partnerId | Seller partner identifier. | String |
Applies to all sub-events
- Use
source.eventIdas an idempotency key to safely de-duplicate deliveries. - Parse times as indicated:
source.eventTimeis ISO 8601 (UTC); most order timestamps (for exampleorderDate,statusDate,estimatedShipDate,estimatedDeliveryDate,pickUpDateTime) are epoch milliseconds. - Additional sub-events may be added in future versions. Ignore unrecognized fields to keep your integration forward-compatible.
Sample payloads by sub-event
PO_CREATED
{ "source": { "eventType": "ORDER_UPDATES", "eventFilters": null, "eventTime": "2026-01-13T19:30:07.142Z", "eventId": "44707460-f0b6-11f0-8b81-198424ea73e3" }, "payload": { "meta": { "subEventType": "PO_CREATED" }, "order": { "orderType": "REGULAR", "customerEmailId": "[email protected]", "orderLines": { "orderLine": [ { "statusDate": 1768294804246, "item": { "condition": "New", "imageUrl": "https://i5-qa.walmartimages.com/seo/Crown-Camp-Fuel-Gallon_783282f9-4aec-494c-ac2a-ce67a87e808b.7084f63464c65f81592d4744fdb2bce2.jpeg", "weight": { "unit": "LB", "value": "8" }, "sku": "SKU-00023857310115", "productName": "Crown White Gas Camp Fuel for Use in Gasoline Stoves and Lanterns, 1 Gallon" }, "charges": { "charge": [ { "taxAndOtherFees": { "taxAndOtherFeesName": "Tax1", "taxAndOtherFeesAmount": { "amount": 1.51, "currency": "USD" } }, "chargeType": "PRODUCT", "chargeAmount": { "amount": 15, "currency": "USD" }, "tax": { "taxAmount": { "amount": 1.51, "currency": "USD" }, "taxName": "Tax1" }, "chargeName": "ItemPrice" }, { "taxAndOtherFees": { "taxAndOtherFeesName": "California Redemption Value(CRV)", "taxAndOtherFeesAmount": { "amount": 1.2, "currency": "USD" } }, "chargeType": "FEE", "chargeAmount": { "amount": 0, "currency": "USD" }, "tax": { "taxAmount": { "amount": 1.2, "currency": "USD" }, "taxName": "California Redemption Value(CRV)" }, "chargeName": "Fee" } ] }, "orderLineStatuses": { "orderLineStatus": [ { "trackingInfo": { "carrierName": {}, "methodCode": "Standard" }, "status": "CANCELLED", "statusQuantity": { "unitOfMeasurement": "EACH", "amount": "1" } } ] }, "orderLineQuantity": { "unitOfMeasurement": "EACH", "amount": "1" }, "fulfillment": { "shippingSLA": "5", "shipMethod": "STANDARD", "fulfillmentOption": "DELIVERY", "shippingConfigSource": "SELLER", "shippingProgramType": "THREE_TO_FIVE_DAY", "pickUpDateTime": 1768122463893 }, "lineNumber": "1", "shipWithWalmartCrossBorderEnrolled": false } ] }, "shipNode": { "name": "Shoes.com - 10900015173 - MP", "id": "10900015173", "type": "SellerFulfilled" }, "purchaseOrderId": "129101316011725", "customerOrderId": "701768208862892", "shippingInfo": { "postalAddress": { "country": "USA", "city": "San Jose", "address1": "2476 Barlow Ave", "addressType": "RESIDENTIAL", "postalCode": "95122", "name": "RxTestNamerxTestName rxTestName", "state": "CA" }, "phone": "0000000000", "estimatedShipDate": 1768287600000, "estimatedDeliveryDate": 1768766400000, "methodCode": "Standard" }, "orderDate": 1768208863893 } }
}
PO_LINE_AUTOCANCELLED
{ "source": { "eventType": "ORDER_UPDATES", "eventFilters": null, "eventTime": "2026-01-13T19:30:07.142Z", "eventId": "44707460-f0b6-11f0-8b81-198424ea73e3" }, "payload": { "meta": { "subEventType": "PO_LINE_AUTOCANCELLED" }, "order": { "orderType": "REGULAR", "customerEmailId": "[email protected]", "orderLines": { "orderLine": [ { "statusDate": 1768294804246, "item": { "condition": "New", "imageUrl": "https://i5-qa.walmartimages.com/seo/Crown-Camp-Fuel-Gallon_783282f9-4aec-494c-ac2a-ce67a87e808b.7084f63464c65f81592d4744fdb2bce2.jpeg", "weight": { "unit": "LB", "value": "8" }, "sku": "SKU-00023857310115", "productName": "Crown White Gas Camp Fuel for Use in Gasoline Stoves and Lanterns, 1 Gallon" }, "charges": { "charge": [ { "taxAndOtherFees": { "taxAndOtherFeesName": "Tax1", "taxAndOtherFeesAmount": { "amount": 1.51, "currency": "USD" } }, "chargeType": "PRODUCT", "chargeAmount": { "amount": 15, "currency": "USD" }, "tax": { "taxAmount": { "amount": 1.51, "currency": "USD" }, "taxName": "Tax1" }, "chargeName": "ItemPrice" }, { "taxAndOtherFees": { "taxAndOtherFeesName": "California Redemption Value(CRV)", "taxAndOtherFeesAmount": { "amount": 1.2, "currency": "USD" } }, "chargeType": "FEE", "chargeAmount": { "amount": 0, "currency": "USD" }, "tax": { "taxAmount": { "amount": 1.2, "currency": "USD" }, "taxName": "California Redemption Value(CRV)" }, "chargeName": "Fee" } ] }, "orderLineStatuses": { "orderLineStatus": [ { "trackingInfo": { "carrierName": {}, "methodCode": "Standard" }, "status": "CANCELLED", "statusQuantity": { "unitOfMeasurement": "EACH", "amount": "1" } } ] }, "orderLineQuantity": { "unitOfMeasurement": "EACH", "amount": "1" }, "fulfillment": { "shippingSLA": "5", "shipMethod": "STANDARD", "fulfillmentOption": "DELIVERY", "shippingConfigSource": "SELLER", "shippingProgramType": "THREE_TO_FIVE_DAY", "pickUpDateTime": 1768122463893 }, "lineNumber": "1", "shipWithWalmartCrossBorderEnrolled": false } ] }, "shipNode": { "name": "Shoes.com - 10900015173 - MP", "id": "10900015173", "type": "SellerFulfilled" }, "purchaseOrderId": "129101316011725", "customerOrderId": "701768208862892", "shippingInfo": { "postalAddress": { "country": "USA", "city": "San Jose", "address1": "2476 Barlow Ave", "addressType": "RESIDENTIAL", "postalCode": "95122", "name": "RxTestNamerxTestName rxTestName", "state": "CA" }, "phone": "0000000000", "estimatedShipDate": 1768287600000, "estimatedDeliveryDate": 1768766400000, "methodCode": "Standard" }, "orderDate": 1768208863893 } }
}
INTENT_TO_CANCEL
{ "source": { "eventType": "ORDER_UPDATES", "eventFilters": null, "eventTime": "2026-01-13T19:30:07.142Z", "eventId": "44707460-f0b6-11f0-8b81-198424ea73e3" }, "payload": { "meta": { "subEventType": "INTENT_TO_CANCEL" }, "order": { "orderType": "REGULAR", "customerEmailId": "[email protected]", "orderLines": { "orderLine": [ { "statusDate": 1768294804246, "item": { "condition": "New", "imageUrl": "https://i5-qa.walmartimages.com/seo/Crown-Camp-Fuel-Gallon_783282f9-4aec-494c-ac2a-ce67a87e808b.7084f63464c65f81592d4744fdb2bce2.jpeg", "weight": { "unit": "LB", "value": "8" }, "sku": "SKU-00023857310115", "productName": "Crown White Gas Camp Fuel for Use in Gasoline Stoves and Lanterns, 1 Gallon" }, "charges": { "charge": [ { "taxAndOtherFees": { "taxAndOtherFeesName": "Tax1", "taxAndOtherFeesAmount": { "amount": 1.51, "currency": "USD" } }, "chargeType": "PRODUCT", "chargeAmount": { "amount": 15, "currency": "USD" }, "tax": { "taxAmount": { "amount": 1.51, "currency": "USD" }, "taxName": "Tax1" }, "chargeName": "ItemPrice" }, { "taxAndOtherFees": { "taxAndOtherFeesName": "California Redemption Value(CRV)", "taxAndOtherFeesAmount": { "amount": 1.2, "currency": "USD" } }, "chargeType": "FEE", "chargeAmount": { "amount": 0, "currency": "USD" }, "tax": { "taxAmount": { "amount": 1.2, "currency": "USD" }, "taxName": "California Redemption Value(CRV)" }, "chargeName": "Fee" } ] }, "orderLineStatuses": { "orderLineStatus": [ { "trackingInfo": { "carrierName": {}, "methodCode": "Standard" }, "status": "CANCELLED", "statusQuantity": { "unitOfMeasurement": "EACH", "amount": "1" } } ] }, "orderLineQuantity": { "unitOfMeasurement": "EACH", "amount": "1" }, "fulfillment": { "shippingSLA": "5", "shipMethod": "STANDARD", "fulfillmentOption": "DELIVERY", "shippingConfigSource": "SELLER", "shippingProgramType": "THREE_TO_FIVE_DAY", "pickUpDateTime": 1768122463893 }, "lineNumber": "1", "shipWithWalmartCrossBorderEnrolled": false } ] }, "shipNode": { "name": "Shoes.com - 10900015173 - MP", "id": "10900015173", "type": "SellerFulfilled" }, "purchaseOrderId": "129101316011725", "customerOrderId": "701768208862892", "shippingInfo": { "postalAddress": { "country": "USA", "city": "San Jose", "address1": "2476 Barlow Ave", "addressType": "RESIDENTIAL", "postalCode": "95122", "name": "RxTestNamerxTestName rxTestName", "state": "CA" }, "phone": "0000000000", "estimatedShipDate": 1768287600000, "estimatedDeliveryDate": 1768766400000, "methodCode": "Standard" }, "orderDate": 1768208863893 } }
}
FRAUD_CANCEL
{ "source": { "eventType": "ORDER_UPDATES", "eventFilters": null, "eventTime": "2026-01-13T19:30:07.142Z", "eventId": "44707460-f0b6-11f0-8b81-198424ea73e3" }, "payload": { "meta": { "subEventType": "FRAUD_CANCEL" }, "order": { "orderType": "REGULAR", "customerEmailId": "[email protected]", "orderLines": { "orderLine": [ { "statusDate": 1768294804246, "item": { "condition": "New", "imageUrl": "https://i5-qa.walmartimages.com/seo/Crown-Camp-Fuel-Gallon_783282f9-4aec-494c-ac2a-ce67a87e808b.7084f63464c65f81592d4744fdb2bce2.jpeg", "weight": { "unit": "LB", "value": "8" }, "sku": "SKU-00023857310115", "productName": "Crown White Gas Camp Fuel for Use in Gasoline Stoves and Lanterns, 1 Gallon" }, "charges": { "charge": [ { "taxAndOtherFees": { "taxAndOtherFeesName": "Tax1", "taxAndOtherFeesAmount": { "amount": 1.51, "currency": "USD" } }, "chargeType": "PRODUCT", "chargeAmount": { "amount": 15, "currency": "USD" }, "tax": { "taxAmount": { "amount": 1.51, "currency": "USD" }, "taxName": "Tax1" }, "chargeName": "ItemPrice" }, { "taxAndOtherFees": { "taxAndOtherFeesName": "California Redemption Value(CRV)", "taxAndOtherFeesAmount": { "amount": 1.2, "currency": "USD" } }, "chargeType": "FEE", "chargeAmount": { "amount": 0, "currency": "USD" }, "tax": { "taxAmount": { "amount": 1.2, "currency": "USD" }, "taxName": "California Redemption Value(CRV)" }, "chargeName": "Fee" } ] }, "orderLineStatuses": { "orderLineStatus": [ { "trackingInfo": { "carrierName": {}, "methodCode": "Standard" }, "status": "CANCELLED", "statusQuantity": { "unitOfMeasurement": "EACH", "amount": "1" } } ] }, "orderLineQuantity": { "unitOfMeasurement": "EACH", "amount": "1" }, "fulfillment": { "shippingSLA": "5", "shipMethod": "STANDARD", "fulfillmentOption": "DELIVERY", "shippingConfigSource": "SELLER", "shippingProgramType": "THREE_TO_FIVE_DAY", "pickUpDateTime": 1768122463893 }, "lineNumber": "1", "shipWithWalmartCrossBorderEnrolled": false } ] }, "shipNode": { "name": "Shoes.com - 10900015173 - MP", "id": "10900015173", "type": "SellerFulfilled" }, "purchaseOrderId": "129101316011725", "customerOrderId": "701768208862892", "shippingInfo": { "postalAddress": { "country": "USA", "city": "San Jose", "address1": "2476 Barlow Ave", "addressType": "RESIDENTIAL", "postalCode": "95122", "name": "RxTestNamerxTestName rxTestName", "state": "CA" }, "phone": "0000000000", "estimatedShipDate": 1768287600000, "estimatedDeliveryDate": 1768766400000, "methodCode": "Standard" }, "orderDate": 1768208863893 } }
}
Updated about 4 hours ago