카카오싱크 설정

게임플레이에 입점하는 파트너사는 카카오 로그인과 카카오싱크 간편가입을 사용해 사용자 인증과 동의를 처리해야 합니다.
이 문서는 카카오싱크 연동 전 카카오디벨로퍼스에서 완료해야 하는 앱, 채널, 동의항목, 서비스 약관 설정을 안내합니다.

실제 인가 코드 요청부터 토큰 발급, 회원 등록, 서비스 세션 생성까지의 구현 방법은 카카오싱크 API를 참고하세요.

담당	준비 항목	확인할 내용
사업·법무	비즈니스 정보, 서비스 약관, 개인정보 동의문	서비스에 적용할 약관과 개인정보 제공 항목 검토
기획·운영	간편가입 동의 화면, 만 14세 이상 연령 동의	가입 과정과 사용자 안내 문구 검토
개발	디벨로퍼스 앱, 카카오 로그인, Redirect URI, API	앱 설정 완료 후 카카오싱크 API 연동

사전 준비

카카오싱크 연동 전 아래 항목을 순서대로 완료합니다.

순서	설정 항목	적용 여부
1	디벨로퍼스 앱 생성과 비즈 앱 전환	필수
2	비즈니스 채널 생성과 비즈 앱 연결	필수
3	비즈니스 정보 심사	필수
4	카카오 로그인 활성화와 Redirect URI 등록	필수
5	카카오 로그인 동의항목 설정	필수
6	서비스 약관 등록과 간편가입 활성화	필수
7	추가 개인정보 동의항목 심사	필요한 경우
8	테스트 앱과 운영 앱 설정 확인	권장

설정 순서는 앱 생성 → 비즈 앱 전환 → 비즈니스 채널 연결 → 동의항목 설정 → 필요한 항목 심사 요청입니다.
비즈니스 채널이 없다면 먼저 채널을 생성하고 비즈니스 채널 심사를 완료하세요.

디벨로퍼스 앱과 비즈 앱 필수

파트너사 단위로 카카오디벨로퍼스 앱을 생성하고 사업자 정보를 등록해 비즈 앱으로 전환합니다.
앱 이름, 아이콘, 회사명은 카카오싱크 동의 화면에 표시되므로 실제 서비스 정보와 일치해야 합니다.

이미 같은 서비스에서 카카오 로그인이나 카카오 API를 사용 중이라면 기존 앱을 사용하세요.
새 앱을 생성하면 기존 앱의 설정과 회원번호가 이어지지 않아 사용자가 다시 가입해야 할 수 있습니다.

게임플레이 입점 앱 생성 기준

디벨로퍼스 앱은 게임별이 아닌 파트너사 단위로 1개를 생성합니다.
게임플레이 입점 파트너사는 사전 협의에 따른 예외 심사 대상으로 처리됩니다.

앱 생성 입력값 필수

새 앱을 생성할 때 파트너사와 운영 게임을 식별할 수 있도록 아래 기준으로 입력합니다.

입력 항목	설정 기준
앱 이름	파트너사명을 입력합니다.
회사명	게임플레이 제휴 계약과 카카오 담당자에게 전달한 법인·사업자명과 동일하게 입력합니다.
카테고리	엔터테인먼트를 선택합니다.
앱 대표 도메인	동의 화면 등에 표시되는 앱 기본 정보입니다. 파트너사 서비스의 대표 도메인을 입력합니다.

앱을 생성한 뒤 카카오디벨로퍼스의 앱 설정에서 앱 ID를 확인해 카카오 담당자에게 전달하세요.
카카오가 앱 ID와 회사 정보를 등록하면 게임플레이 파트너센터오픈 예정에서 등록된 값을 확인할 수 있습니다.

아래 화면과 같이 앱 정보를 입력합니다.

앱 대표 도메인은 동의 화면 등에 표시되는 앱 기본 정보이며 호출을 허용할 도메인 목록이 아닙니다.
게임 실행 도메인은 아래 두 곳에 각각 등록합니다.

등록 위치	용도
[앱] > [플랫폼 키] > [JavaScript 키] > [JavaScript SDK 도메인]	카카오 JS SDK 호출을 허용할 도메인입니다.
[앱] > [제품 링크 관리] > [웹 도메인]	카카오 제품 링크에서 사용할 웹 도메인입니다.

비즈니스 채널 연결 필수

