> For the complete documentation index, see [llms.txt](https://help.qshop.ai/customer_support/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.qshop.ai/customer_support/guide/setting/member/social/kakao.md).

# 카카오 로그인

국내 사용자들이 가장 많이 사용하는 SNS 중 하나인 카카오 계정으로 보다 쉽게 사이트에 회원가입 및 로그인을 할 수 있습니다.

## 1. 어플리케이션 생성

1-1. [Kakao Developers](https://developers.kakao.com/)에 접속합니다.

1-2. 오른쪽 위 **\[로그인]**버튼을 클릭해 카카오 계정으로 로그인 합니다.

1-3. 상단 메뉴의 **\[앱]** 메뉴를 클릭합니다.

<figure><img src="/files/ArBAl0nzZYxEd8FG0w1U" alt=""><figcaption></figcaption></figure>

1-4. 오른쪽 위 **\[+앱 생성]**&#xBC84;튼을 클릭합니다.

<figure><img src="/files/YViLfknyaAt6toXbwZKy" alt=""><figcaption></figcaption></figure>

1-5. 모든 정보를 입력한 후 **\[저장]**&#xBC84;튼을 눌러 애플리케이션 생성을 합니다.

<figure><img src="/files/lCIxUwS6GSKtSkSW2Jhe" alt=""><figcaption></figcaption></figure>

<table><thead><tr><th width="116">항목</th><th>설명</th></tr></thead><tbody><tr><td><strong>앱 아이콘</strong></td><td>로고와 같은 사이트의 정체성이 담긴 아이콘을 등록합니다.</td></tr><tr><td><strong>앱 이름</strong></td><td>사이트 이름 또는 브랜드 이름을 입력합니다.</td></tr><tr><td><strong>사업자명</strong></td><td><p>사업자 정보와 동일한 상호 또는 법인, 또는 단체명을 입력합니다.</p><ul><li>사업자가 없을 경우 앱 이름과 동일한 명칭을 입력합니다.</li></ul></td></tr><tr><td><strong>카테고리</strong></td><td>사업자의 판매 카테고리를 선택합니다.</td></tr></tbody></table>

1-6. 생성 된 애플리케이션을 클릭하여,이후 과정을 진행합니다.

<figure><img src="/files/rreksbYEUUCJHeEFmT0D" alt=""><figcaption></figcaption></figure>

## 2. 비즈 앱 전환

비즈 앱은 이후 진행 될 사용자 정보 수집을 위해 필수로 진행이 되어야하는 과정입니다.\
비즈 앱 설정이 되지않을 경우 이후 과정 진행이 불가하며, 나아가 차후 카카오 채널 연동 및 카카오 싱크 사용이 불가능합니다.

### 2-1. 사업자 정보 등록하기

이 과정을 진행하기 위해서는 사업자 등록 정보가 필요합니다. \
만약 사업자 정보가 없을 경우 아래 **\[2-2. 개인 개발자 비즈 앱 전환]** 가이드를 참고해주세요.

2-1-1. **\[앱 설정 > 앱 > 일반]** 페이지 비즈니스 정보 항목의 **\[사업자 정보 등록]**&#xBC84;튼을 클릭합니다.

<figure><img src="/files/rVlbDRAbTzcb79Xotbfk" alt=""><figcaption></figcaption></figure>

2-1-2. 사이트에 등록 된 사업자 정보와 동일한 사업자 정보를 입력합니다.

<figure><img src="/files/5vyYnCTdkZ2PNptaY0T6" alt=""><figcaption></figcaption></figure>

2-1-3. 검색 된 사업자 정보 확인 후 **\[저장]**&#xBC84;튼을 클릭합니다.

<figure><img src="/files/oXcyFVzjnbSHD9L7Zudx" alt=""><figcaption></figcaption></figure>

### 2-2. 개인 개발자 비즈 앱 전환하기

사업자 등록 정보가 없을 경우 아래 과정을 통해 비즈 앱 전환이 가능합니다. 개인 개발자 비즈 앱 전환을 위해서는 카카오 계정의 본인인증이 진행이 되어야하기에 진행 전 본인인증 여부를 확인 부탁드립니다.

{% hint style="info" %}
[Kakao Developers](https://developers.kakao.com/) 로그인 후 오른쪽 위 프로의 **\[계정 설정 > 본인인증]** 페이지를 통해 본인인증이 가능합니다.
{% endhint %}

2-2-1. **\[앱 설정> 앱 > 일반]** 페이지 비즈니스 정보 항목의 **\[개인 개발자 비즈 앱 전환]**&#xBC84;튼을 클릭합니다.

<figure><img src="/files/IU628l7jUaMhHtOQCKnW" alt=""><figcaption></figcaption></figure>

2-2-2. 비즈 앱 전환 목적 항목을 **\[이메일 필수 동의]**&#xB85C; 선택한 후 **\[저장]**&#xC744; 클릭 합니다.

<figure><img src="/files/pLnAwu9qHOWZJ8UDUX8M" alt=""><figcaption></figcaption></figure>

## 3. 동의항목 설정

3-1. **\[제품설정 > 카카오 로그인 > 동의항목]** 페이지로 이동합니다.

3-2. [\[관리자페이지 > 상점설정 > 회원가입\]](/customer_support/guide/setting/member/join.md)의 기본로그인 페이지의 가입 폼을 통해 설정한 항목과 동일하게 설정합니다. 각 항목의 오른쪽 **\[설정]**&#xBC84;튼을 클릭하여 설정이 가능합니다.

{% hint style="info" %}
일부 항목은 사업자 정보가 입력 된 비즈앱과 비즈채널이 연결되어야 선택 동의 항목으로 사용이 가능합니다.
{% endhint %}

<figure><img src="/files/Dp0dEJ6xxyH7XTAC0xop" alt=""><figcaption></figcaption></figure>

<table><thead><tr><th width="185">항목</th><th width="379">내용</th><th width="85">필수</th><th>선택</th></tr></thead><tbody><tr><td><strong>닉네임</strong></td><td>현재 지원되지 않는 항목 입니다.</td><td>-</td><td>O</td></tr><tr><td><strong>프로필 사진</strong></td><td>현재 지원되지 않는 항목 입니다.</td><td>-</td><td>O</td></tr><tr><td><strong>카카오계정</strong><br><strong>(이메일)</strong></td><td>사이트에서 <strong>이메일 주소</strong>를 받는 경우 선택합니다.</td><td>필수</td><td>-</td></tr><tr><td><strong>이름</strong></td><td>사이트에서 <strong>회원의 이름</strong>을 받는 경우 선택합니다.</td><td>-</td><td>O</td></tr><tr><td><strong>성별</strong></td><td>사이트에서 <strong>성별</strong>을 받는 경우 선택합니다.</td><td>-</td><td>O</td></tr><tr><td><strong>연령대</strong></td><td>현재 지원되지 않는 항목 입니다.</td><td>미지원</td><td>미지원</td></tr><tr><td><strong>생일</strong></td><td>사이트에서 <strong>생년월일</strong>을 받는 경우 선택합니다.</td><td>-</td><td>O</td></tr><tr><td><strong>출생연도</strong></td><td>사이트에서 <strong>생년월일</strong>을 받는 경우 선택합니다.</td><td>-</td><td>O</td></tr><tr><td>카카오계정<br>(전화번호)</td><td>사이트에서 <strong>휴대폰번호</strong>를 받는 경우 선택합니다.</td><td>-</td><td>O</td></tr><tr><td>CI(연계정보)</td><td>현재 지원되지 않는 항목 입니다.</td><td>미지원</td><td>미지원</td></tr><tr><td>카카오 서비스 <br>내 친구 목록</td><td>현재 지원되지 않는 항목 입니다.</td><td>미지원</td><td>미지원</td></tr><tr><td>카카오톡 채널 <br>추가 상태 및 내역</td><td>현재 지원되지 않는 항목 입니다.</td><td>미지원</td><td>미지원</td></tr><tr><td>배송지 정보</td><td>상품 구매 시 등록 될 배송지 정보입니다.</td><td>-</td><td>O</td></tr><tr><td>보안 이벤트 <br>정보 제공</td><td>현재 지원되지 않는 항목 입니다.</td><td>미지원</td><td>미지원</td></tr></tbody></table>

3-3. 동의 항목 설정 시 항목에 따라 정보를 수집하는 목적을 필수로 기재해야합니다. \
예를 들어, **“카카오 간편 로그인을 통한 사용자 가입 편의성 제공”** 등의 내용으로 기재를 해주시면 됩니다.

{% hint style="info" %}
일부 정보에서 \[카카오 계정으로 정보 수집 후 제공] 항목이 있다면 체크를 합니다.
{% endhint %}

<figure><img src="/files/1Ccrc8LzgkP7yHqerNiL" alt=""><figcaption></figcaption></figure>

## 4. 카카오 로그인 활성화

4-1. **\[제품 설정 > 카카오 로그인 > 일반]** 페이지로 이동합니다.

4-2. 사용 설정의 상태 토글을 ON으로 설정합니다.

<figure><img src="/files/kjYQvsySq9MCGr350HgH" alt=""><figcaption></figcaption></figure>

## 5. Redirect URL 설정

5-1. **\[앱 설정 > 앱 > 플랫폼 키]** 페이지의 REST API 키를 클릭합니다.

<figure><img src="/files/A4S1DFJ1iAYBfbRU6Qr5" alt=""><figcaption></figcaption></figure>

5-2. 리다이렉트 URL을 입력 후, 클라이언트 시크릿 부분은 모두 OFF로 설정 후 저장합니다.

리다이렉트 URL은 등록한 도메인 뒤 **api/auth/social/kakao/callback**을 입력해 주시면 됩니다.

{% hint style="info" %}
커스텀 도메인이 있다면 +버튼을 클릭하여 2개의 URL을 입력해 주세요.&#x20;

예: <https://mydomain.qshop.ai/api/auth/social/kakao/callback>

<https://mydomain.com/api/auth/social/kakao/callback>
{% endhint %}

<figure><img src="/files/K4BX6YIXoORbYLoV29Vi" alt=""><figcaption></figcaption></figure>

5-3. JavaScript 키를 클릭합니다.

<figure><img src="/files/rdB9zyq2jeiEN1EL6WsR" alt=""><figcaption></figcaption></figure>

5-4. JavaScript SDK 도메인과 카카오 로그인 리다이렉트 URL을 입력해 주세요.

마찬가지로 커스텀 도메인이 있다면 +버튼을 클릭하여 2개의 URL을 입력해 주셔야 합니다.

<figure><img src="/files/EdUAv9GL5wNgOjAqWQ2t" alt=""><figcaption></figcaption></figure>

## 6. 연동하기

6-1. **\[REST API 키]**&#xC640; **\[JavaScript 키]**&#xB97C; 복사합니다.

<figure><img src="/files/9orAg4u3SVxNRdfUivFH" alt=""><figcaption></figcaption></figure>

6-2. 큐샵 관리자페이지로 돌아와서 **\[상점설정 > 회원가입 - 소셜로그인]**&#xC5D0; 들어갑니다.

6-3. Kakao 로그인 **\[사용함]** 체크 후 위 **6-1.**&#xC5D0;서 복사한 값을 입력 후 **\[저장하기]**&#xB97C; 클릭합니다.

<figure><img src="/files/NnpnQJOfOgUOKAUqNJ6o" alt=""><figcaption></figcaption></figure>

6-4. 모든 과정이 완료되었습니다.\
이제 카카오 로그인을 사용할 수 있습니다.

<figure><img src="/files/06QCiakwAmV6O0G1G7Oa" alt=""><figcaption></figcaption></figure>