콘솔 가이드

토스 로그인을 원활히 사용하려면 콘솔에서 계약 → 설정 → 검토 승인 순서로 진행해 주세요.

계약하기

토스 로그인 사용을 위해 계약이 필요해요.
계약은 콘솔에서 진행하며, 대표관리자만 수행할 수 있어요.

설정하기

로그인 연동을 위해서는 콘솔에 사전 설정을 완료해 주세요.
입력한 정보를 바탕으로 사용자 약관 동의 화면이 자동 구성돼요.
설정이 끝나면 검토 요청을 눌러 주세요. 평균 3 영업일 내 승인해드려요.

기존 로그인과 연동하기 (Client ID 매핑)

이미 자체 앱/웹 로그인을 사용 중이라면, 앱인토스 토스 로그인과 userKey를 동일하게 맞출 수 있어요.

• 목록에서 Client ID를 선택하면 토스 로그인 성공 시 자체 로그인 userKey와 동일한 값으로 내려가요.
• userKey는 회원별 유니크 식별자라서 통합 회원 관리에 유용해요.

추후 파트너사 로그인을 쓰고 싶다면?

파트너사 앱/웹 로그인용 Client ID를 발급받아 콘솔에서 연동하세요.
토스 로그인에서도 동일한 userKey를 사용할 수 있어요.

사용자 권한 범위 설정

토스 로그인을 통해 수집할 권한(스코프) 을 선택해 주세요.

• 이름(USER_NAME) : 사용자의 이름
• 이메일(USER_EMAIL) : 사용자의 이메일로 토스 가입 시 필수사항이 아니기 때문에 값이 존재하지 않을 수 있어요. 그럴 경우 null로 전달드려요.
• 성별(USER_GENDER) : 사용자의 성별
• 생일(USER_BIRTHDAY) : 사용자의 생년월일
• 국적(USER_NATIONALITY) : 사용자의 국적
• 전화번호(USER_PHONE) : 사용자의 전화번호
• CI(USER_CI) : 사용자를 식별하는 KEY값인 CI(Connection Information)

약관 설정

앱인토스에서 서비스 운영을 위한 약관을 등록해 주세요.
토스 로그인 필수 약관(서비스 약관/개인정보 제3자 제공 동의) 은 자동 포함돼요.
다만, 파트너사 서비스 약관/개인정보 수집·이용 동의/마케팅 정보 수신 동의(선택) 는 직접 등록해야 해요.
목적에 맞는 정확한 약관 링크를 첨부해 주세요.

연결 끊기 콜백

사용자가 토스앱에서 로그인 연결을 해제하면, 설정한 콜백 URL로 이벤트를 받아 처리할 수 있어요.

참고하세요

사용자가 연결 해제를 하면 토스는 동의 약관·로그인 정보를 모두 삭제해요.
서비스 측에서도 세션/토큰 정리 등 후처리를 해 주세요.

개발 키 확인

토스 로그인 승인 후 개발 키를 확인할 수 있어요. 복호화 키는 ‘이메일로 키 받기’ 버튼으로 수신해 주세요.

• Client ID
• 복호화 키

토스 로그인 검토 체크리스트

다음 항목을 지키지 않으면 검토 반려될 수 있어요.
제출 전 한 번 더 점검해 주세요.

1. 기본 정보

• Client ID, 앱 로고, 다크모드 로고(선택), 홈페이지 주소(선택) 가 올바르게 입력됐나요?
• Client ID는 앱 정보 승인 후 자동 생성돼요.

2. 권한

각 항목을 필수/선택/사용 안 함으로 적절히 설정했나요?

• 이름(user_name) / 이메일(user_email) / 성별(user_gender) / 생일(user_birthday)
• 국적(user_nationality) / 전화번호(user_phone) / CI(user_ci)

3. 연결 끊기 콜백

• 콜백 On/Off 설정이 적절한가요?
• 해제 시 후처리(세션 종료, 동의 철회 반영 등) 로직이 준비되어 있나요?

4. 약관

주의하세요

아래 항목은 법적 준수가 필요한 영역이에요.
서비스 특성에 따라 내용이 달라질 수 있으니 최신 법령/가이드라인 확인 및 법률 자문을 권장해요.

• (1) 서비스 이용약관: 권리·의무, 책임 범위, 중단/종료, 분쟁 해결, 약관 변경 고지, (유료 시) 결제/환불 규정
• (2) 개인정보 수집·이용 동의: 수집 항목, 이용 목적, 보유·이용 기간, 동의 거부 시 불이익
• (3) 마케팅 정보 수신 동의(선택): 수집 항목, 이용 목적, 보유 기간, 거부 시 불이익, 전자적 전송매체 광고 수신 동의
• (4) 야간 혜택 수신 동의(선택): 야간(21:00~08:00) 발송 여부 명시

모든 약관 링크가 정확히 연결되고, 화면에 명확하게 노출되는지 확인해 주세요.