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 sellers directly.
Download the Returns APIs JSON Schema from the: MPReturnsJsonSchema.zip
Returns status
The return status at the return order line is listed below including the “status” mapping to the more detailed “eventTag” in the returnTrackingDetail object.
The following statuses are available for the U.S. market:
| Return Status | Event Tags | Description |
|---|---|---|
| INITIATED | RETURN_INITIATED | The return has been initiated by the customer. |
| INITIATED | RETURN_IN_TRANSIT | The initiated return is in transit. |
| DELIVERED | DELIVERED_AT_RETURN_CENTER | The return has been delivered to the Return Center. |
| COMPLETED | REFUND_INITIATED | The refund has been initiated. |
| COMPLETED | REFUND_ISSUED | The return has been invoiced and the customer notified. |
| COMPLETED | RETURN_CANCELLED | The return has been cancelled before completion. |
| COMPLETED | INTRANSIT_AFTER_INVOICE | The refund has been issued and the return is in transit. |
| COMPLETED | DELIVERED_AFTER_INVOICE | The refund has been issued and the return is delivered to the Return Center. |
The following statuses are available for the Canada market:
| Return Status | Description |
|---|---|
| COMPLETED | The refund has been initiated. |
| CANCELLED | The return has been cancelled before completion. |
The following statuses are available for the Mexico market:
| 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. |
The following statuses are available for the Chile market:
| 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. |
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.
For WFS Returns
Returns of Walmart fulfilled orders can be fetched using the GET All Returns API by adding the parameter is WFSEnabled=Y.
Note: WFS returns are view only and cannot be updated by sellers.