Price incentives API overview

At Walmart, we are committed to helping people save money so that they can live better. To help customers find competitive prices on Walmart.com, Walmart may incentivize sellers on eligible Marketplace items through two types of price incentives: a) Walmart-funded and b) Reduced Referral fee incentives. The two incentive-types are described below:

Walmart-funded incentives: Items eligible for this incentive type may be displayed on Walmart Marketplace with an adjusted, lower price because of a Walmart Funded adjustment. Although the price displayed and charged to the customer will be lower than the price submitted by you as the seller of the item, you will continue to receive the same overall net payment as if the item’s price wasn’t adjusted. The program does not affect the shipping fee; customers will continued to be shown and charged the full shipping fee as designated by you. 

Example: An item’s price is submitted by the seller as $10 but the price displayed on site and charged to the customer is $9. To keep the seller’s payout same as earlier, Walmart will apply an incentive amount of $1 in net payment to the seller. 

Reduced Referral Fee – These referral fee incentives are periodically created and need to be explicitly enrolled to become effective. Once enrolled, your item price is adjusted to the suggested Target price and a reduced referral fee is applied on any orders thereafter until the expiration date of the incentive. While the incentive is active, if you keep the price at or below the target price, a reduced referral fee will be applied. If you increase the item price above the suggested target value, the reduced referral fee will NOT be applied, and the standard referral fee will be applied instead. After an item’s incentivized price expires, the item price will not be automatically restored to your originally set price. You may choose to update the item price at your own discretion.

Example: Your item price is listed at $100 with free shipping. The standard referral fee for the item is 15%. The original payout per item sold is $85 i.e., ($100- $15). The target price for the incentive is $90 and reduced fee is 7%. Once you enroll in the incentive, your price will automatically adjust to $90 and a reduced referral fee of 7% will be applicable. Your new payout would be $90 – ($90 * 7%) i.e., $82.8.

Price Incentives API

A seller can use the following Incentive end-points to enroll, unenroll, and manage both types of incentives. 

GET INCENTIVE ITEMS:

Get Incentive Items API endpoint gives you the list of all price incentives for items in your catalog. The details include Item Id, Product Name, Product Url, SKU Id, Target Price, current Price, Incentive Type, Base referral fee, Reduced Referral Fee, Enrollment Type, Inventory count, Enrollment Date (epoch Timestamp), Expiration date (epoch Timestamp), and Incentive Status.

WALMART FUNDED INCENTIVES ENROLLMENT:

While all Walmart-funded incentives are auto-enrolled by default, you can use this API endpoint to ‘Opt-out’ specific Walmart-funded items whose price you don’t wish to lower. You can also ‘Opt-in’ items which were previously Opted-out by you at any time using this API.

WALMART FUNDED PROGRAM PREFERENCE:

If you wish to permanently disable Walmart-funded incentives for all items of your catalog, you can use this API to set the Walmart-funded incentives program as OFF. The default value of this variable is ON. Any changes to preferences will lock in (disable) the preference option for a period of 4 hours as indicated by isDisabled response field of the API. 

REDUCED REFERRAL FEE INCENTIVE ENROLLMENT:

You can use this API endpoint to enroll any eligible reduced referral fee incentive and unenroll any active reduced referral fee incentives.