Miravia Open Platform
Miravia - Return and Refund API Instruction
Reverse OpenAPIs provides capability for seller to receive notification of reverse orders, check the reverse order details and handle/update the reverse orders.
Reverse Flow
Refund Only request
Return request
Note:
(1) *"forward to agent" option shall be applicable under certain return reason:
- Damaged product and shipping box
- Item damaged but packaging intact
- The package has not received
- Estimated delivery date missed
(2) for own shipping returns, seller needs to manually confirms delivery through API ReverseOrderReturnUpdate
API summary and sample scenarios to use
| # |
Scenario |
API |
| 1 |
Reverse order updates (only covers important status), including customer initiates return/refund only request, customer cancels return request, return package collected by courier, return package delivered etc. |
Push API for Reverse Order |
| 2 |
Check reverse order details, including using trade order id, reverse order id, tracking number to check (can also restrict time range). Details such as refund amount, sku information (e.g. ean number), return reason etc. |
GetReverseOrdersForSeller |
| 3.1 |
When buyer initiates return/refund request, seller needs to take actions (can refer to the flow chart) on it, for example, agree return, agree refund, or reject; |
ReverseOrderReturnUpdate |
| 3.2 |
When seller approves the return, and package returned back to seller's warehouse, seller needs to do quality check (QC) and takes action on the return request, for example, agree refund or reject refund |
ReverseOrderReturnUpdate |
| 3.3 |
When a return is own shipping (shipping_type = customer_send), seller needs to manually confirm delivery using API to continue to take further actions on the return |
ReverseOrderReturnUpdate |
| 4 |
When seller wants to reject the return/refund request, seller can check the rejection reason list |
GetReverseOrderReasonList |
