구독 운영 개요 | Bootpay 커머스 매뉴얼

계약이 만들어진 뒤의 일이에요 — 대기 계약을 승인해 시작시키는 것부터 회차 청구, 금액 조정, 정지·해지까지. 계약이 어떻게 생기는지는 구독 계약에서 다뤄요.

세 갈래로 나뉘어요

수정은 계속 도는 구독의 금액을 바꿔요. 관리는 구독이 도는지 여부 자체를 바꿔요. "다음 달부터 만원 깎아줘" 는 수정, "다음 달부터 안 받겠다" 는 관리예요.

결제 주기는 계약 내용 변경으로 못 바꿔요 — 요청 파라미터에 주기 필드가 없어요.

하려는 것	문서
회차별 청구 상태와 다음 결제일	회차 조회
회차 안의 실제 결제 시도 기록	거래 목록

한 번 붙이면 끝이 아니라 회차가 돌 때마다 조건을 다시 봐요. 자세한 건 구독 쿠폰을 봐요.

여기 신규 승인은 계약 자체를 승인해 활성화해요. 신청 관리의 승인은 고객이 넣은 변경 요청(해지·정지·재개·승계·인수·플랜 변경)을 처리하는 것이라 대상이 달라요. 용어 구분은 구독 용어 사전에 정리돼 있어요.

회차 결제는 서버가 부르지 않아도 주기에 맞춰 돌아요. 그래서 결과는 웹훅으로 받아요.

이벤트	시점	서버가 할 일
`subscription.approved`	구독 시작	구독 권한 활성화
`subscription.hold_on`	회차 결제 실패로 자동 중단	서비스 제한 + 복구 결제 안내
`subscription.terminated`	구독 종료	구독 권한 해제
`subscription.admin_terminated`	관리자 해지	구독 권한 해제
`subscription.rejected`	대기 계약 거절	권한을 켜지 않아요
`subscription.restored`	해지된 구독을 부트페이 관리자에서 복구	구독 권한 다시 활성화

지금 subscription.terminated 는 결제 실패가 반복돼 자동 해지될 때만 나가요. 고객이 요청한 해지와 고객 일시정지는 웹훅이 없으니, 해지·일시정지 API 응답의 status 나 계약 상세로 상태를 확인해요.