Getting Started

Follow these steps to set up and begin testing in the Walmart Multichannel Solutions (MCS) sandbox environment.

  1. Obtain sandbox credentials
  • Request sandbox credentials as a seller or solution provider. Refer to Get sandbox credentials in the Walmart Developer Portal.
  • Ensure your application has access to MCS APIs included in its API scope.
  1. Set up a test sales channel

Create a test channel using the endpoint POST https://sandbox.walmartapis.com/v3/fulfillment/orders-fulfillments/channel-details.

After you create a test channel, if you want to update the channel configuration use the endpoint PUT https://sandbox.walmartapis.com/v3/fulfillment/orders-fulfillments/channel-details.

  1. Create test items

Create mock items in your sandbox catalog using the endpoint POST https://sandbox.walmartapis.com/v3/fulfillment/mcs/item. These mock items can be used to test MCS orders.

  1. Simulate orders and tracking

Test the end-to-end flow by placing and tracking mock orders.

Create test orders using the endpoint POST https://sandbox.walmartapis.com/v3/fulfillment/orders-fulfillments .

Check order status using the endpointGET https://sandbox.walmartapis.com/v3/fulfillment/orders-fulfillments/status.

Pre-configuration requirements

Before simulating orders, make sure that the following configurations are complete.

TaskAPI endpointDescription
Create itemsPOST https://sandbox.walmartapis.com/v3/fulfillment/mcs/item Adds mock items required for order creation.
Create sales channel(s)POST https://sandbox.walmartapis.com/v3/fulfillment/orders-fulfillments/channel-details Defines the sales channels to be used for testing orders
Update sales channel(s)`PUT https://sandbox.walmartapis.com/v3/fulfillment/orders-fulfillments/channel-detailsUpdates the sales channels to be used for testing orders
Set required headersmartId, buIdHeaders required by some MCS APIs.
Omit orgIdDo not include this field as seller context is derived internally.