구독결제 연동 완전 가이드 — 요금제 설계부터 웹훅·던닝까지

정기결제를 직접 붙여본 팀이라면 알겠지만, "카드 등록 → 매달 자동결제"라는 단순한 그림 뒤에는 요금제 변경, 결제 실패 재시도, 웹훅 이벤트 설계, 취소 정책처럼 처음엔 안 보이던 문제가 줄줄이 따라옵니다. 이 페이지는 슈퍼빌링 블로그에서 다뤄온 구독결제 연동 관련 글을 하나로 묶은 허브입니다. 지금 어떤 단계에 있는지에 따라 필요한 글로 바로 이동하세요.

1. 시작하기 전 — 만들지 말지 결정

• 구독결제, 직접 만들지 SaaS를 쓸지 — 외주개발사 경험담
• API Key 인증 설계 — 발급, 로테이션, 권한 범위

2. 요금제 설계

• 요금제, 삭제 대신 "판매 중단" 해야 하는 이유
• 구독 업그레이드/다운그레이드, 비례 정산(Proration)은 언제 필요할까
• 쿠폰·프로모션 코드, 정기결제에서 어떻게 설계해야 할까
• 무료체험 종료 후 자동결제 전환, 어떻게 구현할까

3. 결제 실행 — 빌링키와 스케줄러

• 빌링키 결제는 스케줄러가 따로 없다 — 직접 구현할 때 필요한 것들

4. 결제 실패와 이탈 방지 — 던닝(Dunning)

• 던닝(Dunning) 재시도 주기, 왜 1일·3일·5일인가
• 던닝 이메일, 재시도 타이밍보다 카피가 이탈을 가른다

5. 해지와 환불

• 구독 취소, 즉시 해지 vs 기간 만료 후 해지 — 무엇을 기본값으로 할까

6. 웹훅 연동

• 정기결제 웹훅, 어떤 이벤트를 설계해야 할까
• 웹훅 서명 검증(HMAC-SHA256) 구현하는 법
• 웹훅 재시도와 멱등성(Idempotency), 중복 처리를 막는 법

7. 그 다음 — 사람 손 없이 운영하기

• AI 에이전트에게 결제 연동을 맡기는 법 (Remote MCP)

이 12개 글은 슈퍼빌링이 실제로 구현하며 겪은 설계 고민을 정리한 것입니다. 직접 구현하는 대신 API Key + SDK로 3분 만에 연동하고 싶다면 무료로 시작할 수 있습니다.