본문으로 건너뛰기

payment

토스페이 정기결제(billing) 흐름을 처리하는 네임스페이스입니다. 현재 requestTossPayPaysBilling 한 가지 메서드를 제공하며, 토스페이에서 billing key를 발급받아 이후 서버 측 정기결제를 실행할 수 있게 해줍니다.

iap 네임스페이스의 checkoutPayment(단건 결제 인증)와는 다른 흐름입니다 — payment는 반복 결제를 위한 billing key 발급 인증을 전담합니다.

메서드​

메서드반환 타입용도
requestTossPayPaysBillingPromise<{ success: boolean; reason?: string } | undefined>토스페이 정기결제 인증창을 띄워 billing key 발급을 요청합니다.

권한​

권한이 필요하지 않습니다 — payment 네임스페이스의 메서드는 별도의 PermissionName에 바인딩되지 않으며, 결제 인증 흐름은 토스 앱 내부에서 처리됩니다.

일반적인 정기결제 등록 흐름​

requestTossPayPaysBilling()   ← billing key 발급 인증
       ↓ success: true
       서버 측 billing key 저장
       ↓
       (이후) 서버 측 정기결제 실행 API 호출

success: true는 사용자가 인증창에서 정기결제 등록에 동의하고 billing key가 발급됐다는 의미입니다. 실제 결제 청구는 서버에서 별도로 진행해야 합니다.

직접 실행해 보기​

sdk-example의 Payment 페이지에서 메서드를 직접 실행해 볼 수 있습니다.

sdk-example에서 실행해 보기

외부 참조​