구독 거절
대기 상태(status=0)의 구독 계약을 거절하는 API입니다.
거절된 구독은 관리자 중단(status=-11) 상태로 변경되며, 더 이상 진행되지 않습니다.
POST
https://api.bootapi.com/v1/order_subscriptions/:id/reject
관리자 권한 필요
이 API는 supervisor 권한이 필요합니다. 관리자 토큰으로 요청해주세요.
거절 시나리오
- 구독 요청 → 계약 대기(status=0) 상태로 생성
- 관리자가 거절 API 호출 (사유 입력)
- 관리자 중단(status=-11) 상태로 변경
- 고객에게 거절 알림 발송 (설정에 따라)
거절 vs 해지
거절은 승인 전 대기 상태의 구독을 취소하는 것이고, 해지는 이미 진행 중인 구독을 중단하는 것입니다.
1
Server
SDK 설치
서버에서 API를 호출하기 위해 Backend SDK를 설치합니다.
SDK 설치 및 설정 방법은 토큰 발급 가이드를 참고하세요.
2
Server
구독 거절 요청
구독 계약 ID와 거절 사유를 전달합니다.
요청 파라미터
| 파라미터 | 타입 | 필수 | 설명 |
|---|---|---|---|
order_subscription_id | string | 필수 | 구독 계약 고유 번호 또는 external_uid (URL 파라미터) |
reason | string | 거절 사유 |
3
Server
응답 처리
거절된 구독 정보를 확인합니다.
응답 데이터
| 파라미터 | 타입 | 설명 |
|---|---|---|
id | string | 구독 계약 고유 ID |
status | number | 변경된 구독 상태 (-11: 관리자 중단) |
rejected_at | string | 거절 일시 |
reject_reason | string | 거절 사유 |
