토스페이먼츠 자동결제(정기결제) 연동 방법 가이드

구독 서비스, 월정액 멤버십, 정기 배송 등을 운영한다면 자동결제(정기결제) 기능이 필수입니다. 토스페이먼츠는 빌링키 방식으로 자동결제를 지원하며, 이 가이드에서는 토스페이먼츠 자동결제 연동 방법을 단계별로 설명합니다.

자동결제란? 활용 사례

자동결제(정기결제)는 고객이 최초 1회 카드 정보를 등록하면, 이후 별도 인증 없이 정해진 주기에 자동으로 결제가 이루어지는 방식입니다.

• SaaS / 구독 서비스 — 월정액 소프트웨어, 스트리밍 서비스
• 멤버십 — 헬스장, 코워킹 스페이스 월 이용료
• 정기 배송 — 식품, 생필품 정기 구독 박스
• 온라인 강의 — 월별 수강료 자동 결제

토스페이먼츠 빌링키 발급 플로우

토스페이먼츠의 자동결제는 빌링키(Billing Key) 기반으로 동작합니다. 전체 플로우는 다음과 같습니다.

1. 결제창 호출 — 고객에게 토스페이먼츠 결제창을 띄워 카드 정보를 입력받습니다. 카드 정보는 토스페이먼츠 서버에 안전하게 저장됩니다.
2. 빌링키 발급 — 카드 인증이 완료되면 토스페이먼츠가 해당 카드에 대한 고유 빌링키를 발급합니다. 이 키를 서버에 저장합니다.
3. 정기 결제 실행 — 결제 주기가 되면 저장된 빌링키로 서버 간(Server-to-Server) API를 호출하여 자동으로 결제를 실행합니다.
4. 결과 처리 — 결제 성공/실패 결과를 웹훅으로 수신하고, 실패 시 재시도 또는 고객 알림 로직을 처리합니다.

연동 시 주의사항

• 결제 실패 재시도 로직 — 카드 한도 초과, 잔액 부족 등으로 결제가 실패할 수 있습니다. 3~5회 재시도 로직과 고객 알림을 반드시 구현하세요.
• 빌링키 만료 관리 — 카드 만료, 분실 재발급 등으로 빌링키가 무효화될 수 있습니다. 결제 실패 시 고객에게 카드 재등록을 안내하는 플로우가 필요합니다.
• 환불 정책 명시 — 정기결제 서비스는 청약철회 및 환불 정책을 이용약관에 명확히 기재해야 합니다. PG 심사 시 확인 대상입니다.

자주 묻는 질문