취소 요청 거절 (관리자)
고객 또는 외부 시스템에서 요청한 결제 취소 요청을 관리자가 거절하는 API입니다.
취소 요청이 내부 정책, 거래 조건, 결제 상태 등의 사유로 승인될 수 없는 경우, 관리자가 사유와 함께 거절 처리할 수 있습니다.
PUT
https://api.bootapi.com/v1/order/cancel/:id/reject
supervisor 권한 필요
이 API는 관리자(supervisor) 권한이 필요합니다. 일반 사용자 토큰으로는 호출할 수 없습니다.
거절 사유 예시
- 정책 - 환불 기간이 만료되었거나 환불 정책에 해당하지 않음
- 조건 - 상품이 이미 사용되었거나 훼손됨
- 상태 - 이미 배송이 완료되었거나 처리 중인 주문
1
Server
SDK 설치
서버에서 API를 호출하기 위해 Backend SDK를 설치합니다.
SDK 설치 및 설정 방법은 토큰 발급 가이드를 참고하세요.
2
Server
취소 요청 거절
취소 요청 고유 번호와 거절 사유를 전달하여 거절합니다.
요청 파라미터
| 파라미터 | 타입 | 필수 | 설명 |
|---|---|---|---|
order_cancel_request_history_id | string | 필수 | 취소 요청 고유 번호 (URL 파라미터) |
message | string | 필수 | 관리자 거절 메시지 (사용자에게 전달됨) |
거절 메시지
거절 메시지는 사용자에게 전달되므로 명확하고 이해하기 쉽게 작성해주세요.
3
Server
응답 처리
거절된 취소 요청 정보가 반환됩니다.
응답 데이터
| 파라미터 | 타입 | 설명 |
|---|---|---|
id | string | 취소 요청 고유 번호 |
order_id | string | 주문 고유 번호 |
status | number | 취소 요청 상태 (2: 거절됨) |
rejected_at | string | 거절 일시 |
rejected_message | string | 거절 사유 |
