---
url: /docs/authentication/kakao-login-sync.md
description: 게임플레이 입점 파트너사가 카카오싱크 간편가입을 사용하기 위한 앱·채널·동의항목·서비스 약관 설정 방법
---

# 카카오싱크 설정

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

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

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

## 사전 준비

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

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

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

## 디벨로퍼스 앱과 비즈 앱 

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

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

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

### 앱 생성 입력값 

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

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

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

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

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

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

## 비즈니스 채널 연결 

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

채널 생성부터 연결까지의 전체 절차는 [카카오싱크 비즈니스 채널 연결](https://developers.kakao.com/docs/ko/kakaosync/prerequisite#business-channel)을 참고하세요.

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

## 비즈니스 정보 심사 

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

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

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

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

## 카카오 로그인 설정 

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

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

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

## 동의항목 설정 

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

동의항목은 카카오디벨로퍼스의 **\[카카오 로그인] > \[동의항목]** 에서 설정합니다.
설정 방법과 동의 단계의 의미는 [카카오 로그인 동의항목 설정](https://developers.kakao.com/docs/ko/kakaologin/prerequisite#scope-setting)을 참고하세요.

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

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

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

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

### 친구 목록 조회

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

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

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

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

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

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

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

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

구현 방법은 [친구 목록 조회 API](/api-sdk/kakaotalk-social/friends)를 참고하세요.
동의항목과 제공 조건의 전체 정책은 [카카오 로그인 개인정보 동의항목](https://developers.kakao.com/docs/ko/kakaologin/utilize#scope-user)과 [카카오톡 친구 정보 제공 조건](https://developers.kakao.com/docs/ko/kakaotalk-social/common#policy-friend)에서 확인할 수 있습니다.

## 파트너사 약관 동의 설정 

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

### 서비스 약관 구성 

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

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

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

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

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

### 개인정보 제3자 제공 동의문 

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

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

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

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

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

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

## 추가 개인정보 동의항목

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

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

## 운영 적용 전 확인 

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

## 카카오에 전달할 앱 정보 

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

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

## 참고 문서

* [카카오싱크 API](/api-sdk/kakaosync/rest-api): 게임웹뷰 자동 진입과 카카오싱크 가입·로그인 구현 스펙
* [계정 상태 변경 웹훅 연동](/api-sdk/data/terms-withdrawal): 사용자가 앱 연결을 해제했을 때의 콜백 처리
* [심사 체크리스트](/docs/checklist/review-checklist): 인증·동의 자체 점검 항목
* [카카오싱크 설정하기](https://developers.kakao.com/docs/ko/kakaosync/prerequisite): 카카오 공식 사전 준비 문서
* [카카오싱크 개발 가이드](https://developers.kakao.com/docs/ko/kakaosync/dev-guide): 카카오 공식 연동 개발 문서