파트너사의 카카오톡 채널이 없다면 카카오톡 채널 관리자센터에서 채널을 먼저 생성합니다.
생성한 채널을 비즈니스 채널로 전환한 뒤 비즈 앱과 연결합니다.
앱과 채널의 사업자 정보가 일치해야 연결 심사를 통과할 수 있습니다.

채널 생성부터 연결까지의 전체 절차는 카카오싱크 비즈니스 채널 연결을 참고하세요.

채널 추가 동의항목을 카카오싱크 동의 화면에 표시하려면 연결한 채널을 대표 채널로 설정합니다.
대표 채널을 설정하지 않으면 동의 화면에 채널 추가 항목이 표시되지 않습니다.

비즈니스 정보 심사 필수

카카오디벨로퍼스의 [앱] > [추가 기능 신청] > [비즈니스 정보] 에서 심사를 신청합니다.
비즈 앱과 비즈니스 채널이 정상적으로 연결되어 있으면 비즈니스 정보 심사가 자동 승인될 수 있습니다.

추가 개인정보 동의항목 심사가 필요한 경우 심사 사유에 아래 문구를 입력합니다.

카카오톡 게임플레이 입점 관련 사항으로 사전에 협의 완료

심사 과정에서 문제가 발생하면 카카오 담당자에게 앱 ID와 반려 사유를 전달하세요.

카카오 로그인 설정 필수

카카오싱크는 카카오 로그인을 기반으로 동작하므로 다음 설정을 완료해야 합니다.

설정	기준
카카오 로그인 사용 설정	[카카오 로그인] > [일반] > [사용 설정] 에서 상태를 ON으로 설정합니다.
Redirect URI	인가 코드를 전달받을 파트너사 서버 URI를 등록합니다.
클라이언트 시크릿	REST API 키는 클라이언트 시크릿이 활성화된 상태로 발급됩니다. 토큰 요청에 client_secret을 포함하세요.
로그인 시 앱 자동 연결	별도 협의가 없다면 기본값인 자동 연결을 사용합니다.

Redirect URI는 게임플레이 서버 도메인 등록과 별개의 설정입니다.
인가 코드 요청에 전달하는 값과 디벨로퍼스에 등록한 값이 정확히 일치해야 합니다.

동의항목 설정 필수

카카오로부터 제공받을 사용자 정보와 기능만 동의항목으로 설정합니다.
서비스에 필요하지 않은 정보는 동의받지 않고, 서비스 이용 중 필요한 시점에 추가 동의를 요청하는 것을 권장합니다.

동의항목은 카카오디벨로퍼스의 [카카오 로그인] > [동의항목] 에서 설정합니다.
설정 방법과 동의 단계의 의미는 카카오 로그인 동의항목 설정을 참고하세요.

아래의 동의항목은 카카오가 파트너사에 제공하는 정보에 대한 설정입니다.
뒤에서 안내하는 파트너사가 카카오에 제공하는 개인정보 제3자 제공 동의와 구분하세요.

항목	설정 기준	설명
회원번호	자동 제공	사용자 정보 조회 응답의 id로 제공됩니다.
닉네임·프로필 사진	필수	게임플레이 게임 프로필 정보 연동에 사용합니다.
카카오 서비스 내 친구목록	선택 동의	친구 목록 조회 또는 친구 피커를 사용할 때 신청합니다. 개인정보 동의항목 추가 기능 신청이 필요하며, 위의 비즈니스 정보 심사와는 다른 절차입니다.
카카오톡 채널 추가 상태 및 내역	선택	대표 채널을 설정하고 채널 관계 확인이 필요할 때 사용합니다.
그 외 개인정보	협의 후 신청	제공 목적과 활용 화면을 준비해 개인정보 동의항목 추가 기능 심사를 신청합니다.
CI·배송지 정보·카카오계정 상태 변경 내역	불가	게임플레이 입점 계약 범위에서 제공하지 않습니다.

닉네임·프로필 사진 항목을 동의받아야 추후 게임 프로필 정보를 연동하여 사용할 수 있습니다.

연령대, 생일, 출생 연도는 게임 이용 등급 가능 대상을 판단하는 수단으로 사용할 수 없습니다.
연령 확인이 반드시 필요하면 파트너사가 별도 본인확인 절차를 구현합니다. 카카오 담당자와 협의하세요.

친구 목록 조회

친구 랭킹 등 친구 정보를 사용하는 기능을 제공하려면 카카오 서비스 내 친구목록(프로필사진, 닉네임, 즐겨찾기 포함) 동의항목의 사용 권한을 신청합니다.
사용 권한을 받은 뒤 카카오디벨로퍼스의 **[카카오 로그인] > [동의항목]**에서 동의 단계를 선택 동의로 설정하세요.

