Pricing & promotions
How can I set up promotions?
Use the Price Management and Promotional Price APIs to create and manage promotions for items on Walmart.com.For more information, refer to the following resources:
Can an item be enrolled in both the Referral-Reduced Fee and Walmart-funded incentive programs at the same time?
No. An item can only be enrolled in one incentive program at a time.
Can an item be switched from one incentive program to another?
Yes. An item can be switched between programs, provided the item is included in the recommended items list.
If I submit a price update, promotion update, or combined price and promotion feed for an item enrolled in an incentive program, will it affect the item’s reduced price or enrollment status?
No. Submitting price updates, promotion updates, or combined price and promotion feeds does not affect the item’s enrollment status or the reduced price associated with either incentive program.
What happens to an item’s price when it is unenrolled from a program?
When an item is unenrolled from a pricing incentive program, the resulting item price depends on the type of incentive program:
- Reduced Referral Fee (RRF) incentives: The item price remains at the reduced price after the item is unenrolled from the program.
- Walmart-funded incentives: The seller-submitted price from before enrollment is automatically restored when the item is unenrolled from the program.
What is the best way to determine whether an item has been enrolled in or unenrolled from an incentive program?
Use the retrieve price incentives data API endpoint:GET /v3/price/incentives
This endpoint provides the current enrollment status of items participating in incentive programs. For more details, refer to the Marketplace pricing API reference.
How quickly is the data in the retrieve price incentives API updated?
The data returned by the retrieve price incentives API is updated in real time.
Is there a limit to how many items can be eligible for or enrolled in these incentive programs?
No. There is no limit to the number of items that can participate in either incentive program.
Are there any limitations when retrieving incentive program status for large catalogs?
The retrieve price incentives API provides the current enrollment status of items participating in incentive programs. It currently supports:
- A rate limit of 60 requests per hour
- Up to 200 items per request
Large catalogs may require batching requests accordingly. However, there is no limit to the number of eligible or enrolled items.