2. 사용자 인증 받기
OS별 인증 URI로 사용자를 토스 앱에 보내 결제수단을 등록하고 자동 결제를 인증해요.
이 단계에서는 사용자를 토스 앱으로 보내 자동 결제 등록을 인증받아요. 1단계에서 받은 인증 URI로 이동시키면, 결제수단 선택과 인증은 토스 앱이 진행해요.
환경에 맞는 인증 URI로 이동시키기
빌링키 생성 응답에는 인증 URI가 세 개 있어요. 사용자의 접속 환경을 판단해서 맞는 URI로 이동시키세요.
| 응답 필드 | 환경 | 동작 |
|---|---|---|
checkoutAndroidUri | Android | intent:// 스킴으로 토스 앱을 직접 호출해요. |
checkoutIosUri | iOS | 유니버설 링크로 토스 앱을 호출해요. |
checkoutUri | PC 웹 등 그 외 | 토스페이 웹 페이지를 열어요. retAppScheme을 보냈다면 원링크(onelink)로 제공돼요. |
사용자는 토스 앱에서 자동 결제에 사용할 결제수단(토스머니, 카드)을 선택하고 인증을 완료해요. 인증이 끝나면 결제 생성 시 전달한 returnSuccessUrl(실패 시 returnFailureUrl)로 사용자가 이동해요.
curl로 따라 하는 중이라면, 응답의 checkoutUri를 토스 앱이 설치된 휴대폰 브라우저에서 열어 인증을 진행하면 돼요.
테스트도 본인 토스 앱으로 진행해요. 별도 테스트 계정이나 SDK를 제공하지 않으므로, 토스 앱을 설치하고 최신 버전으로 인증을 진행하세요. 테스트용 API Key로 생성한 빌링키는 승인해도 실제 출금이 일어나지 않아요.
가맹점 자체 앱(App to App)에서 등록한다면 retAppScheme을 함께 보내세요. 특히 iOS는 자동으로 앱 전환이 되지
않아서, 인증 완료 후 가맹점 앱으로 복귀시키려면 빌링키 생성 시 retAppScheme이 필요해요. 일반 결제의 App to App
안내와 같은 원리예요.
인증 완료를 화면 이동만으로 판단하지 않기
returnSuccessUrl 이동은 사용자를 완료 화면으로 보내는 용도예요. 빌링키가 실제로 활성화됐는지는 다음 단계에서 다루는 콜백 수신과 상태 조회로 확인해야 안전해요.
다음 단계
사용자가 인증을 마치면 토스가 가맹점 서버로 결과를 알려줘요. 3. 활성화 확인하기로 이동하세요.