부트페이 구독은 4가지 유형을 지원해요. 유형은 구독 템플릿(설정)의 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 필수 |
enum 값의 전체 목록은 Enum 사전에서 관리해요.
이렇게 골라요
실물 상품을 매 회차 보내나요?
맞다면 정기배송이에요. 결제 성공이 곧 출고 지시로 이어지는 구조가 필요해요.
기기를 빌려주고 만기에 반납·인수를 받나요?
맞다면 렌탈·리스예요. 약정 기간, 위약금, 만기 옵션이 핵심이에요.
청구 금액이 사용량에 따라 매달 달라지나요?
맞다면 종량제예요. 회차마다 부트페이가 가맹점 서버에 사용량을 조회해서 청구액을 확정해요.
그 외 반복 결제라면
정기구독이에요. SaaS 요금제, 멤버십, 디지털 콘텐츠 구독이 모두 여기에 속해요. 가장 일반적인 유형이라 기본값이기도 해요.
디지털 상품은 정기구독만
콘텐츠(디지털) 상품에 구독을 붙일 때는 정기구독 유형만 선택할 수 있어요. 파일·링크·코드 지급과 구독을 연계하는 방법은 디지털·이용권 연계를 봐요.
유형이 같아도, 다른 것
유형은 구독 템플릿에서 한 번 정하면 계약에 스냅샷으로 고정돼요. 아래는 유형과 무관하게 공통이에요.
- 라이프사이클 — 대기 → 구독 중 → 일시정지/해지/만료. 구독 이해하기
- 계약·회차·신청 API — 계약 조회 · 회차 조회 · 신청 관리
- 웹훅 —
subscription.*이벤트로 상태 동기화. 웹훅 가이드
다음 순서로 읽어요
유형을 골랐다면 아래 순서가 가장 짧아요.
| 순서 | 문서 | 여기서 얻는 것 |
|---|---|---|
| 1 | 유형 선택 가이드 (지금 여기) | 4종 중 내 상품의 유형 |
| 2 | 구독 이해하기 | 라이프사이클·상태·자동 과금·웹훅 |
| 3 | 구독 모델 구조 | 템플릿·정책·상품·계약 네 계층 |
| 4 | 고른 유형의 메뉴 | 유형 전용 설정과 시작 순서 |
용어가 헷갈리면 구독 용어 사전을 옆에 두고 봐요.
관련 문서
- 구독 흐름 설계 — 자동 과금·실패 재시도 전체 흐름
- 구독 상품 유형별 차이 — 콘텐츠·SaaS·정기배송 운영 정책 비교 (블로그)
