Pricing and promotional pricing management (New)

At Walmart, we strive to ensure a fair and positive shopping experience. To maintain this, we use automated rules to identify and remove offers that are highly uncompetitive or unfairly priced. Adhering to our pricing guidelines and policies is essential. Non-compliance may result in account review, suspension, or termination. For more details, refer to Pricing rules.

The Walmart Marketplace Pricing API Guide provides comprehensive instructions, best practices, and recommendations for managing and updating the pricing of your products on Walmart Marketplace. This guide is intended for sellers, developers, and business partners who are looking to integrate or manage their product prices on Walmart Marketplace.

Walmart’s Every Day Low Price (EDLP) strategy guarantees that consumers benefit from consistently low prices. The Marketplace Pricing API solves the problem of efficiently managing and updating product prices on Walmart Marketplace. The Pricing API plays a key role in the Marketplace ecosystem and the seller journey by ensuring product pricing is competitive, accurate, and up-to-date. Its key features include:

Retrieve current prices
Update prices in real-time
Manage promotional prices
Perform bulk price updates
Implement dynamic pricing strategies

For information on authentication and access to get started with marketplace, see Getting started and OAuth 2.0 authorization.

Pricing and Promotional Rules

Price is a fundamental aspect for your listing. You can use the Price and Promotional Price management APIs to set and manage the price and promotional price for an item.

When setting up promotions, ensure to comply with the following rules:

An item can have a maximum of 10 promotions.
The effective start date for a promotion must be at least four hours after the current date and time.
You cannot cancel a promotion within four hours of its scheduled start time. If an item is part of a promotion group, you may cancel its promotion after the promotion has started. While individual items can be removed from a promotion group, the entire promotion group itself cannot be deleted.
A promotion end date cannot be before or equal to the promotion start date.
The end date of a given promotion should be within 180 days from the start date and time. Any promotions beyond 180 days will result in an error.
If a promotion’s start and end dates overlap with other promotions for the same item, it will result in an error.

When setting up price and/or promotional pricing, you must provide the following information:

Name	Description	Type	Required	Default
sku	The Stock Keeping Unit (SKU) of an item for which the price/promotion needs to be setup or update.	String	Yes	N/A
price	The price a customer pays for the product.	Double	No	N/A
msrp	The Manufacturer's Suggested Retail Price (MSRP) for the SKU. After you submit the MSRP, the price is substantiated and used for strikethrough pricing calculation.	Double	No	N/A
promoid	Promotion ID is required to update the existing promotion information.	String	No	N/A
promotionSettingAction	You can select: - Create is used to set up a promotion. To create a promotion, enter the Promo Price, Promo Price Start Date, and Promo Price End Date. - Delete is used to delete an existing promotion. To delete a promotion, enter the exact Promo Price Start Dat and Promo Price End Date, which matches with the existing promotion. (Note: You can review existing promotions using the promotions report). - Replace All serves two main purposes: - Deletes All existing promotions: Use Replace All to delete all existing promotions. - Replaces All existing promotions and create new promotions at the same time.	String	Yes For setting up promotions	N/A
promotionPlacement	Use MAP Cart to hide the price until customers clicks Add to cart during checkout.	String	No	N/A
promotionType	Select: - Reduced for temporary price reduction which lasts for a minimum of 14 days (For instance, during special merchandising events on walmart.com). - Clearance if an item has either reached end of its lifecycle or is being liquidated.	String	No	N/A
promotionPrice	Promotion price that you want to set for the SKU. This is a mandatory field for creating new promotions.	Double	Yes For creating new promotions	N/A
promotionPriceStartDateTime	The effective start date for a given promotion. Time should be specified in the UTC format.	String	Yes For creating new promotions/deleting existing promotions	N/A
promotionPriceEndDateTime	The effective end date for a given promotion. Time should be specified in the UTC format.	String	Yes For creating new promotions/deleting existing promotions	N/A

For more information about the promotional pricing, refer to Promotional pricing: Overview .

Reference guide

This guide explains how to use the Pricing API with practical examples and step-by-step instructions to integrate price management into your solution. For full technical details, including endpoints, parameters, and brief descriptions, refer to the Walmart Pricing API reference.

Prerequisites

Complete the following prerequisites before integrating the Pricing APIs:

Create a seller account on Walmart Marketplace.
- If you are a seller, refer to the Getting Started Guide for Sellers.
- If you are a solution provider, refer to the Getting Started Guide for Solution Providers.
OAuth 2.0 authentication is required to access the Walmart Marketplace APIs. Ensure that you have obtained the necessary credentials and tokens before making API requests. For more information, refer to OAuth 2.0 authorization.

Commonly used terms

The following table lists the frequently used terms and their descriptions.

Terms	Description
Price Sequence Guarantee	Ensures that price changes are implemented in the correct order or sequence.
CAP (Ceiling Price)	A strategy that sets an upper limit for the price of a product.
Incentives	Special pricing offers or discounts applied to a product.
Price Update	A request to change the current price of a product.
Bulk Pricing	Adjusting prices for multiple products at once, typically done through a batch API request.
SKU (Stock Keeping Unit)	A unique identifier for each product that helps track inventory and pricing.
Price Override	A manual adjustment to the standard pricing rules for a product.
Repricer	Automatically adjust product prices based on certain strategies or rules.
Repricing Strategy	A set of rules and conditions used by the repricer to determine when and how prices should change.
Strategy Rules	Conditions within a repricing strategy dictate when and how the price should change.
Dynamic Pricing	Adjusting product prices in real-time based on demand, competition, and other factors.

Market availability

The Walmart Pricing API is available for sellers listing on Walmart marketplaces in Canada, Chile, Mexico, and the U.S.

JSON schema files

Use the following link to download the Price Management XSDs.

Price&PromotionJSON.zip

The price sequence guarantee is enforced for both synchronous (individual) and asynchronous (bulk or feed) updates. Each method has different SLAs, so there is no assurance that price updates will be received in a specific order.

The price sequence guarantee ensures that the latest price update, based on its creation timestamp, is the one that changes the price of the item, overwriting the previous version. We recommend that all feed-based bulk updates use the value of feedDate based on UTC.

Next steps

Explore the Marketplace Pricing API endpoints to seamlessly integrate efficient price management into your solution. Use the available endpoints to update, monitor, and optimize pricing strategies for your products on Walmart Marketplace.