Returns

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. For more details, see the announcement for Marketplace Returns Program. 

Download the Returns APIs JSON Schema from:

 MPReturnsJsonSchema.zip

Returns Status

The return status at the return order line are listed below including the “status” mapping to the more detailed “eventTag” in 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 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.

To issue a refund against a return order, use the Issue Refund API. Multiple return order lines can be refunded in one request.

Specific Refund Adjustments

To make refund adjustments, use the Order Refund API, Refund Order Lines.

If the seller needs to determine the refund amount, it is better to use Refund Order Lines API to make a specific adjustment. For example, for items that will not be part of the Marketplace Returns Program, such as Hazmat and Freight items.

Refunds Errors

When you initiate a return, you might see some errors. For system errors, the code is concatenated with the the API that was being invoked at the time of the error.

Data or System Code	Description	Type
400	Invalid request. One or more mandatory fields are missing.	Data Error
400	Requested quantity is not available. Please check if there is refundable quantity.	Data Error
400	The return order number is not valid	Data Error
400	Return Order has more than 1 line. Please specify ReturnOrderLineNumber to be refunded.	Data Error
500	Unexpected error occurred. Please try again or contact support.	Data Error
500	We are not able to perform this operation at this time. Please try again or contact support.	Data Error

In general, if any “500” errors occur, retry. For ‘400’ errors, try to fix the input data.