자동결제(빌링) 이해하기

자동결제는 정기 배송, 음악 스트리밍과 같은 구독형 서비스에서 사용하는 결제 방식입니다.

토스페이먼츠는 자동결제는 신용·체크카드만 지원해요. 토스페이먼츠에서 카드 빌링키를 발급받으려면 카드 번호, 유효기간, 카드 소유자의 생년월일 또는 사업자번호가 필요해요.

일반결제는 결제하는 시점에 매번 구매자의 본인인증이 필요하지만, 자동결제는 매번 본인인증을 받지 않아도 결제할 수 있습니다. 최초 본인인증을 해서 발급된 빌링키가 이후의 본인인증 과정을 대신하기 때문입니다. 기술적으로는 매 회 본인인증이 일어나지만, 결제 고객 입장에서는 최초 인증 후에는 따로 인증 과정이 없는 결제 경험을 하게 됩니다.

자동결제는 다음과 같은 순서로 이루어집니다.

1. 구매자의 카드 정보로 토스페이먼츠에서 빌링키를 발급받고 저장합니다.

2. 빌링키로 1시간, 1주, 1달, 1년 등 필요한 시점에 원하는 금액을 자유롭게 결제합니다.

빌링키는 고객의 카드번호, 유효기간, CVC 등 결제 정보를 암호화한 값으로 생각할 수 있어요. 본인인증을 마치고 한 번 빌링키를 발급받으면, 고객의 의사와 무관하게 빌링키로 계속 결제가 가능해요. 악용되지 않게 반드시 고객 본인인증을 받은 뒤에 빌링키를 발급받는 것을 추천해요.

빌링키는 결제수단을 관리하는 곳에서 발급해요. 예를 들어, 고객이 카드 정보를 등록했다면 카드사에서 빌링키를 발급해요. PG사는 카드사에 발급한 빌링키를 상점에게 전달해요.

빌링키는 고객 정보와 함께 서버에 저장하세요. 한 번 발급받은 빌링키는 다시 조회할 수 없습니다.

👉 빌링키에 대한 더 자세한 설명은 용어사전에서 확인해보세요.

빌링키 발급에 필요한 구매자의 카드 정보 입력, 본인인증은 두 가지 방법으로 구현할 수 있습니다.

• 위 그림과 같은 토스페이먼츠 카드 등록창을 연동해서 구매자의 카드 정보, 본인인증을 받습니다. 카드 등록 요청 결과로 빌링키를 발급받습니다. 더 자세한 내용은 결제창 가이드를 참고하세요.
• 자체적으로 구매자의 카드 정보, 본인인증을 받는 UI를 구현합니다. 구매자의 카드 정보로 API를 호출해서 빌링키를 발급받습니다. 더 자세한 내용은 API 가이드를 참고하세요.

발급받은 빌링키로 카드 자동결제 승인 API를 호출해서 필요한 시점에 원하는 금액을 자유롭게 결제합니다.

curl --request POST \
  --url https://api.tosspayments.com/v1/billing/Z_t5vOvQxrj4499PeiJcjen28-V2RyqgYTwN44Rdzk0= \
  --header 'Authorization: Basic dGVzdF9za196WExrS0V5cE5BcldtbzUwblgzbG1lYXhZRzVSOg==' \
  --header 'Content-Type: application/json' \
  --data '{"customerKey":"aENcQAtPdYbTjGhtQnNVj","amount":4900,"orderId":"a4CWyWY5m89PNh7xJwhk1","orderName":"토스 프라임 구독","customerEmail":"customer@email.com","customerName":"박토스","taxFreeAmount":0,"taxExemptionAmount":0}'

자동결제 테스트 환경에서는 라이브 환경과 달리 카드 등록창에서 본인인증 기능이 제공되지 않습니다. 본인인증창이 뜨면 인증번호로 000000을 입력하세요.

또, 실제 카드번호를 검증하지 않습니다. 카드번호의 앞 6자리 또는 8자리만 유효하면 나머지 카드번호, 유효기간, 생년월일은 임의로 넣어도 에러가 발생하지 않습니다.

자동결제를 연동할 준비가 되었나요? 구현 방법을 선택해서 시작하세요.