중도 해지 요청
고객이 구독 계약을 중도에 해지하기 위해 요청하는 API입니다.
설정(SubscriptionSetting)에 따라 중도 해지 수수료가 발생할 수 있습니다.
POST
https://api.bootapi.com/v1/order_subscriptions/requests/ing/termination
사용자 해지 요청 API
이 API는 일반 사용자가 구독 해지를 요청하는 API입니다. 관리자가 즉시 해지해야 하는 경우 관리자 즉시 해지 API를 사용해주세요.
🔄 사용자 해지 vs 관리자 해지 비교
항목
사용자 해지 요청 (이 API)
관리자 즉시 해지
권한
일반 사용자
supervisor 권한 필수
설정 검증
✅ use_termination=true 필수
❌ use_termination 무시
수수료 검증
✅ 클라이언트/서버 값 비교
❌ 검증 없음
승인 프로세스
✅ 설정에 따라 승인대기/자동승인
❌ 즉시 해지
결과 상태
REQUESTED 또는 APPROVED_AUTO
즉시 TERMINATED
📋 승인 프로세스
설정 1
use_termination_approval = true
해지 요청 → REQUESTED 상태 → 관리자 승인 대기 → 승인 시 해지 완료
설정 2
use_termination_approval = false
해지 요청 → APPROVED_AUTO 상태 → 즉시 해지 완료 (자동승인)
중도 해지 시나리오
1. 해지 요청 후 처리 절차
- 자동 계산된 수수료 금액 확인
- 관리자 승인 대기
- 수수료 납부 후 해지 확정
2. 수수료 > 환불금인 경우
- 관리자 승인 → 수수료 납부 → 계약 해지
- 수수료가 다른 경우 관리자가 수정 후 승인
3. 수수료 < 환불금인 경우
- 승인 → 부분취소 처리 → 계약 해지
- 부분취소 불가 시 이용비용 납부 후 전체취소
1
Server
SDK 설치
서버에서 API를 호출하기 위해 Backend SDK를 설치합니다.
SDK 설치 및 설정 방법은 토큰 발급 가이드를 참고하세요.
2
Server
중도 해지 요청
구독 계약 ID와 해지 사유를 전달하여 해지를 요청합니다.
요청 파라미터
| 파라미터 | 타입 | 필수 | 설명 |
|---|---|---|---|
order_subscription_id | string | 필수 | 구독 계약 고유 번호 (URL 파라미터) |
reason | string | 중도 해지 사유 |
3
Server
응답 처리
예상 수수료와 환불 금액을 확인하고 승인 대기 상태를 안내합니다.
응답 데이터
| 파라미터 | 타입 | 설명 |
|---|---|---|
id | string | 구독 계약 고유 ID |
status | number | 변경된 구독 상태 |
request_type | number | 요청 타입 (3: 중도해지) |
termination_fee | number | 예상 해지 수수료 |
refund_amount | number | 예상 환불 금액 |
