<aside> 💡

이 가이드는 앱인토스용 토스로그인 연동 방법을 안내해드리기 위하여 작성되었습니다. 앱인토스가 아닌 제휴사 자체앱/웹에서 토스로그인 연동을 하시려면 ‘제휴사 자체앱/웹용 연동 가이드 문서’를 참고하시기 바랍니다.)

</aside>

1. 개요

1.1 연동 시작하기

사전에 등록해주셔야 하는 정보

연동을 위해 Client 등록이 필요합니다. 콘솔에서 등록해주세요.

목록 비고
1 회원 관리 키 CI, e-mail, 휴대폰번호 등
2 필요한 개인정보 목록 2.2 Scope 목록 참고
3 로고 이미지 원형, 600px x 600px 권장
4 약관 목록 약관 제목과 약관 URL, 필수여부
5 redirect_uri 완료 후 보내질 화면 URI
6 로그인 연결 끊기 API 사용 유무 default는 사용안함으로 설정됨

2. 공통 정보

연동 프로세스 이해하기

sequenceDiagram
	participant USER as 사용자
	participant 앱인토스 가맹점 as 가맹점
	participant client 패키지 as 앱인토스 SDK
	participant 앱인토스 서버 as 앱인토스 server
	participant 토스앱
	
	USER->>앱인토스 가맹점:로그인 요청
	앱인토스 가맹점->>client 패키지 : 인가코드 받기
	client 패키지 ->> 토스앱 : OAuth 인증 요청
	토스앱 ->> 토스앱 : 약관 동의 창 노출
	USER<<-->>토스앱 : 약관 동의
	토스앱->>client 패키지 : 약관 동의 결과 전달
	client 패키지 ->> 앱인토스 가맹점 : 인가코드, referrer 응답
	앱인토스 가맹점->>앱인토스 서버 : AccessToken 받기
	앱인토스 서버 ->> 앱인토스 가맹점 : AccessToken, refreshToken 응답
	앱인토스 가맹점->>앱인토스 서버 : 사용자 정보 받기
	앱인토스 서버 ->> 앱인토스 가맹점 : userKey 응답
	앱인토스 가맹점 ->> USER : 로그인 처리