This page details the necessary API calls for retrieving and processing return orders if your shop operates under a Direct Return model.
The Marketplace Direct Returns model allows Marketplace Sellers to have returns from customers shipped directly back to the Seller’s warehouse to be processed by the seller rather than via THE ICONIC’s fulfilment centre.
Retrieve return order
To retrieve orders, you can use the GET /v2/orders call.
An order that is ready for return processing will be in either return_shipped_by_customer or return_delivered status.
Receive return order
This is to indicate that the order has been returned to the seller's warehouse, has been received, and is now awaiting processing.
Orders are only eligible to be processed as return received, if the order status is
either in return_shipped_by_customer or return_delivered status.
| Call | POST /v2/orders/statuses/set-to-return-received |
| Required in the request | Order item id |
| Outcome |
Order item status will change to "return_waiting_for_approval" (UI will show status "Received") |
Approve return order
This is to indicate that the order has successfully passed seller's quality control processing and has been approved for return by the seller.
Orders are only eligible to be processed as return approved, if the order status is in return_waiting_for_approval status.
| Call | POST /v2/orders/statuses/set-to-return-approved |
| Required in the request | Order item id |
| Outcome |
Order item status will change to "returned" (UI will show status "Returned") |
Reject return order
To reject return order, please reach out to Seller Help Desk
Flow chart