즉시 해지
관리자가 구독을 즉시 해지하는 API입니다.
고객의 요청 없이 관리자 권한으로 직접 구독을 해지 처리합니다.
POST
https://api.bootapi.com/v1/order_subscriptions/:order_subscription_id/terminate
관리자 권한 필요
이 API는 supervisor 권한이 필요합니다. 관리자 토큰으로 요청해주세요.
즉시 해지 주의사항
이 API를 호출하면 구독이 즉시 해지되며, 되돌릴 수 없습니다. 고객 요청에 의한 해지는 사용자 해지 요청 API를 사용해주세요.
🔄 관리자 해지 vs 사용자 해지 비교
항목
관리자 즉시 해지 (이 API)
사용자 해지 요청
권한
supervisor 권한 필수
일반 사용자
설정 검증
❌ use_termination 무시
✅ use_termination=true 필수
수수료 검증
❌ 검증 없음
✅ 클라이언트/서버 값 비교
승인 프로세스
❌ 즉시 해지
✅ 설정에 따라 승인대기/자동승인
결과 상태
즉시 TERMINATED
REQUESTED 또는 APPROVED_AUTO
사용 시나리오
- 서비스 정책 위반 - 이용약관 위반 등으로 즉시 해지가 필요한 경우
- 사기 거래 의심 - 결제 사기 등 비정상 거래로 판단되는 경우
- 고객 요청 긴급 처리 - 고객 센터를 통한 긴급 해지 요청
- 시스템 정리 - 테스트 데이터 정리 등 운영상 필요한 경우
1
Server
SDK 설치
서버에서 API를 호출하기 위해 Backend SDK를 설치합니다.
SDK 설치 및 설정 방법은 토큰 발급 가이드를 참고하세요.
2
Server
즉시 해지 요청
구독 ID와 해지 사유를 입력하여 즉시 해지를 처리합니다.
요청 파라미터
| 파라미터 | 타입 | 필수 | 설명 |
|---|---|---|---|
order_subscription_id | string | 필수 | 해지할 구독 계약 고유 ID (URL 파라미터) |
reason | string | 필수 | 해지 사유 (관리자 메모) |
termination_fee | number | 해지 위약금 (기본값: 0) | |
last_bill_refund_price | number | 마지막 회차 환불 금액 (기본값: 0) | |
final_fee | number | 최종 정산 금액 | |
service_end_at | datetime | 서비스 종료일 (ISO 8601 형식) | |
cancel_date | date | 취소일 (YYYY-MM-DD 형식) |
3
Server
응답 처리
해지 결과와 변경된 상태를 확인합니다.
응답 데이터
| 파라미터 | 타입 | 설명 |
|---|---|---|
order_subscription_id | string | 구독 계약 고유 ID |
order_number | string | 구독 주문번호 (SP_로 시작) |
status | string | 변경된 상태 (manual_terminated) |
order_name | string | 주문명 (상품명 + 옵션) |
price | number | 구독 결제 금액 |
origin_price | number | 구독 원가 |
tax_free_price | number | 면세 금액 |
setup_price | number | 초기 설정 비용 (탁송비 등) |
quantity | integer | 수량 |
unit | string | 통화 단위 (KRW, USD 등) |
membership_type | string | 회원 유형 (personal, business) |
subscription_type | string | 구독 유형 (regular_subscription) |
subscription_payment_cycle_type | string | 결제 주기 (1month, 3month 등) |
subscription_payment_date | integer | 정기 결제일 |
total_subscription_duration | integer | 총 구독 회차 |
total_subscription_label | string | 구독 회차 라벨 (예: 24회차) |
current_duration | integer | 현재 회차 |
payment_last_duration | integer | 마지막 결제 회차 |
created_last_duration | integer | 마지막 생성 회차 |
is_first_prepaid | boolean | 첫 회차 선결제 여부 |
approval_status | string | 승인 상태 |
approval_at | datetime | 승인 일시 |
service_start_at | datetime | 서비스 시작일 |
service_end_at | datetime | 서비스 종료일 (해지 시 변경됨) |
payment_next_at | datetime | 다음 결제 예정일 |
billing_payment_next_at | datetime | 다음 빌링 결제 예정일 |
pause_count | integer | 일시정지 횟수 |
pause_total_days | integer | 총 일시정지 일수 |
has_pending_request | boolean | 대기중인 요청 존재 여부 |
use_delivery | boolean | 배송 사용 여부 |
delivery_type | string | 배송 유형 |
delivery_cycle_type | integer | 배송 주기 타입 |
user_id | string | 사용자 ID |
username | string | 사용자명 |
user_email | string | 사용자 이메일 |
user_phone | string | 사용자 연락처 |
user_company_name | string | 사업자 회사명 |
user_business_number | string | 사업자 번호 |
first_order_subscription_bill | object | 첫 결제 청구 정보 |
products | array | 구독 상품 목록 |
options | array | 선택된 상품 옵션 목록 |
order_subscription_adjustments | array | 구독 전체 조정 항목 (회차별 할인, 추가비용) |
