정기구독

정기구독 이해하기

정해진 주기로 자동 결제되는 가장 일반적인 구독을 설계해요.

이럴 때 선택해요​: SaaS 월간/연간 요금제, 유료 멤버십, 디지털 콘텐츠·이용권처럼 정해진 주기로 같은 금액을 자동 결제하는 서비스
enum 값​: regular_subscription유형 선택 가이드

정기구독은 부트페이 구독의 기본 유형​​이에요. 구독 템플릿에서 유형을 따로 바꾸지 않으면 정기구독으로 만들어져요. 배송·만기·사용량 같은 유형 전용 개념 없이, 회차 가격표대로 주기마다 자동 결제​​되는 가장 단순한 구조예요.

내가 하는 것

  • 요금제(회차 가격표) 설계·상품 등록
  • 구독 신청 승인/거절 판단
  • 웹훅으로 서비스 이용 권한 제어
  • 플랜 변경 신청 승인

Bootpay가 알아서 하는 것

  • 매 회차 자동 결제, 실패 재시도
  • 결제 주기·다음 결제일 관리
  • 일시정지·재개·해지 상태 관리
  • 웹훅 알림, 회차별 결제 내역 제공

결제 주기와 결제일

정기구독의 청구 리듬은 구독 템플릿에서 정해요.

설정 선택지 설명
결제 주기 일 / 주 / 월 회차가 반복되는 간격이에요.
결제일 기준 결제일 기준 / 고정일 가입일 기준으로 매 주기 청구할지, 매월 같은 날짜(예: 1일)에 청구할지 정해요.

첫 결제는 신규 승인 시점에 빌링키로 실행되고, 이후 회차는 부트페이가 자동으로 예약·결제해요. 자동 과금의 상세 흐름은 구독 흐름 설계를 봐요.

시작 순서

요금제 설계

회차 가격표로 월/연 요금제를 만들어요. 요금제·회차 가격 설계

상품 등록

관리자에서 상품에 구독 템플릿을 적용해요. 디지털 상품이라면 디지털·이용권 연계를 함께 봐요.

신청 → 승인

고객이 신청하면 신규 승인으로 첫 결제를 실행해요.

권한 제어

subscription.approved / subscription.terminated 웹훅을 받아 서비스 접근을 켜고 꺼요. 웹훅 가이드

서비스 권한 제어 패턴

정기구독에서 가맹점 서버가 할 일은 사실상 하나예요 — 웹훅을 받아 이용 권한을 토글​​하는 것.

웹훅 이벤트 가맹점이 할 일
subscription.approved service_active = true (서비스 ON)
subscription.paused 유예 안내, 결제수단 변경 유도
subscription.terminated service_active = false (서비스 OFF)

해지 시점과 권한 종료 시점을 어떻게 맞출지(즉시 차단 vs 기간 만료까지 유지)는 서비스 정책으로 먼저 정해요. 유형별 운영 정책 비교는 블로그 글을 참고해요.

공통 API 바로가기

정기구독의 계약·회차·신청 처리는 전부 구독 공통 API를 사용해요.

하고 싶은 것 문서
계약 목록·상태 조회 계약 조회
신청 승인·거절·철회 신청 관리
회차·결제 내역 확인 회차 조회 · 거래 목록
특정 회차 할인·추가 요금 금액 조정
일시정지·재개·해지 일시정지 · 재개 · 해지