이럴 때 선택해요: API 호출량, 발송 건수, 시트 수처럼 사용량에 따라 매달 금액이 달라지는 서비스
enum 값:usage_based_subscription— 유형 선택 가이드
종량제는 다른 유형과 청구 구조가 반대예요. 정기구독·정기배송·렌탈은 회차 가격표에 금액이 미리 고정되지만, 종량제는 회차마다 부트페이가 가맹점 서버에 사용량을 물어봐서 청구액을 확정해요.
내가 하는 것
- 과금 단위·단가 설계 (건당·시트당·구간별)
- 사용량 집계 시스템 운영
- 사용량 API 엔드포인트 구현·응답
- 고객에게 사용량 내역 안내
Bootpay가 알아서 하는 것
- 회차마다 사용량 API 호출
- 응답받은 금액으로 회차 확정·자동 결제
- 조회 실패 시 재시도
- 웹훅 알림, 회차별 내역 제공
핵심 개념 — 사용량 API
종량제 구독을 만들려면 구독 템플릿에 사용량 API URL(usage_api_url)이 반드시 있어야 해요. 이 URL은 가맹점 서버의 엔드포인트로, 부트페이가 회차 결제 전에 호출해서 그 회차의 청구액을 받아 가요.
결제 예정일 접근 → Bootpay가 usage_api_url 호출 → 가맹점이 금액 응답 → 회차 금액 확정 → 자동 결제구현 규격은 사용량 API 연동에서 자세히 다뤄요.
시작 순서
과금 모델 설계
단가표(건당 요금, 구간 요금)를 정해요. 이 계산은 가맹점 서버 몫이에요 — 부트페이는 최종 금액만 받아요.
사용량 API 구현
부트페이의 조회 요청에 금액을 응답하는 엔드포인트를 만들어요. 사용량 API 연동
상품 등록
종량제 템플릿(사용량 API URL 포함)을 상품에 적용해요. 종량제는 상품가 0원이 허용돼요.
신청 → 승인 → 자동 청구
승인 후에는 매 회차 사용량 조회 → 결제가 자동으로 반복돼요. 청구 흐름
공통 API 바로가기
| 하고 싶은 것 | 문서 |
|---|---|
| 계약 목록·상태 조회 | 계약 조회 |
| 회차·확정 금액 확인 | 회차 조회 |
| 신청 승인·거절 | 신청 관리 |
| 일시정지·재개·해지 | 일시정지 · 해지 |