소개

토스 로그인은 OAuth 2.0 기반의 인증 방식으로, 사용자가 토스 계정을 통해 안전하게 로그인하고 서비스 이용에 필요한 최소한의 사용자 정보를 제공받을 수 있습니다. 로그인 과정에서 사용자에게 어떤 정보 제공에 동의받을지 직접 설정할 수 있어요. 또한 서비스를 운영하는 데 필요한 약관과 동의문, 연결 끊기 콜백 정보도 함께 등록할 수 있어요.

이 문서를 읽고 나면 다음을 알 수 있습니다.

• 토스 로그인이 어떤 서비스인지
• 연동 전에 어떤 준비가 필요한지
• 연동 후 어떤 정보를 받는지

---

인증 방식

항목	내용
프로토콜	OAuth 2.0 Authorization Code Grant
Access Token 형식	JWT (RS256)
Access Token 유효시간	1시간 (3600초)
Refresh Token 유효시간	1일
인가 코드 유효시간	10분
사용자 정보 암호화	AES-256-GCM (IV 앞에 첨부)
인증 헤더	Authorization: Bearer {access_token}

---

토스 로그인의 장점

• 별도의 가입 폼 없이 바로 가입과 로그인이 이뤄져 매끄러운 회원가입 경험을 만들 수 있어요.
• 토스에서 직접 제공하는 신뢰도 높은 사용자 정보를 활용할 수 있어요.
• 재방문할 때 자동 로그인이나 원클릭 로그인이 가능해요.
• 앱을 다시 설치하거나 기기를 바꿔도 같은 사용자로 매칭돼 고객 문의 대응 부담이 줄어들어요.

---

다음 단계

• 연동 준비하기 — Client 등록 절차, Scope, 약관 등록, API 공통 응답 형식을 확인하세요.
• 토스 로그인 API — 인가 코드 발급부터 사용자 정보 조회까지 단계별로 진행하세요.