Specific items: Manage Walmart-funded incentives enrollment

Call this endpoint to manage the enrollment status of specific items in the Walmart-funded incentives program. By default, all items are auto-enrolled in Walmart-funded incentives, meaning that eligible items are automatically included in this program to benefit from price reductions funded by Walmart.

You have the flexibility to modify the enrollment status for specific items using the API:

Opt-Out - Use this option to opt-out of Walmart-funded incentives for specific items for which you do not want to lower the price.
Opt-in - Use this option to opt-in items that were previously opted-out from Walmart funded incentives. For instance, you can re-enroll items in Walmart-funded incentives programs at any time depending on your business needs.

Note: This page describes an example using only the required parameters and inputs to modify the enrollment status of specific items in Walmart-funded incentives. For a full list of customization options and additional capabilities, refer to the Marketplace Pricing API Reference.

Endpoint

POST https://marketplace.walmartapis.com/v3/feeds?feedType=WALMART_FUNDED_INCENTIVES_ENROLLMENT

Sample request

The sample request includes headers for authentication and identification, along with a details of items and their desired Walmart-funded incentives program enrollment actions. In this example, the item with SKU SKU-Item is being opted into the Walmart-funded incentives program.

curl --request POST \ --url 'https://marketplace.walmartapis.com/v3/feeds?feedType=WALMART_FUNDED_INCENTIVES_ENROLLMENT' \ --header 'WM_QOS.CORRELATION_ID: abcd1234-0ab1-2cd3-4ef5-0123456789ab' \ --header 'WM_SEC.ACCESS_TOKEN: <Base64EncodedConsumerKey:ConsumerSecret>' \ --header 'WM_SVC.NAME: Walmart Service Name' \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data '
{ "ProgramActionFeedHeader": { "requestId": "0a90b332-1f92-40f4-afb1-92301f5d828e", "requestBatchId": "0a90b332-1f92-40f4-afb1-92301f5d828e", "processMode": "REPLACE", "subset": "EXTERNAL", "sellingChannel": "online", "version": "5.0.20240805-15_25_31", "locale": "en", "feedDate": "2024-07-11T00:29:58Z", "feedType": "PROGRAM_ACTIONS" }, "ProgramAction": [ { "ItemIdentifiers": { "sku": "SKU-Item" }, "Programs": { "WalmartFundedIncentivesEnrollment": { "walmartFundedIncentivesEnrollment": "Opt-in" } } } ]
}
'

import requests url = 'https://marketplace.walmartapis.com/v3/feeds?feedType=WALMART_FUNDED_INCENTIVES_ENROLLMENT'
headers = { 'WM_QOS.CORRELATION_ID': 'abcd1234-0ab1-2cd3-4ef5-0123456789ab', 'WM_SEC.ACCESS_TOKEN': '<Base64EncodedConsumerKey:ConsumerSecret>', 'WM_SVC.NAME': 'Walmart Service Name', 'accept': 'application/json', 'content-type': 'application/json'
}
data = { "ProgramActionFeedHeader": { "requestId": "0a90b332-1f92-40f4-afb1-92301f5d828e", "requestBatchId": "0a90b332-1f92-40f4-afb1-92301f5d828e", "processMode": "REPLACE", "subset": "EXTERNAL", "sellingChannel": "online", "version": "5.0.20240805-15_25_31", "locale": "en", "feedDate": "2024-07-11T00:29:58Z", "feedType": "PROGRAM_ACTIONS" }, "ProgramAction": [ { "ItemIdentifiers": { "sku": "SKU-Item" }, "Programs": { "WalmartFundedIncentivesEnrollment": { "walmartFundedIncentivesEnrollment": "Opt-in" } } } ]
} response = requests.post(url, headers=headers, json=data) print(response.status_code)
print(response.json())

Modify your code

Use a unique WM_QOS.CORRELATION_ID for each request.
Replace <Base64EncodedConsumerKey:ConsumerSecret> with your our Base64-encoded client ID and client secret pair.
Replace SKU_Item with the actual SKU of an item.

Sample response

The response confirms that the feed submission was processed successfully, and the item was opted into the Walmart-funded incentives program.

{ "feedId": "14066B6642344B76A8B77AC094F8C63B@AVMBAgA"
}

Result

If successful, the API response returns a feedID.

You can use this feed ID with the Feed Status API or All Feed Statuses API to monitor the progress of your submission and see the line-item status.