테스트하기
계약이 완료되지 않아도 토스인증 테스트 환경에서 인증 연동을 진행해 볼 수 있어요.
먼저 연동을 진행한 뒤 테스트를 수행해 주세요.
테스트 시에는 앱 스토어에서 설치한 최신 버전의 토스앱을 이용하세요.
본인확인과 원터치 인증 방식 모두 테스트가 가능합니다.
테스트 환경
- client_id :
test_a8e23336d673ca70922b485fe806eb2d - client_secret :
test_418087247d66da09fda1964dc4734e453c7cf66a7a9e3
토스 앱 버전
- 토스앱 (본인확인) : 5.233.0 이상
- 토스앱 (원터치 인증) : 5.236.0 이상
getTossAppVersion 함수를 사용하여 토스앱 버전을 체크해보세요.
방화벽 설정
요청 서버의 아웃바운드(Outbound) 설정에 아래 토스인증 IP를 허용해주세요.
모든 통신은 443 포트(HTTPS) 를 사용해요.
토스 인증 서버는 인바운드(Inbound) 가 제한 없이 오픈되어 있어, 별도 설정 없이 바로 통신 테스트를 진행할 수 있어요.
본인확인 IP
- 117.52.3.222
- 117.52.3.235
- 211.115.96.222
- 211.115.96.235
라이브 환경과의 차이점
✅ 인증 사용료 무료
테스트 환경에서는 인증을 성공적으로 완료하더라도 과금되지 않아요.
✅ 테스트 환경 자격증명
테스트 환경의 클라이언트 자격증명(client_id, client_secret) 은 모두 test_ 로 시작해요.
이 접두어(prefix)를 통해 운영 환경 정보와 쉽게 구분할 수 있어요.
✅ Access Token 유효기간
테스트 환경에서는 연동 편의를 위해 1년(31536000초) 유효기간이 적용된 Access Token을 제공해요. 운영 환경에서는 사업자가 신청한 네트워크 방식에 따라 유효기간이 달라질 수 있으니 참고해주세요.
✅ 가상의 개인정보 제공
테스트 환경에서 인증이 완료되면,
토스에 가입된 사용자의 암호화된 개인정보 대신 토스가 생성한 가상 인물의 고정된 개인정보가 전달돼요.
이는 실제 사용자 정보를 보호하기 위한 조치이며,
정확한 사용자 정보가 필요하다면 토스로부터 제공받은 이용기관 고유 키를 사용해 운영 환경과 연동해야 해요.
테스트 환경에서 제공되는 가상 개인정보 예시
- CI :
CI0110000000001 ... - DI :
DI0110000000001 ... - 이름 : 김토스
- 생년월일 : 19930324
- 성별 : FEMALE
- 내외국인 : LOCAL