토스 로그인
앱인토스에서 토스 회원을 한 번에 연동해 보세요. 한 번의 동의로 가입부터 로그인, 정보 제공까지 이어져서 토스 회원 연동을 간단하게 구현할 수 있어요.
토스 로그인의 좋은 점
별도의 가입 폼 없이 바로 가입과 로그인이 이뤄져서, 매끄러운 회원가입 경험을 만들 수 있어요.
토스가 직접 제공하는 신뢰도 높은 사용자 정보를 활용할 수 있어요.
재방문할 때 자동 로그인이나 원클릭 로그인을 쓸 수 있어요.
앱을 다시 설치하거나 기기를 바꿔도 같은 사용자로 매칭돼서, 고객 문의 대응 부담이 줄어요.
콘솔에서 설정하기
1. 약관 동의하기
토스 로그인을 쓰려면 먼저 약관에 동의해야 해요. 약관 동의는 앱인토스 콘솔에서 할 수 있고, 대표관리자로 지정된 분의 계정에서만 할 수 있어요.
2. 설정하기
로그인을 연동하려면 콘솔에서 사전 설정을 끝내야 해요. 입력한 정보를 기반으로 사용자 약관 동의 화면이 자동으로 구성돼요.
연동할 서비스
이미 토스 로그인을 쓰고 있는 서비스가 있으면 노출되는 영역이에요. 기존 서비스의 회원 식별자(userKey)를 앱인토스 토스 로그인과 똑같이 설정할 수 있어요. 목록에서 서비스 이름을 선택하면, 선택한 서비스의 userKey 값이 똑같이 매핑돼요.
단, userKey는 해당 앱 안에서만 고유한 값이에요. 같은 사용자라도 앱이 다르면 userKey가 달라질 수 있어요.
동의 항목
토스 로그인으로 수집할 사용자 권한(스코프)을 선택해 주세요. 이름, 이메일, 성별 외의 항목을 선택하면 연결 끊기 콜백 정보를 반드시 입력해야 해요.
이름 (USER_NAME)
사용자의 이름이에요.
이메일 (USER_EMAIL)
사용자의 이메일이에요. (토스 가입 시 필수가 아니라 값이 없을 수 있고, 이 경우 null로 전달돼요.)
성별 (USER_GENDER)
사용자의 성별이에요.
생일 (USER_BIRTHDAY)
사용자의 생년월일이에요.
국적 (USER_NATIONALITY)
사용자의 국적이에요.
전화번호 (USER_PHONE)
사용자의 전화번호예요.
CI (USER_CI)
사용자를 식별하는 고유한 KEY 값이에요. (Connection Information)
토스는 이메일 주소를 꼭 받지는 않아서, 이메일 값이 없는(null) 유저가 있을 수 있어요.
값이 없어도 앱이 정상 작동하도록 처리해주세요.
약관/동의문
앱인토스에서 서비스를 운영하려면 약관을 등록해야 해요. 토스 로그인 필수 약관(서비스 약관, 개인정보 제3자 제공 동의)은 자동으로 포함돼요. 파트너사 서비스 약관, 개인정보 수집·이용 동의, 마케팅 정보 수신 동의(선택) 등은 직접 등록해야 해요. 서비스 목적에 맞는 정확한 약관 링크를 첨부해 주세요.
약관 유형은 기본 제공 예시 중에서 선택하거나 직접 입력할 수 있어요. 약관을 구분해서 관리하고 싶다면 직접 입력하는 걸 추천해요.
해외 클라우드 리전이나 해외 사업자의 서버에 토스 로그인으로 받은 개인정보를 저장하거나 이전한다면, 개인정보 국외 이전 동의문을 필수로 등록해 주세요. 동의문에는 이전받는 자, 이전되는 국가, 이전받는 자의 연락처, 이전 항목, 이전 시점과 방법, 이용 목적, 보유·이용 기간을 포함해야 해요.
모든 약관 링크가 정확히 연결되고, 화면에 명확하게 노출되는지 확인해 주세요.
주의해 주세요
이 영역은 법적 요건을 충족해야 하는 부분이에요. 서비스 성격에 따라 내용이 달라질 수 있으니, 최신 법령과 가이드라인을 확인하고 법률 자문을 받는 것을 권장해요.
연결 끊기 콜백 정보
사용자가 토스 앱에서 로그인 연결을 해제하면, 등록한 콜백 URL로 이벤트를 받을 수 있어요.
사용자가 연결을 해제하면 토스는 동의 약관과 로그인 정보를 모두 삭제해요. 서비스에서도 세션이나 토큰 정리 같은 후처리를 꼭 해 주세요.
또한 사용자가 토스 앱에서 로그인 연결을 해제하면, 서비스에서도 자동 로그아웃 처리나 재로그인 요청 안내를 제공하는 걸 권장해요. 예를 들어 "토스 연결이 해제되어 다시 로그인해야 해요" 같은 문구를 보여주면 좋아요.
콜백 URL
사용자가 로그인 연결을 해제했을 때 호출할 URL이에요.
HTTP 메서드
GET 또는 POST 중 하나를 선택해 주세요.
Basic Auth 헤더
호출할 때 base64로 인코딩돼요. 디코딩한 뒤 콘솔에 입력한 값과 일치하는지 검증해 주세요.
연결 끊기 이벤트 경로
사용자가 토스 앱에서 로그인 연결을 해제하는 경로는 총 3가지예요. 콜백 요청 시 referrer 값으로 구분할 수 있어요.
UNLINK
사용자가 앱에서 직접 연결을 끊었을 때 호출돼요. 미니앱에서는 이 이벤트를 받으면 로그아웃 처리를 해 주세요. (경로: 토스 앱 > 설정 > 인증 및 보안 > 토스로 로그인한 서비스 > '연결 끊기')
WITHDRAWAL_TERMS
사용자가 로그인 서비스 약관을 철회할 때 호출돼요. (경로: 토스 앱 > 설정 > 법적 정보 및 기타 > 약관 및 개인정보 처리 동의 > 서비스별 동의 내용: "토스 로그인" > '동의 철회하기')
WITHDRAWAL_TOSS
사용자가 토스 회원을 탈퇴할 때 호출돼요.
이메일로 복호화 키 받기
토스 로그인 정보 등록이 끝나면 복호화 키를 확인할 수 있어요. 이 키는 토스 로그인 응답 데이터를 복호화할 때 써요. '이메일로 복호화 키 받기' 버튼을 눌러 안전하게 받아보세요.
복호화 키는 민감한 보안 정보예요.
절대 외부에 노출하지 마세요.
안전한 내부 비밀 저장소(Secret Manager 등)에 보관해 주세요.
다시 발급받아야 한다면 채널톡으로 문의해 주세요.
개발 연동하기
인가 코드 발급(SDK), AccessToken 발급, 사용자 정보 조회 등 연동 방법을 확인할 수 있어요.
자체 웹·앱에 토스 로그인 연동하기
자체 웹·앱에 토스 로그인을 적용하려면 원래 토스 인증 부서와 별도 계약이 필요해요. 다만 앱인토스에서 토스 로그인을 쓰는 파트너사라면, 별도 계약 없이도 쓸 수 있어요.
1. 앱인토스 콘솔에서 토스 로그인 신청하기
위 가이드를 확인한 뒤, 앱인토스 콘솔에서 토스 로그인을 먼저 신청해 주세요.
2. 필요한 정보를 작성해 Client ID 발급 요청하기
아래 항목을 모두 작성해 토스 인증 부서(cert.support@toss.im)로 이메일을 보내 주세요.
웹/앱 여부
적용하려는 서비스 형태를 작성해 주세요 (웹, 앱, 또는 둘 다)
웹, 앱
회원 식별 키
사용자 식별에 사용할 키를 작성해 주세요
CI, 이메일
필요한 개인정보 항목
제공받고자 하는 개인정보 항목을 작성해 주세요(앱인토스 콘솔 > 토스 로그인 > 동의 항목을 참고해 주세요)
이름, 이메일 주소
약관 목록
사용할 약관의 제목, URL, 필수 여부를 작성해 주세요
이용약관 (필수) - https://example.com/terms
redirect_uri
로그인 완료 후 이동할 URL을 작성해 주세요
https://example.com/callback
연동 예정 앱 버전
제휴사 앱에도 도입하는 경우 앱 버전을 작성해 주세요
iOS 3.2.0, Android 2.8.1
로그인 연결 끊기 API 사용 여부
해당 API 사용 여부를 작성해 주세요 (미작성 시 '사용 안 함'으로 설정돼요)
사용 안 함
네트워크 정보
VPN을 사용하거나 개발계 연동이 필요한 경우 별도 등록이 필요해요서버의 IP 또는 IP 대역을 작성해 주세요
123.45.67.89