계약이 만들어진 뒤의 대기 계약 승인, 회차 청구, 금액 조정, 정지·해지를 다룹니다. 계약이 어떻게 생기는지는 구독 계약에서 다룹니다.
세 갈래로 나뉩니다
| 갈래 | 무엇을 하나 | 바뀌는 것 |
|---|---|---|
| 청구 | 회차가 언제 얼마로 청구됐는지 조회 | 없음 (조회) |
| 수정 | 상품·수량·금액·회차 수 변경 | 결제예정 회차부터의 금액 |
| 관리 | 구독 시작·정지·종료 | 구독 상태 |
수정과 관리의 차이
수정은 계속 도는 구독의 금액을 바꿉니다. 관리는 구독이 도는지 여부 자체를 바꿉니다. "다음 달부터 만원 깎아줘" 는 수정, "다음 달부터 안 받겠다" 는 관리입니다.
결제 주기는 계약 내용 변경으로 바꿀 수 없습니다 — 요청 파라미터에 주기 필드가 없습니다.
청구 — 지금 어디까지 왔나
| 하려는 것 | 문서 |
|---|---|
| 회차별 청구 상태와 다음 결제일 | 회차 조회 |
| 회차 안의 실제 결제 시도 기록 | 거래 목록 |
수정 — 금액을 바꾼다
| 하려는 것 | 문서 |
|---|---|
| 상품·옵션·수량·금액·총 회차·수령인·서비스 기간 바꾸기 | 계약 내용 변경 |
| 할인·설치비 같은 항목을 얹기 | 회차 금액 조정 |
| 조정 항목을 갈아끼우기 | 조정 항목 전체 변경 |
| 조정 항목 지우기 | 조정 항목 삭제 |
| 쿠폰 붙이기 | 구독 쿠폰 |
쿠폰은 회차마다 다시 계산됩니다
회차가 돌 때마다 쿠폰 조건을 다시 확인합니다. 자세한 내용은 구독 쿠폰을 참고합니다.
관리 — 구독을 켜고 끈다
| 하려는 것 | 문서 |
|---|---|
| 대기 계약을 활성 구독으로 올리기 | 신규 승인 |
| 시작 전 구독을 거절하기 | 구독 거절 |
| 잠시 세우기 | 일시정지 |
| 다시 돌리기 | 재개 |
| 끝내기 | 해지 |
| 주기 없이 서버가 부를 때만 결제하기 | 수시결제 |
신규 승인은 신청 승인과 다릅니다
서버가 같이 봐야 하는 것
회차 결제는 서버 호출 없이 주기에 맞춰 실행되므로 결과는 웹훅으로 받습니다.
| 이벤트 | 시점 | 서버가 할 일 |
|---|---|---|
subscription.approved |
구독 시작 | 구독 권한 활성화 |
subscription.hold_on |
회차 결제 실패로 자동 중단 | 서비스 제한 + 복구 결제 안내 |
subscription.terminated |
구독 종료 | 구독 권한 해제 |
subscription.admin_terminated |
관리자 해지 | 구독 권한 해제 |
subscription.rejected |
대기 계약 거절 | 권한을 켜지 않습니다 |
subscription.restored |
해지된 구독을 부트페이 관리자에서 복구 | 구독 권한 다시 활성화 |
알려진 문제 — 고객 해지·고객 일시정지는 웹훅이 오지 않습니다
지금 subscription.terminated 는 결제 실패가 반복돼 자동 해지될 때만 나갑니다. 고객이 요청한 해지와 고객 일시정지는 웹훅이 없으니, 해지·일시정지 API 응답의 status 나 계약 상세로 상태를 확인합니다.



