부트페이 구독은 5가지 유형을 지원합니다. 유형은 구독 템플릿(설정)의 type 값으로 결정되고(계약에서는 subscription_type 으로 보입니다), 유형에 따라 배송·청구·만기 처리 방식이 달라집니다.
계약 조회·승인·해지 같은 API는 주기형 4유형이 전부 공통입니다. 공통 API와 개념은 구독 기본 메뉴에, 유형별 설정과 운영 시나리오는 각 유형 메뉴에 있습니다.
유형 한눈에 보기
주기가 있는 4유형
| 정기구독 | 정기배송 | 렌탈·리스 | 종량제 | |
|---|---|---|---|---|
| enum 값 | regular_subscription |
delivery_subscription |
rental_lease_subscription |
usage_based_subscription |
| 대표 사례 | SaaS 요금제, 멤버십, 콘텐츠·이용권 | 식품·화장품·생활용품 정기배송 | 기기·설비 렌탈, 리스 | API 사용량, 시트당 과금 |
| 청구 금액 | 회차 가격표에 고정 | 회차 가격표에 고정 | 회차 가격표에 고정 | 매 회차 사용량으로 결정 |
| 배송 | 없음 또는 1회차만 | 매 회차 자동 배송 주문 생성 | 계약 시 1회 (기기 전달) | 없음 |
| 전용 기능 | 플랜 변경(업·다운그레이드) | 배송지·배송일 변경, 배송불가 요일 | 위약금·중도인수·만기 옵션(반납/인수/연장) | 사용량 API 연동 |
| 주의점 | — | 배송비 쿠폰 적용 불가 | 위약금 정책 사전 확정 필요 | 선불·쿠폰 불가, usage_api_url 필수 |
주기가 없는 1유형 — 수시결제(온디맨드)
| 수시결제 | |
|---|---|
| enum 값 | on_demand_subscription |
| 대표 사례 | 쓴 만큼 그때그때 청구, 충전형 잔액 |
| 청구 시점 | 주기 없음 — 가맹점 서버가 REST 로 요청할 때만 |
| 배송 | 없음 |
| 전용 기능 | 재결제 키 발급·해지 (POST/DELETE /v1/order_subscriptions/charge) |
| 주의점 | 결제·키 해지는 수시결제 문서 참고 |
enum 값의 전체 목록은 Enum 사전에서 관리합니다.
유형 구분 기준
매 회차 실물 상품 배송
정기배송입니다. 결제 성공이 출고 지시로 이어집니다.
기기 대여와 만기 반납·인수
렌탈·리스입니다. 약정 기간, 위약금, 만기 옵션을 설정합니다.
결제 주기 없이 필요할 때마다 청구
수시결제(온디맨드) 입니다. 정해진 주기로 자동 청구하지 않고, 재결제 키를 발급해 두었다가 가맹점 서버가 REST 로 요청할 때만 결제됩니다.
- enum 값:
on_demand_subscription - 대표 사례: 사용한 만큼 그때그때 청구하는 서비스, 충전형 잔액
- 결제:
POST /v1/order_subscriptions/charge(본문에charge_key·price), 키 해지는 같은 경로에DELETE - 주문 응답의
auto_charge_key_issued로 키 발급 여부를 확인합니다. 키 평문은 서버 인증 조회에서만 내려옵니다
결제·키 해지 요청 형식과 오류 코드는 수시결제를 참고합니다.
사용량에 따라 매달 달라지는 청구 금액
종량제입니다. 회차마다 부트페이가 가맹점 서버에 사용량을 조회해서 청구액을 확정합니다.
그 외 반복 결제라면
정기구독입니다. SaaS 요금제, 멤버십, 디지털 콘텐츠 구독이 여기에 속하며 기본값입니다.
디지털 상품은 정기구독만
콘텐츠(디지털) 상품에 구독을 붙일 때는 정기구독 유형만 선택할 수 있습니다. 파일·링크·코드 지급과 구독을 연계하는 방법은 디지털·이용권 연계를 참고합니다.
유형과 무관한 공통 항목
유형은 구독 템플릿에서 한 번 정하면 계약에 스냅샷으로 고정됩니다. 아래는 유형과 무관하게 공통입니다.
- 라이프사이클 — 대기 → 구독 중 → 일시정지/해지/만료. 구독 개요
- 계약·회차·신청 API — 계약 조회 · 회차 조회 · 신청 관리
- 웹훅 —
subscription.*이벤트로 상태 동기화. 웹훅 가이드
다음 순서로 읽습니다
| 순서 | 문서 | 내용 |
|---|---|---|
| 1 | 유형 선택 가이드 (지금 여기) | 5종 유형 구분 |
| 2 | 구독 개요 | 라이프사이클·상태·자동 과금·웹훅 |
| 3 | 구독 모델 구조 | 템플릿·정책·상품·계약 네 계층 |
| 4 | 고른 유형의 메뉴 | 유형 전용 설정과 시작 순서 |
용어는 구독 용어 사전을 참고합니다.



