구독 승인
대기 상태(status=0)의 구독 계약을 승인하여 구독을 시작시키는 API입니다.
승인 후 구독이 정식으로 시작되며, 설정된 주기에 따라 자동 결제가 발생합니다.
POST
https://api.bootapi.com/v1/order_subscriptions/:id/approve
관리자 권한 필요
이 API는 supervisor 권한이 필요합니다. 관리자 토큰으로 요청해주세요.
승인 시나리오
- 구독 요청 → 계약 대기(status=0) 상태로 생성
- 관리자가 승인 API 호출
- 구독 중(status=1) 상태로 변경
- 첫 회차 결제 및 서비스 시작
자동 승인 설정
구독 설정(SubscriptionSetting)에서 자동 승인을 활성화하면 별도 API 호출 없이 자동으로 승인됩니다.
1
Server
SDK 설치
서버에서 API를 호출하기 위해 Backend SDK를 설치합니다.
SDK 설치 및 설정 방법은 토큰 발급 가이드를 참고하세요.
2
Server
구독 승인 요청
구독 계약 ID를 URL 파라미터로 전달하여 승인합니다.
요청 파라미터
| 파라미터 | 타입 | 필수 | 설명 |
|---|---|---|---|
order_subscription_id | string | 필수 | 구독 계약 고유 번호 또는 external_uid (URL 파라미터) |
3
Server
응답 처리
승인된 구독 정보와 서비스 시작일을 확인합니다.
응답 데이터
| 파라미터 | 타입 | 설명 |
|---|---|---|
id | string | 구독 계약 고유 ID |
status | number | 변경된 구독 상태 (1: 구독 중) |
approved_at | string | 승인 일시 |
service_start_at | string | 구독 시작일 |