항목	기준
동의항목 ID	friends
지원 동의 단계	선택 동의
제공 정보	회원번호, 메시지 전송용 사용자 고유 ID, 닉네임, 프로필 썸네일, 즐겨찾기 여부

이 항목은 사용자가 가입할 때 동의하지 않아도 가입을 완료할 수 있습니다.
가입할 때 동의하지 않았거나 최초 게임 출시 시점에 항목을 설정하지 않았다면, 친구 기능을 처음 사용하는 시점에 scope=friends로 추가 동의를 요청하세요.
추가 동의를 완료한 뒤 친구 목록을 조회할 수 있으며, 사용자가 동의를 취소하면 친구 기능 없이 서비스를 계속 이용할 수 있도록 처리해야 합니다.

친구 목록과 친구 피커에는 아래 조건을 모두 만족하는 친구만 표시됩니다.

제공 조건	설명
친구 관계	조회 사용자와 카카오톡 친구 관계여야 합니다.
파트너사 앱 가입	조회 사용자와 친구 모두 같은 파트너사 앱에 연결된 사용자여야 합니다.
쌍방 동의	조회 사용자와 친구 모두 friends 동의항목에 동의한 상태여야 합니다.
공개 상태	친구가 숨김 또는 차단 상태가 아니고, 프로필 공개 설정이 공개 상태여야 합니다.

따라서 파트너사 앱 가입자라도 어느 한쪽이 동의하지 않았다면 친구 정보로 제공되지 않습니다.
제공되는 친구 수는 사용자의 실제 카카오톡 친구 수와 다를 수 있습니다.

파트너사는 기능에 따라 친구 목록 API와 친구 피커 중 하나를 선택할 수 있습니다.

제공 방식	적합한 기능	특징
친구 목록 API	게임 결과와 연계한 친구 랭킹처럼 파트너사가 친구 목록 UI와 데이터를 직접 구성하는 기능	제공 조건을 만족하는 친구 목록을 API 응답으로 받습니다.
친구 피커	사용자가 특정 친구를 직접 선택하는 기능	파트너사 앱을 이용 중이며 친구 목록 제공에 동의한 친구만 카카오가 제공하는 피커에 표시됩니다.

구현 방법은 친구 목록 조회 API를 참고하세요.
동의항목과 제공 조건의 전체 정책은 카카오 로그인 개인정보 동의항목과 카카오톡 친구 정보 제공 조건에서 확인할 수 있습니다.

파트너사 약관 동의 설정 필수

파트너사가 서비스 가입 과정에서 사용자에게 동의받아야 하는 약관 항목을 구성합니다.
카카오디벨로퍼스의 서비스 약관 기능을 활용해 **[카카오 로그인] > [간편가입]**에서 설정할 수 있습니다.
각 약관에는 제목, 약관 URL, 동의 단계, 서비스 서버에서 식별할 태그를 설정합니다.
자세한 설정 방법은 카카오 로그인 서비스 약관 설정을 참고하세요.

서비스 약관 구성 필수

아래 네 개 약관을 모두 등록하고 약관명도 표와 동일하게 입력합니다.
서비스 이용약관, 개인정보 제3자 제공 동의, 개인정보 수집 및 이용 세 건은 [서비스 약관 추가]로 등록하고, 만 14세 이상 연령 동의는 같은 [카카오 로그인] > [간편가입] 화면의 [만 14세 이상 연령 동의 추가]로 등록합니다.

약관명	동의 단계	설명
서비스 이용약관	필수	파트너사 서비스 이용 조건입니다.
개인정보 제3자 제공 동의	필수	카카오에서 파트너사로 개인정보를 제공하기 위한 동의입니다. 카카오에서 동의문을 제공합니다.
개인정보 수집 및 이용	필수	서비스 가입에 필요한 개인정보의 수집·이용 동의입니다.
만 14세 이상 연령 동의	필수	게임플레이 가입 가능 연령 확인을 위한 약관입니다.

등록한 약관의 사용 설정을 ON으로 변경한 뒤 간편가입 사용 설정도 ON으로 변경합니다.
간편가입을 활성화하려면 사용 중인 서비스 약관이 하나 이상 있어야 합니다.

