Returns and Refunds API Overview
Returns can be initiated from Walmart.com, even for items purchased from Marketplace sellers (except for HAZMAT or FREIGHT items). Previously, customers had to contact the sellers directly.
Returns status
The return status at the return order line are listed below including the status mapping to the more detailed eventTag in the returnTrackingDetail object.
| Return status | Description |
|---|---|
| INITIATED | The return has been initiated by the customer |
| COMPLETED | The refund has been initiated |
| CANCELLED | The return has been cancelled before completion |
Refunds
Use the Refunds API to process refunds for one or more order lines that have been shipped. The response to a successful call contains the order with the refunded line item.
You can only refund an order line that has a status of Shipped.
The value for the amount element in the refund must be negative. The magnitude of the amount specified as the refund cannot be greater than the original amount that was charged for the line.
WFS Returns
Returns of Walmart fulfilled orders can be fetched using the GET All Returns API by adding the parameter isWFSEnabled=Y.
Note: WFS returns are view only and cannot be updated by sellers.
Updated about 1 month ago