> 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>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.qshop.ai/customer_support/guide/setting/member/social/kakao.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.