자동 결제(billing) API

• 공식 문서 : https://docs.tosspayments.com/reference#자동결제

• 자동결제 플로우 이해하기 : https://docs.tosspayments.com/common/glossary/billing

• https://docs.tosspayments.com/guides/billing/overview#자동결제빌링-이해하기 ← 이거 하나 보면 됨

• 결제창 연동
• 자동결제창(토스UI) 연동하기 : https://docs.tosspayments.com/guides/billing/integration ← 이거 하나 보면 됨
• 직접구현한UI에 api 연동하기 : https://docs.tosspayments.com/guides/billing/integration-api

빌링 플로우 이해하기

빌링키 발급

• 빌링키 발급요청 관련 에러 : https://docs.tosspayments.com/reference/error-codes#카드-자동결제-빌링키-발급-요청

• 카드사 코드 목록 : https://docs.tosspayments.com/reference/codes#카드사-코드

Billing 객체

• https://docs.tosspayments.com/reference#billing-객체

자동결제에 사용할 결제수단이 인증되어 등록되었을 때 돌아오는 객체입니다.

• 가맹점 서버에서 고객을 고유하게 식별할 수 있는 커스터머키와, succressUrl, failUrl을 전달해서 카드인증 과정을 거친다.
• requestBillingAuth(’카드’, … )
• successUrl로 Auth 값이 전달됨.
• Auth는 빌링키 발급을 위한 일회용 인증 키
 
• 가맹점 백엔드 서버에서 Auth 일회용 인증 키로, 빌링키 발급 API를 호출하여 빌링키를 발급받음.
• 서버는 커스터머키에 빌링키를 맵핑하여 저장해놓고,
• 가맹점 서버에서 스케줄링 로직을 구현하여 빌링키를 통해 구독결제를 구현하면 됨.