coupang
API 문서
상품 API카테고리 API브랜드 API배송 / 주문 API반품 API교환 API프로모션 / 쿠폰물류 정보고객 문의정산CGF / CGF liteRocket Growth
PATCH/v2/providers/openapi/apis/api/v4/vendors/{vendorId}/returnRequests/{receiptId}/approval2609170000

반품요청 승인 처리

KRTW
# 01

요약

반품요청 승인 처리

# 02

상세

API 적용 가능한 구매자 사용자 지역: 한국, 대만

반품요청 목록조회 시 receiptStatus가 입고완료(VENDOR_WAREHOUSE_CONFIRM)인 반품 건에 대해 처리 가능합니다.

[반품 상품 입고 확인 처리] 후, [반품 요청 승인 처리]를 진행하시면 환불 처리됩니다.
선환불(빠른환불) 정책에 의해 환불처리되거나, 입고확인이 완료된 반품 건의 경우 일정 시간 경과 후 쿠팡시스템에 의해 반품이 승인 처리됩니다. 이 경우에는 해당 API 호출이 불필요합니다.

*반품 API Workflow를 확인하시면, 보다 쉽게 이해하실 수 있습니다.

경로

PATCH/v2/providers/openapi/apis/api/v4/vendors/{vendorId}/returnRequests/{receiptId}/approval

예시 엔드포인트

https://api-gateway.coupang.com/v2/providers/openapi/apis/api/v4/vendors/A00013264/returnRequests/363585/approval

URL API Name

APPROVE_RETURN_REQUEST_BY_RECEIPT
# 03

Path 파라미터

NameTypeDescription
vendorId*object
업체코드
receiptId*object
반품접수번호
ReceiptId는 반품요청 목록 조회API를 통해 확인가능합니다.
ReceiptId는 반드시 number타입이어야 합니다.
# 04

요청 본문

요청 파라미터

본문 파라미터

NameTypeDescription
vendorId*string
업체코드
receiptId*integer
반품접수번호
cancelCount*integer
반품접수 수량
요청 예시application/json
{
  "vendorId": "A00013264",
  "receiptId": 363585,
  "cancelCount": 1
}
# 05

응답 본문

응답 메시지

NameTypeDescription
codestring
server response status code
messagestring
성공 혹은 실패시 해당 결과메시지가 나타남
dataobject

Response Example

{
  "code": "200",
  "message": "OK"
}
# 06

에러 코드

HTTP코드메시지
400HTTP_400Bad Request

오류 사양

HTTP유형오류 메시지해결 방법
400400 (요청변수확인)

취소반품접수내역이 존재하지 않습니다.

접수된 반품내역이 고객 또는 상담사에 의해 철회되었거나 잘못된 접수번호를 입력할 경우 발생합니다. 반품철회 이력 API로 반품철회이력이 있는지 확인합니다.

400400 (반품상태확인)

이미 반품이 완료 되었습니다.

반품요청 단건조회 API로 접수번호(receiptId)의 반품상태가 완료인지 확인합니다. 빠른환불 또는 회수 트래킹 정보에 의해 반품완료된 경우 더 이상 중복 승인처리하지 않도록 조치합니다.

400400 (요청변수확인)

취소반품접수수량과 cancelCount가 일치하지 않습니다.

올바른 반품접수수량을 입력했는지 확인합니다. 접수된 반품접수 수량과 입력한 cancelCount 수량이 일치하지 않을 경우 에러가 발생합니다.

500500 (반품상태확인)

환불 승인(대기)/접수철회 요청된 쿠폰의 상태가 승인 할 수 없는 상태이거나 수량이 맞지 않습니다.

반품요청 단건조회 API로 접수번호(receiptId)의 반품상태가 완료인지 확인합니다. 빠른환불 또는 회수 트래킹 정보에 의해 반품완료된 경우 더 이상 중복 승인처리하지 않도록 조치합니다.