정기구독

정기구독(regular_subscription)은 회차 가격표대로 주기마다 같은 금액을 자동 결제하는 구독 유형입니다. SaaS 월간/연간 요금제, 유료 멤버십, 디지털 콘텐츠·이용권에 사용합니다.

정기구독은 부트페이 구독의 기본 유형​​입니다. 구독 템플릿에서 유형을 따로 바꾸지 않으면 정기구독으로 만들어집니다. 유형 구분은 유형 선택 가이드를 참고합니다.

결제 주기와 결제일

정기구독의 청구 리듬은 구독 템플릿에서 정합니다.

설정 선택지 설명
결제 주기 주 / 월 / 연 회차가 반복되는 간격입니다 (1·2·3·4·6주, 1·2·3·6개월, 1년).
결제일 기준 결제일 기준 / 고정일 가입일 기준으로 매 주기 청구할지, 매월 같은 날짜(예: 1일)에 청구할지 정합니다.

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

시작 순서

요금제 설계

회차 가격표로 월/연 요금제를 만듭니다. 요금제·회차 가격 설계

상품 등록

관리자에서 상품에 구독 템플릿을 적용합니다. 디지털 상품은 디지털·이용권 연계를 함께 참고합니다.

신청 → 승인

고객이 신청하면 신규 승인으로 첫 결제를 실행합니다.

권한 제어

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

서비스 권한 제어 패턴

가맹점 서버는 웹훅을 받아 이용 권한을 전환​​합니다.

웹훅 이벤트 가맹점이 할 일
subscription.approved service_active = true (서비스 ON)
subscription.paused 서비스 일시 제한 (고객·관리자가 멈춘 상태 — 결제 실패 중단은 subscription.hold_on)
subscription.terminated service_active = false (서비스 OFF)
알려진 문제 — 고객 해지·일시정지에는 웹훅이 오지 않습니다

지금 subscription.terminated 는 결제 실패 반복으로 자동 해지될 때만, subscription.paused 는 관리자 일시정지 때만 나갑니다. 관리자 해지는 subscription.admin_terminated 로 옵니다. 고객이 요청한 해지·일시정지는 계약 상세의 status 로 확인해 권한을 끕니다.

해지 시 권한 종료 시점(즉시 차단 / 기간 만료까지 유지)은 가맹점이 정합니다. 개념 설명: 구독 상품 유형별 차이

공통 API 바로가기

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

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

요금제·회차 가격 설계

정기구독의 요금제는 회차 가격표​​로 표현합니다. "1회차 9,900원, 2회차 9,900원, … 12회차 8,000원"처럼 회차별 판매가가 나열된 표가 상품에 박히고, 이 표가 고객에게 보이는 가격이자 자동 결제의 기준이 됩니다.

규칙과 결과를 나눠 저장합니다

구독 템플릿에는 계산 규칙(원가에 10% 가산, 1회차에 보증금 등)이, 상품에는 규칙이 계산된 결과 가격표가 저장됩니다. 템플릿을 나중에 수정해도 이미 만들어진 상품·계약의 가격은 바뀌지 않습니다. 자세한 구조는 구독 모델 구조를 참고합니다.

요금제 패턴

패턴 회차 가격표 설계
월간 요금제 무제한 회차(회차 미지정) + 월 주기, 매 회차 같은 가격
연간 요금제 무제한 회차 + 월 주기 12회차 단위 또는 연 단위 청구
약정 요금제 12회차/24회차처럼 회차 수를 고정 — 기간이 끝나면 만료됩니다
장기 할인 회차가 지날수록 가격을 낮게 — "12회차부터 8,000원"

회차 수를 고정하면 마지막 회차 결제 후 계약이 만료​(자연 종료) 상태가 됩니다. 해지와 만료의 차이는 구독 용어 사전을 참고합니다.

회차 가격표에 들어가는 것

