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.
| 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. |
Updated about 1 month ago