You can process the return request for the products at status of Vendor_Warehouse_Confirm when running a query on the list of return requests.
You can process return by taking [Vendor_Warehouse_Confirm] and [Approve return request] in sequence.
The products processed for return by Pre-refund(fast refund) policy or confirmed for their receipt in vendor warehouse, get their return approved by Coupang system after some time. You need to call an API to do this work.
The products processed for return by Pre-refund(fast refund) policy or confirmed for their receipt in vendor warehouse, get their return approved by Coupang system after some time. You need to call an API to do this work.
*Return API Workflow can help you understand the process easily.
Path
PATCH PUT/v2/providers/openapi/apis/api/v4/vendors/{vendorId}/returnRequests/{receiptId}/approval
Example Endpoint
https://api-gateway.coupang.com/v2/providers/openapi/apis/api/v4/vendors/A00013264/returnRequests/363585/approvalRequest Parameters
Path Segment Parameter
| Name | Required | Type | Description | ||||
|---|---|---|---|---|---|---|---|
| vendorId | O |
Vendor code
|
|||||
| receiptId | O |
Return receipt Id
ReceiptId can be confirmed via 'Return request list query' API.
ReceiptId should be entered in numbers.
|
|||||
Body Parameter
| Name | Required | Type | Description | ||||
|---|---|---|---|---|---|---|---|
| vendorId | O | String |
Vendor code
|
||||
| receiptId | O | Number |
Return receipt number
|
||||
| cancelCount | O | Number |
Return quantity
|
||||
Request Example
{
"vendorId": "A00013264",
"receiptId": 363585,
"cancelCount": 1
}Response Message
| Name | Type | Description | ||||
|---|---|---|---|---|---|---|
| code | Number |
server response status code
|
||||
| message | String |
Result(success or fail) message pops up
|
||||
| data | Object |
|
||||
Response Example
{
"code": "200",
"message": "OK"
}Error Spec
| HTTP status code (Error type) | Error message | Solution |
|---|---|---|
| 400 (Check requested parameter) | There is no history on order cancel receipt. | The return request is withdrawn by either the customer or CS rep, or the wrong receipt number is entered. You can search for a record on return withdrawal via 'Return withdrawal history' API. |
| 400 (Check return status) | The product is already returned. | You can check if the product is 'return completed' by entering its receipt Id into 'Return request single product query' API. Make sure that the request is not processed twice once the product is confirmed 'returned' based on 'Fast return' or Retrieval tracking information. |
| 400 (Check requested parameter) | Cancel/return receipt count doesn't match cancel count. | Check return receipt count for its correctness. An error occurs when the return receipt count doesn't match cancel count. |
| 500 (Check return status) | Refund approval (waiting)/reception of the requested coupon is in a state that cannot be approved or the quantity is incorrect. | You can check if the product is 'return completed' by entering its receipt Id into 'Return request single product query' API. Make sure that the request is not processed twice once the product is confirmed 'returned' based on 'Fast return' or Retrieval tracking information. |
URL API Name
APPROVE_RETURN_REQUEST_BY_RECEIPT