Version 1
자동결제(빌링) 이해하기
자동결제는 정기 배송, 음악 스트리밍과 같은 구독형 서비스에서 사용할 수 있어요. 토스페이먼츠는 신용·체크카드 및 계좌이체 2가지 결제수단으로 자동결제를 지원해요.
자동결제는 리스크 검토 및 추가 계약 후 사용할 수 있습니다. 정기 구독형 서비스가 아니라면 정책적으로 자동결제 사용이 제한되니 유의하세요. 도입 문의는 아래 버튼을 눌러주세요.
도입 문의하기
연동하기
자동결제 과정
일반결제는 결제하는 시점에 매번 구매자의 본인인증이 필요하지만, 자동결제는 구독 주기마다 본인인증 없이 결제할 수 있습니다. 최초 본인인증을 해서 발급된 빌링키가 이후의 본인인증 과정을 대신하기 때문입니다. 기술적으로는 매 회 본인인증이 일어나지만, 구매자 입장에서는 최초 인증 후에는 따로 인증 과정이 없는 결제 경험을 하게 됩니다.
자동결제는 다음과 같은 순서로 이루어집니다.
-
구매자의 카드·계좌 정보로 토스페이먼츠에서 빌링키를 발급받고 저장합니다.
-
빌링키로 구독 주기마다 원하는 금액을 자유롭게 결제합니다.
1. 빌링키 발급받기
빌링키란?
빌링키는 구매자의 카드번호, 유효기간, CVC 등 결제 정보를 암호화한 값으로 생각할 수 있어요. 본인인증을 마치고 한 번 빌링키를 발급받으면, 구매자의 의사와 무관하게 빌링키로 계속 결제가 가능해요. 악용되지 않게 반드시 구매자 본인인증을 받은 뒤에 빌링키를 발급받는 것을 추천해요.
빌링키는 결제수단을 관리하는 곳에서 발급해요. 예를 들어, 구매자가 정보를 등록했다면 카드사·은행에서 빌링키를 발급해요. PG사는 카드사·은행에서 발급한 빌링키를 상점에게 전달해요.
빌링키는 구매자 정보와 함께 서버에 저장하세요. 한 번 발급받은 빌링키는 다시 조회할 수 없습니다. 더 자세한 빌링키 설명은 용어사전 > 자동결제에서 확인해보세요.
2. 자동결제 실행하기
발급받은 빌링키로 자동결제 승인 API를 호출해서 구독 주기에 맞춰 원하는 금액을 자유롭게 결제합니다.
자주 묻는 질문
구독 서비스는 API를 사용해서 직접 구축해야 합니다. 1달 주기로 결제가 필요한 상품이면 1달마다 customerKey, 빌링키, 금액을 설정해서 자동결제 승인 API를 호출하면 됩니다. 구현하는 방법이 궁금하다면 구독 결제 서비스 간단히 구현하기시리즈를 참고하세요.
다음 결제일에 구독을 취소한 구매자의 빌링키, customerKey로 자동결제 승인 API를 호출하지 않으면 됩니다. 사용하지 않는 빌링키 삭제 API로 삭제할 수 있습니다.
금액이 바뀌었다면 자동결제 승인 API를 호출할 때 amount 파라미터를 변경된 결제 금액으로 설정하면 됩니다.
결제 주기가 바뀌었다면 자동결제 승인 API를 호출하는 주기를 변경해주세요.
아니요. 토스페이, 카카오페이, 네이버페이와 같은 국내 간편결제는 지원하지 않습니다. PayPal(페이팔)과 같은 해외 간편결제도 지원하지 않습니다.
새로운 카드·계좌 정보로 빌링키를 다시 발급받으세요. 빌링키를 갱신하는 별도 과정은 없습니다.
자동결제 계약이 안 되어 있는 클라이언트 키로 연동하면 발생합니다. 자동결제 계약이 되어있는 클라이언트 키를 사용하거나 토스페이먼츠 고객센터(1544-7772, support@tosspayments.com)로 문의해주세요.
customerkey와 매핑되지 않은 billingKey를 사용하면 발생합니다.
발급된 빌링키를 조회하는 API는 제공되지 않습니다. 빌링키 발급 이후 반드시 안전하게 저장하세요. 만약에 빌링키를 잃어버렸다면 구매자에게 다시 결제 정보를 받아서 새로운 빌링키를 발급받아주세요. 카드·계좌 하나에 여러 개의 빌링키를 중복으로 발급할 수 있어요. 빌링키 중복 발급을 방지하는 방법은 없습니다.