취소 처리하기
취소는 주문 배송이 시작하기 전에 주문을 무효화하는 것입니다. 구매자, 판매자 둘 다 취소를 요청할 수 있어요.
구매자의 취소 요청
구매자는 주문 상품이 '결제완료', '상품준비중', '발송지연' 상태일 때 토스앱에서 취소를 요청할 수 있어요.
'결제완료' 상태에서 구매자가 취소를 요청하면 주문 상태는 즉시 '결제취소'로 변경되고 구매자는 주문금액을 환불받습니다. 판매자는 별도로 API를 호출하지 않아도 돼요.
'발송지연' 또는 '상품준비중' 상태에서 구매자가 취소를 요청하면 토스쇼핑 API로 승인 또는 거절을 할 수 있어요. 승인하면 환불과 함께 결제 취소 상태가 되고, 거절하면 주문이 바로 배송중 상태로 바뀌어요.
구매자의 취소 요청 승인 및 거절하기
'발송지연' 또는 '상품준비중' 상태에서 구매자가 요청한 취소를 승인 및 거절하는 방법을 알아볼게요.
취소 요청 확인하기
클레임 목록 조회 API로 취소 요청을 확인해주세요. type 쿼리 파라미터를 CANCEL로 설정해주세요. status 쿼리 파라미터는 항상 REQUESTED로 설정해주세요. '요청' 상태인 취소 클레임을 불러옵니다.
GET /api/v3/shopping-fep/claims?type={claimType}&status={claimStatus}'
클레임 ID로 취소 요청 승인/거절하기
응답의 success 필드 안에 items.id는 해당 클레임 요청의 유니크한 ID 값입니다. 취소 요청 승인과 취소 요청 거절 API의 쿼리 파라미터로 사용해주세요.
취소 요청을 승인하려면 클레임 ID Path 파라미터만 채워서 API를 호출해주세요. POST
/api/v3/shopping-fep/claims/{claimId}/cancel/approval취소 요청을 거절하려면 클레임 ID Path 파라미터와 택배사 및 송장번호 요청 파라미터를 추가해서 API를 호출해주세요. POST
/api/v3/shopping-fep/claims/{claimId}/cancel/rejection
직접 주문 취소하기
판매자가 직접 주문을 취소할 수도 있어요. 판매자는 결제완료, 상품준비중, 발송지연, 배송중, 배송완료 상태의 주문을 취소할 수 있습니다.
판매자가 요청한 취소의 주문 상태는 즉시 '결제취소'로 바뀌어요
클레임 진행 중인 주문도 취소가 가능하며, 취소 후 마찬가지로 '결제취소' 상태로 바뀝니다.
주문내역 조회하기
주문 내역 조회 API로 취소하고 싶은 주문의 ID(orderProductId)를 확인해주세요.
GET /api/v3/shopping-fep/orders/v2?startDate={yyyy-MM-dd}&endDate={yyyy-MM-dd}'
주문 ID로 취소하기
응답의 success 필드 안에 results.orderProductId를 판매자 주문 취소 API의 Path 파라미터로 사용해주세요. 요청 파라미터에는 배송비 부담하는 책임자와 취소 사유를 입력해주세요.
POST /api/v3/shopping-fep/order-products/{orderProductId}/seller-cancel
Last updated