항목 설명
판매가 회차에 청구되는 금액입니다.
비과세가 판매가 중 비과세 금액입니다.
할인가·할인 유형 회차별 할인을 결과 가격에 반영합니다.
회차 혜택 사용 여부 특정 회차에 혜택을 얹을지 정합니다. 무료체험·회차 혜택

가격 검증 규칙

상품 저장 시 회차 가격표는 구독 옵션(duration) 단위로 독립 검증​​됩니다.

  • 회차 가격은 0원 이상​​이어야 합니다. 음수 회차가 하나라도 있으면 저장이 거부됩니다.
  • 한 구독 옵션 안에서 최소 한 회차는 0원보다 커야 합니다. 전 회차 0원은 종량제에서만 허용됩니다.
  • 12회차 구독과 24회차 구독처럼 옵션이 여러 개면 각 옵션이 따로 검증됩니다.

1회차를 0원으로 두는 무료체험은 이 규칙 안에서 가능합니다. 무료체험·회차 혜택을 참고합니다.

판매 후 가격 변경

이미 체결된 계약의 가격표는 스냅샷으로 고정돼 있어서 상품 가격을 고쳐도 소급되지 않습니다. 살아 있는 계약의 금액을 바꾸는 방법은 두 가지입니다.

상황 방법
다음 회차부터 계약 자체를 변경 계약 내용 변경
특정 회차에만 할인·추가 요금 회차 금액 조정

관련 문서


무료체험·회차 혜택

정기구독의 혜택은 세 층위로 설계할 수 있습니다. 설계 시점​(회차 가격표), 회차 시점​(회차 혜택), 운영 시점​(금액 조정)입니다.

1무료체험 — 1회차 0원

회차 가격표에서 1회차 판매가를 0원으로 두면 첫 주기가 무료체험이 됩니다.

  • 승인 시점에 0원 회차가 처리되고, 2회차부터 정상 금액이 자동 결제됩니다.
  • 가격 검증 규칙상 모든 회차를 0원으로 둘 수는 없습니다​. 한 회차 이상은 유료여야 합니다.
  • 빌링키는 신청 시점에 등록되므로, 무료체험이 끝나면 별도 재동의 없이 2회차가 결제됩니다. 체험 종료 전 안내 메시지는 가맹점이 직접 보냅니다.
무료체험 어뷰징

같은 고객의 무료체험 반복 신청은 신청 승인 단계에서 이력을 확인하고 구독 거절로 거릅니다. 개념 설명: 구독 무료체험 설계

2회차 혜택

회차 가격표의 특정 회차에 혜택을 정의합니다. "3회차마다 사은품", "6회차 도달 시 등급 상향" 같은 회차 단위 리워드를 표현합니다. 상품 편집의 회차 설정에서 회차별 혜택 사용​​을 켜면 회차마다 혜택 내용을 입력할 수 있습니다.

3운영 중 할인 — 금액 조정

이미 구독 중인 고객의 할인·보상은 회차 가격표가 아니라 금액 조정​​으로 처리합니다. 특정 회차에 할인(음수 조정)이나 추가 요금(양수 조정)을 얹는 방식입니다.

하고 싶은 것 API
다음 회차 5,000원 할인 회차 금액 조정
걸어둔 조정 내용 변경 조정 항목 전체 변경
조정 취소 조정 항목 삭제

쿠폰과 구독

구독 신청 시점에 쿠폰을 적용할 수 있습니다. 적용 결과 금액은 구독 쿠폰의 적용 미리보기로 확인합니다. 단, 종량제는 쿠폰을 적용할 수 없고, 정기배송은 배송비 쿠폰이 제한됩니다 — 정기구독에는 이 제약이 없습니다.

관련 문서


플랜 변경

구독 중인 고객이 다른 구독 상품으로 갈아타는 기능입니다. 베이직 → 프로 업그레이드, 프로 → 베이직 다운그레이드를 해지·재가입 없이 처리합니다. 계약은 그대로 유지되고 다음 결제 회차부터 새 상품의 가격·주기가 적용됩니다.