선택적으로 수집하는 개인정보가 있다면 개인정보 수집 및 이용 약관을 별도로 추가합니다.
필요한 정보만 동의 항목으로 구성하고 서비스 제공에 필요하지 않은 정보는 수집하지 않습니다.

만 14세 이상 연령 동의의 동의 단계를 필수로 설정하면 만 14세 미만 사용자는 동의할 수 없어 간편가입이 중단됩니다.

개인정보 제3자 제공 동의문 필수

파트너사에서 카카오로 개인정보를 제공하기 위한 동의문은 카카오가 제공하는 페이지를 사용합니다.
id 파라미터의 {APP_ID}를 파트너사 디벨로퍼스 앱 ID로 바꾸세요.

https://gameplay.kakao.com/html/partner-terms/index.html?id={APP_ID}

이 동의문은 카카오톡 게임플레이가 사용자의 게임별 이용 데이터를 제공받아 분석과 서비스 제공에 이용하기 위한 약관입니다.
파트너사는 별도 동의문을 제작하지 않고 위 URL을 서비스 약관의 약관 URL로 등록해야 합니다.

동의문은 아래 항목으로 구성됩니다.
제공하는 자에는 실제 파트너사명을 표시하고 나머지 항목은 제공 페이지의 문구를 사용합니다.

구성 항목	표시 내용
제공하는 자	해당 파트너사명
제공받는 자	카카오
필수 제공 항목	참여 내역, 점수 등 게임 서비스 이용 기록
제공 목적	카카오톡 게임플레이 내 게임 진행 현황·랭킹 등 서비스 제공, 맞춤형 콘텐츠 제공과 서비스 기능 개선
보유·이용 기간	동의 철회 또는 서비스 탈퇴 시까지 보관 후 파기. 관련 법령에 따른 보관 의무가 있으면 해당 기간까지 보관 후 파기

아래는 사용자가 확인하는 개인정보 제3자 제공 동의문 예시입니다.
실제 화면의 제공 항목과 문구는 계약 및 운영 정책에 따라 달라질 수 있습니다.

추가 개인정보 동의항목

기본적으로 설정할 수 없는 개인정보 또는 필수 동의 단계를 사용하려면 개인정보 동의항목 추가 기능을 신청합니다.
각 항목의 제공 목적, 서비스 내 활용 화면, 개인정보 처리방침을 준비하고 승인된 범위만 설정하세요.

테스트 앱에서는 운영 앱 심사 전에 일부 동의항목을 확인할 수 있습니다.
테스트 앱의 앱 키와 설정은 운영 앱에 자동 반영되지 않으므로 운영 적용 전에 앱 키, Redirect URI, 동의항목, 서비스 약관을 다시 확인해야 합니다.

운영 적용 전 확인 필수

• [ ] 운영 앱에서 카카오 로그인과 간편가입 사용 설정이 ON인지 확인합니다.
• [ ] 앱 이름·회사명·대표 도메인이 입점 정보와 일치하는지 확인합니다.
• [ ] 비즈 앱과 비즈니스 채널 연결 및 필요한 심사가 완료됐는지 확인합니다.
• [ ] 운영 Redirect URI와 인가 코드 요청에 전달하는 redirect_uri 값이 정확히 일치하는지 확인합니다.
• [ ] 가입에 필요한 사용자 정보가 없는 경우의 대체 입력 또는 가입 중단 정책을 확인합니다.
• [ ] 선택 동의 거부 사용자가 서비스 정책에 맞게 가입 또는 로그인되는지 확인합니다.
• [ ] 테스트 앱에서 개발했다면 운영 앱에 설정과 앱 키를 다시 반영했는지 확인합니다.

카카오에 전달할 앱 정보 필수

설정을 완료한 뒤 아래 정보를 카카오 담당자에게 전달합니다.

항목	설명
앱 ID	카카오디벨로퍼스에서 발급된 앱 ID입니다.
앱 이름	카카오싱크 동의 화면에 표시되는 앱 이름입니다.
회사명	사업자 등록증과 비즈 앱에 등록한 회사명입니다.

참고 문서

• 카카오싱크 API: 게임웹뷰 자동 진입과 카카오싱크 가입·로그인 구현 스펙
• 계정 상태 변경 웹훅 연동: 사용자가 앱 연결을 해제했을 때의 콜백 처리
• 심사 체크리스트: 인증·동의 자체 점검 항목
• 카카오싱크 설정하기: 카카오 공식 사전 준비 문서
• 카카오싱크 개발 가이드: 카카오 공식 연동 개발 문서