[톡스토어] 장바구니 쿠폰 신규 적용에 따른 취소/반품 요청 및 승인 제한 케이스 안내 (시행일 24년 8월 26일) – Kakao Shopping Open API

안녕하세요. 카카오쇼핑입니다.

장바구니 쿠폰 기능이 8/26일 신규 배포될 예정임에 따라, 환불예정금액 마이너스 발생할 경우 취소/반품 요청,철회,승인 처리 불가한 신규 케이스가 발생할 수 있어 안내드립니다.

■ 적용 예정일

2024년 8월 26일(월)

■ 주요 변경 내용

- 장바구니 쿠폰 도입으로 인해 구매자 귀책으로 '부분' 취소/반품 처리 시 마이너스 환불예정금액 발생 가능해짐

- 그에 따라 원인 별 3가지 케이스에 대한 응답 실패 메시지/코드 추가

■ 영향범위

- 배송상품, 이용권/e쿠폰 취소요청 승인

- 배송상품 취소 불가 (기발송) 처리

■ 변경 상세 내용

1. 이용권/E쿠폰 판매자취소요청 시, 장바구니 쿠폰 할인으로 인한 환불예정금액 마이너스 발생할 경우 취소 요청이 불가합니다.

❐ 상세 내용

환불예정금액 마이너스 발생 조건 : 장바구니 쿠폰 적용하여 결제 후 일부 주문 부분 취소 요청 시 구매자 귀책으로 장바구니 최소 적용 조건이 깨져 구매자에게 반환할 금액이 없는 경우

마이너스 환불예정금액이 발생하는 경우, open api 로 인한 취소요청 처리가 불가합니다.

▪︎ 판매자 취소요청 불가 CASE 응답 예시

HTTP 상태코드: 200

{
  "failedOrderIds": [
    0
  ],
  "success": false
}

2. 배송상품 및 이용권 취소요청 승인 시, 장바구니 쿠폰 할인으로 인한 환불예정금액 마이너스 발생할 경우 취소 승인이 불가합니다.

❐ 상세 내용

환불예정금액 마이너스 발생 조건 : 장바구니 쿠폰 적용하여 결제 후 일부 주문 부분 취소 승인 시 장바구니 최소 적용 조건이 깨져 구매자에게 반환할 금액이 없는 경우

마이너스 환불예정금액이 발생하는 경우, open api 로 인한 취소 승인 처리가 불가합니다.

▪︎ 취소승인 불가 CASE 응답 예시

HTTP 상태코드: 406

{
  "error_message": "쿠폰 금액 및 추가/반품 배송비가 환불금액보다 크므로 승인 처리가 불가합니다. 지불방식 변경 후 다시 시도해 주세요.",
  "error_code": -33003,
  "error_category": "oms_open_api"
}

3. 배송상품 취소불가(기발송)처리 시, 장바구니 쿠폰 할인으로 인한 환불예정금액 마이너스 발생할 경우 기발송 처리가 불가합니다.

❐ 상세 내용

환불예정금액 마이너스 발생 조건 : 장바구니 쿠폰 적용하여 결제 후 일부 주문 부분 기발송 처리 시 남은 취소 요청 주문으로 인해 장바구니 최소 적용 조건이 깨져 구매자에게 반환할 금액이 없는 경우

마이너스 환불예정금액이 발생하는 경우, open api 로 인한 취소 불가(기발송) 처리가 불가합니다.

▪︎ 취소불가(기발송) 처리 불가 CASE 응답 예시

HTTP 상태코드: 400

{
  "error_message": "쿠폰 조건을 충족하지않아 일부만 발송하실 수 없습니다. 관련된 모든 취소요청들을 한번에 발송하시거나, 카카오고객센터에 문의해 주세요",
  "error_code": -22031,
  "error_category": "oms_open_api"
}

4. 배송상품 반품요청 시, 장바구니 쿠폰 할인으로 인한 환불예정금액 마이너스 발생할 경우 반품 요청이 불가합니다.

❐ 상세 내용

환불예정금액 마이너스 발생 조건 : 장바구니 쿠폰 적용하여 결제 후 일부 주문 부분 반품요청 시 장바구니 최소 적용 조건이 깨져 구매자에게 반환할 금액이 없는 경우

마이너스 환불예정금액이 발생하는 경우, open api 로 인한 반품 요청 처리가 불가합니다.

▪︎ 반품요청 불가 CASE 응답 예시

HTTP 상태코드: 400

{
  "error_message": "쿠폰 금액 및 추가/반품 배송비가 환불금액보다 크므로 반품요청 처리가 불가합니다. 지불방식 변 경후다시시도해주세요.",
  "error_code": -22028,
  "error_category": "oms_open_api"
}

5. 배송상품 반품승인 시, 장바구니 쿠폰 할인으로 인한 환불예정금액 마이너스 발생할 경우 반품 승인이 불가합니다.

❐ 상세 내용

환불예정금액 마이너스 발생 조건 : 장바구니 쿠폰 적용하여 결제 후 일부 주문 부분 반품승인 시 장바구니 최소 적용 조건이 깨져 구매자에게 반환할 금액이 없는 경우

마이너스 환불예정금액이 발생하는 경우, open api 로 인한 반품 승인이 불가합니다.

▪︎ 반품승인 불가 CASE 응답 예시

HTTP 상태코드: 406

{
  "error_message": "쿠폰 금액 및 추가/반품 배송비가 환불금액보다 크므로 승인 처리가 불가합니다. 지불방식 변경 후 다시 시도해 주세요.",
  "error_code": -33003,
  "error_category": "oms_open_api"
}

6. 배송상품 반품철회 시, 장바구니 쿠폰 할인으로 인한 환불예정금액 마이너스 발생할 경우 반품철회 처리가 불가합니다.

❐ 상세 내용

환불예정금액 마이너스 발생 조건 : 장바구니 쿠폰 적용하여 결제 후 일부 주문 부분 반품 철회 시 남은 반품 요청 주문으로 인해 장바구니 최소 적용 조건이 깨져 구매자에게 반환할 금액이 없는 경우

마이너스 환불예정금액이 발생하는 경우, open api 로 인한 반품철회 처리가 불가합니다.

▪︎ 반품철회 불가 CASE 응답 예시

HTTP 상태코드: 400

{
  "error_message": "쿠폰 조건을 충족하지않아 일부만 철회하실 수 없습니다. 관련된 모든 반품요청들을 한번에 철회하시거나, 카카오고객센터에 문의해 주세요",
  "error_code": -22031,
  "error_category": "oms_open_api"
}

◼︎ 주의 사항

환불예정금액 마이너스 발생 조건

* AS IS :

1) 추가배송비 혹은 반품배송비로 인한 마이너스

* TO BE :

1) 쿠폰으로 인한 마이너스 (요청,철회,기발송,승인)

2) 배송비로 인한 마이너스 (요청,승인)

3) 쿠폰 &배송비로 인한 마이너스 (요청,승인)

각 에러 메시지가 상이하므로 에러 메시지를 통해 원인을 확인하실 수 있습니다.

* 자세한 에러코드는 각 API 명세를 참고해 주세요.

관련하여 문의사항 있으실경우 http://kko.to/G5xpSFS4j 으로 전달부탁드립니다.

감사합니다.

이 섹션의 문서

관련 문서