Miravia Open Platform
2. How to integrate a Return and refunds
API summary and sample scenarios to use
# |
API |
Scenario |
1 |
Push API for Reverse Order |
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. |
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. |
|
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; |
|
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 |
|
4 |
When seller wants to reject the return/refund request, seller can check the rejection reason list |
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
