반품요청 목록조회 시 receiptStatus가 입고완료(VENDOR_WAREHOUSE_CONFIRM)인 반품 건에 대해 처리 가능합니다.
[반품 상품 입고 확인 처리] 후, [반품 요청 승인 처리]를 진행하시면 환불 처리됩니다.
선환불(빠른환불) 정책에 의해 환불처리되거나, 입고확인이 완료된 반품 건의 경우 일정 시간 경과 후 쿠팡시스템에 의해 반품이 승인 처리됩니다. 이 경우에는 해당 API 호출이 불필요합니다.
선환불(빠른환불) 정책에 의해 환불처리되거나, 입고확인이 완료된 반품 건의 경우 일정 시간 경과 후 쿠팡시스템에 의해 반품이 승인 처리됩니다. 이 경우에는 해당 API 호출이 불필요합니다.
*반품 API Workflow를 확인하시면, 보다 쉽게 이해하실 수 있습니다.
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 |
업체코드
|
|||||
| receiptId | O |
반품접수번호
ReceiptId는 반품요청 목록 조회API를 통해 확인가능합니다.
ReceiptId는 반드시 number타입이어야 합니다.
|
|||||
Body Parameter
| Name | Required | Type | Description | ||||
|---|---|---|---|---|---|---|---|
| vendorId | O | String |
업체코드
|
||||
| receiptId | O | Number |
반품접수번호
|
||||
| cancelCount | O | Number |
반품접수 수량
|
||||
Request Example
{
"vendorId": "A00013264",
"receiptId": 363585,
"cancelCount": 1
}Response Message
| Name | Type | Description | ||||
|---|---|---|---|---|---|---|
| code | Number |
server response status code
|
||||
| message | String |
성공 혹은 실패시 해당 결과메시지가 나타남
|
||||
| data | Object |
|
||||
Response Example
{
"code": "200",
"message": "OK"
}Error Spec
| HTTP 상태 코드 (오류 유형) | 오류 메시지 | 해결 방법 |
|---|---|---|
| 400 (요청변수확인) | 취소반품접수내역이 존재하지 않습니다. | 접수된 반품내역이 고객 또는 상담사에 의해 철회되었거나 잘못된 접수번호를 입력할 경우 발생합니다. 반품철회 이력 API로 반품철회이력이 있는지 확인합니다. |
| 400 (반품상태확인) | 이미 반품이 완료 되었습니다. | 반품요청 단건조회 API로 접수번호(receiptId)의 반품상태가 완료인지 확인합니다. 빠른환불 또는 회수 트래킹 정보에 의해 반품완료된 경우 더 이상 중복 승인처리하지 않도록 조치합니다. |
| 400 (요청변수확인) | 취소반품접수수량과 cancelCount가 일치하지 않습니다. | 올바른 반품접수수량을 입력했는지 확인합니다. 접수된 반품접수 수량과 입력한 cancelCount 수량이 일치하지 않을 경우 에러가 발생합니다. |
| 500 (반품상태확인) | 환불 승인(대기)/접수철회 요청된 쿠폰의 상태가 승인 할 수 없는 상태이거나 수량이 맞지 않습니다. | 반품요청 단건조회 API로 접수번호(receiptId)의 반품상태가 완료인지 확인합니다. 빠른환불 또는 회수 트래킹 정보에 의해 반품완료된 경우 더 이상 중복 승인처리하지 않도록 조치합니다. |
URL API Name
APPROVE_RETURN_REQUEST_BY_RECEIPT