Multichannel solutions APIs in sandbox

The following Multichannel Solutions (MCS) APIs are available in the sandbox for testing. You can use these endpoints to simulate and validate sales channel setup, order fulfillment, and tracking flows.

Sales channel management

You can use the sales channel management to create, retrieve, and update Multichannel Solutions (MCS) sales channel details. For more details, refer to MCS sales Channel Management APIs​.

MCS APIDescriptionEndpointMethod
Create MCS Sales Channel detailsSet up a new test sales channel in MCS./v3/fulfillment/orders-fulfillments/channel-detailsPOST
Get MCS Sales Channel detailsRetrieve details for test sales channels you’ve already created for MCS./v3/fulfillment/orders-fulfillments/channel-detailsGET
Update MCS Sales Channel detailsUpdates MCS test sales channel details for existing sales channels./v3/fulfillment/orders-fulfillments/channel-detailsPUT

Items management

You can use the items management APIs to create and retrieve test items to use in the sandbox. For more details, refer to MCS Items management APIs​. 

MCS APIDescriptionEndpointMethod
Create test itemCreate a mock MCS item for testing fulfillment and order flows./v3/fulfillment/mcs/itemPOST
Get test itemRetrieve mock MCS item details from the sandbox./v3/fulfillment/mcs/itemGET

Order management 

You can use the order management APIs to create, retrieve, and cancel customer orders in the Multichannel Solutions (MCS) sandbox. These APIs simulate order placement and fulfillment initiation. For more details, refer to MCS Order Management APIs.

MCS APIDescriptionEndpointMethod
Fetch delivery promiseAccess estimated delivery dates and shipping timelines based on fulfillment details./v3/fulfillment/orders-fulfillments/fetchOrderPromiseOptionsPOST
Create Customer OrderSubmit customer test orders for WFS items to initiate fulfillment through Walmart’s network./v3/fulfillment/orders-fulfillmentsPOST
Cancel Customer OrderSubmit cancellation requests for eligible customer test orders prior to shipment./v3/fulfillment/orders-fulfillments/cancelPOST

Order tracking

You can use the order tracking APIs to retrieve fulfillment status updates for customer orders in the Multichannel Solutions (MCS) sandbox. These APIs simulate the order lifecycle from creation through delivery. For more details, refer to MCS order tracking APIs.

MCS APIDescriptionEndpointMethod
Get order tracking detailsView fulfillment status updates for test orders from submission through delivery./v3/fulfillment/orders-fulfillments/statusGET

Return order management

You can use the return order management APIs to create, retrieve, and cancel return orders in the Multichannel Solutions (MCS) sandbox. For more details, refer to MCS return order APIs.

MCS APIDescriptionEndpointMethod
Create return orderCreates a return order for a previously delivered order./v3/fulfillment/orders-fulfillments/return-ordersPOST
Get return ordersRetrieves return order details with the latest simulated status. /v3/fulfillment/orders-fulfillments/return-ordersGET
Cancel return orderCancels a return order before it ships./v3/fulfillment/orders-fulfillments/return-orders/(returnOrderId)/cancelPOST