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

구독 서비스는 API를 사용해서 직접 구축해야 합니다. 1달 주기로 결제가 필요한 상품이면 1달마다 customerKey, 빌링키, 금액을 설정해서 카드 자동결제 승인 API를 호출하면 됩니다. 구현하는 방법이 궁금하다면 구독 결제 서비스 간단히 구현하기시리즈를 참고하세요.

다음 결제일에 구독을 취소한 구매자의 빌링키, customerKey로 카드 자동결제 승인 API를 호출하지 않으면 됩니다.

금액이 바뀌었다면 카드 자동결제 승인 API를 호출할 때 amount 파라미터를 변경된 결제 금액으로 설정하면 됩니다.

결제 주기가 바뀌었다면 카드 자동결제 승인 API를 호출하는 주기를 변경해주세요.

아니요. 토스페이먼츠 자동결제(빌링)는 국내 카드만 지원해요. 토스페이, 카카오페이, 네이버페이와 같은 국내 간편결제는 지원하지 않습니다. PayPal(페이팔)과 같은 해외 간편결제도 지원하지 않습니다.

네 자동결제(빌링)는 토스페이먼츠 JavaScript SDK 또는 API로 모바일에 연동할 수 있습니다. 하지만 React Native, Flutter, Android, iOS 네이티브 SDK는 아직 제공하지 않습니다.

새로운 카드 정보로 빌링키를 다시 발급받으세요. 빌링키를 갱신하는 별도 과정은 없습니다.

카드의 유효성 검사는 제공하지 않습니다. 자동결제에 등록할 카드의 유효성 여부는 빌링키 발급을 요청할 때 카드사를 통해 확인합니다. 만약 유효하지 않다면 에러를 응답합니다. 카드 잔고 부족이나 한도 초과는 결제 승인을 요청할 때 카드사를 통해 확인합니다.

발급된 빌링키를 삭제하는 API는 제공되지 않습니다. 발급된 빌링키가 더 이상 필요하지 않으면 데이터베이스에서 삭제하고 더 이상 사용하지 않으면 됩니다.

혹시 누군가가 빌링키 정보를 알고 있더라도 빌링키와 매칭이되는 customerKey를 모른다면 결제가 불가능합니다. 빌링키를 사용한 결제는 빌링키를 발급할 때 같이 전달된 customerKey와 매핑이 되어있기 때문에, 결제 요청을 할 때 빌링키와 customerKey가 같이 전달되어야 결제가 진행됩니다.

발급된 빌링키를 조회하는 API는 제공되지 않습니다. 빌링키 발급 이후 반드시 안전하게 저장하세요. 만약에 빌링키를 잃어버렸다면 구매자에게 다시 결제 정보를 받아서 같은 카드에 새로운 빌링키를 발급받아주세요. 카드 하나에 여러 개의 빌링키를 중복으로 발급할 수 있어요. 빌링키 중복 발급을 방지하는 방법은 없습니다.