적용 시점은 다음 회차

현재 플랜 변경은 next_cycle 전략만 지원합니다 — 신청·승인이 끝나도 이번 회차는 기존 금액으로 청구되고, 다음 회차부터 새 플랜이 반영됩니다. 회차 중간의 일할 계산(proration)은 지원하지 않습니다.

흐름

구매자가 신청합니다

구매자는 부트페이가 호스팅하는 마이페이지에서 변경 가능한 플랜 후보를 보고 신청합니다. 후보는 상품에 지정해 둔 플랜 변경 그룹(같은 그룹의 상품) 또는 변경 후보 상품 목록에서 골라집니다.

신청이 접수됩니다

플랜 변경 신청은 다른 구독 신청과 같은 신청 관리 목록에 유형 "플랜 변경"으로 쌓입니다.

관리자가 승인합니다

신청 관리 API로 신청을 조회하고 승인/거절합니다. 승인하면 다음 회차 예약이 새 플랜 기준으로 갱신됩니다.

웹훅으로 확인합니다

변경 결과는 구독 웹훅으로 통지됩니다. 업그레이드/다운그레이드 여부에 따라 서비스 권한을 조정합니다.

관리자가 직접 바꿀 때

구매자 신청 없이 관리자가 계약 내용을 바로 바꿔야 한다면 계약 내용 변경을 사용합니다. 금액·상품 구성을 직접 수정하는 API라서 플랜 변경 신청 흐름을 거치지 않습니다. 이 경우 금액은 이미 잡혀 있는 결제예정 회차부터 바로 다시 계산됩니다.

상황 방법
구매자가 직접 변경 마이페이지 플랜 변경 + 신청 관리로 승인
관리자가 CS로 직접 변경 계약 내용 변경
이번 회차만 금액 보정 회차 금액 조정

관련 문서


디지털·이용권 연계

영상·강의·전자책 같은 콘텐츠(디지털) 상품​​에 구독을 붙이는 방법입니다. "디지털 구독"은 별도 구독 유형이 아니라 디지털 상품 + 정기구독​​의 조합입니다.

디지털 상품은 정기구독만

상품 유형이 콘텐츠(디지털)인 상품에는 구독 유형 중 정기구독만 선택할 수 있습니다. 정기배송·렌탈·리스는 붙일 수 없습니다.

구조

두 축을 나눠서 설계합니다.

상품(지급) 축

  • 상품 유형: 콘텐츠(디지털)
  • 지급 방식: 파일 / 링크 / 코드 / 수동
  • 결제 성공 시 지급 실행

구독(권한) 축

  • 정기구독 회차 가격표
  • 회차 결제 성공 → 이용 기간 연장
  • 해지·만료 → 권한 회수

지급 방식 4가지는 상품 등록 시 정합니다.

지급 방식 동작 예시 상품
파일 결제 후 파일 다운로드 제공 전자책, 템플릿, 에셋
링크 결제 후 접근 링크 제공 강의 페이지, 비공개 콘텐츠
코드 코드 풀에서 1개 발급 라이선스 키, 쿠폰 코드
수동 가맹점이 직접 지급 처리 맞춤 콘텐츠, 수작업 개통

권한 회수 설계

해지 시 권한 종료 방식은 즉시형​(바로 차단)과 기간 만료형​(이번 결제 기간이 끝날 때까지 유지) 중에서 정합니다.

가맹점 서버는 웹훅으로 권한을 제어합니다.

이벤트 처리
subscription.approved 콘텐츠 접근 ON + 지급 실행 확인
회차 결제 성공 이용 기간을 다음 결제일까지 연장
subscription.paused 정책에 따라 접근 유지 또는 차단
subscription.terminated · .admin_terminated 기간 만료형이면 만료일에, 즉시형이면 바로 접근 OFF (고객 해지는 웹훅이 없으니 계약 상태로 확인 — 위 「알려진 문제」 참고)

관련 문서

함께 보기