Imweb
Search
⌃K

반품 처리

patch
https://api.imweb.me/v2/shop
/orders/{주문번호}/return/{상태}

처리가능 상태 설명

항목
설명
reject
반품 거부
반품요청 주문에 대해 반품 거부하거나 교환으로 변경합니다.
accept
수거지시
운송업체에게 반품상품 수거를 지시(요청)한 경우 처리해주세요.
collect_done
반품수거 완료
수거중인 상품을 수거완료 처리합니다.
withhold
반품보류
구매자에게 반품 배송비 또는 기타 반품 추가 비용을 청구해야 하거나 반품이 불가할 때 사용합니다.(네이버페이 용)
releasehold
반품 보류 해제
반품 보류 사유가 해결되어 반품 진행이 계속 가능할 때 사용합니다.(네이버페이 용)
return_done
반품완료 처리
수거가 확인된 반품 상품의 환불 처리를 진행하며 구매자에게 추가 비용 청구를 할 수 있습니다.
주의: 자동환불이 불가능한 주문건은 '자동환불불가' 오류가 발생합니다.
return_force_done
강제 반품완료 처리
환불처리실패 또는 환불진행중인 주문을 반품완료 처리합니다. 강제 반품 완료 처리는 자동환불이 지원되지 않으므로 구매자와 협의된 방법으로 환불을 별도 진행해 주셔야 합니다.

요청 데이터

항목
타입
설명
prod_order_no
String
개별/부분 처리 시 사용(선택)
etc
Array
상태별 필수 데이터
처리 상태에 맞는 추가 데이터를 전달해주세요.

응답 데이터

항목
타입
설명
success
Array
처리 성공한 주문서 번호
failed
Array
처리 실패한 주문서 목록

OrderReturnReject Data

항목
타입
설명
reason
String
거부사유

OrderReturnReturnDone Data

항목
타입
설명
etc_price
Array
기타 청구비용 목록
주의: 미입력 시 기타 비용 처리가 이루어지지 않습니다.
refund_point
Array
환불 적립금
전체 반품인 경우 사용한 적립금 전액이 자동 반영됩니다.
부분반품은 환불하실 적립금을 직접 입력하실 수 있습니다.
예: 3000 포인트를 환불하고 싶을 때-> 3000 입력 (단, 해당 주문의 잔여 적립금보다 초과하여 입력 불가)
주의: 미입력 시 적립금 환불 처리가 이루어지지 않습니다.
claim_memo
String
구매자에게 전하실 말씀

EtcPrice Data

항목
타입
설명
prod_order_no
String
품목주문번호
price
Float
기타 청구 비용

RefundPoint Data

항목
타입
설명
prod_order_no
String
품목주문번호
point
Float
환불 적립금

OrderActionFailedList Data

항목
타입
설명
order_no
String
주문번호
prod_order_list
Array
처리 실패한 품목 주문서 목록OrderActionFailedProdOrderListData

OrderActionFailedProdOrderList Data

항목
타입
설명
prod_order_no
String
품목주문번호
msg
String
실패 메세지
detail_msg
String
실패 상세메세지