Choose an Returns API

The Walmart Marketplace Returns API can be integrated in various ways. A common approach is:

Retrieve return orders
Issue refunds
(Optional) Process return overrides

Retrieve return orders

Start by fetching return orders to see which items are pending review. This provides an up-to-date snapshot of all return activities, helping you identify which returns are eligible for refunds.

Learn more about retrieving return orders

Issue refunds

For return orders that meet your criteria, issue full or partial refunds to complete the return process. Issuing refunds immediately after reviewing returns ensures that customers receive timely reimbursement.

Learn more about issuing refunds

(Optional) Process return overrides

You can use the Bulk item override feed to update item-level return rules at any time, whether as part of your initial configuration or as periodic updates. This allows you to customize settings for individual items, overriding the global return rules set in Seller Center.

Learn more about processing return overrides