반품 처리

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

처리 실패한 주문서 목록

OrderActionFailedList

OrderReturnReject Data

항목타입설명

reason

String

거부사유

OrderReturnReturnDone Data

항목타입설명

etc_price

Array

기타 청구비용 목록

주의: 미입력 시 기타 비용 처리가 이루어지지 않습니다.

EtcPriceData

refund_point

Array

환불 적립금

전체 반품인 경우 사용한 적립금 전액이 자동 반영됩니다.

부분반품은 환불하실 적립금을 직접 입력하실 수 있습니다.

예: 3000 포인트를 환불하고 싶을 때-> 3000 입력 (단, 해당 주문의 잔여 적립금보다 초과하여 입력 불가)

주의: 미입력 시 적립금 환불 처리가 이루어지지 않습니다.

RefundPointData

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

실패 상세메세지

Last updated