# 카카오싱크 신청가이드

## 간단소개

* 기능요약
  * 카카오싱크 연동을 통해 회원이 카카오 계정을 이용하여 쇼핑몰 간편 회원 가입 및  로그인을 할 수 있도록 제공합니다. 
  * 대상 솔루션 : 고도몰 basic, 고도몰 pro, 고도몰 business
  * 기능 배포 일자 : 2024-12-30<br>
* 유의사항
  * 샵바이 카카오싱크는 아래 가이드로 확인해주세요.
    * 샵바이 베이직, 프로: [\[베이직/프로\] 카카오싱크 신청 가이드 바로가기 > ](https://workspace-help.nhn-commerce.com/recommendedcontents/contents/undefined-1)
    * 샵바이 엔터프라이즈: [\[엔터프라이즈\] 카카오 싱크 신청 가이드 바로가기 > ](https://workspace-help.nhn-commerce.com/recommendedcontents/contents/prm_kakao-sync)
  * 고도몰 카카오싱크를 최초 설치하신 경우 스킨 패치가 필요합니다.&#x20;
    * NHN 커머스 마이페이지 > 쇼핑몰 관리 > 패치&업그레이드에서 스킨 패치 파일을 확인해주세요.
    * 스킨 패치 파일명 : "카카오싱크 간편 회원가입 추가"
    * [패치&업그레이드 공지사항 바로가기 >](https://www.nhn-commerce.com/support/board/34/42/2239)
  * **2024-12-30 이전에 카카오싱크 기능을 자체 구축한 상점은 NHN 커머스에서 제공하는 카카오싱크 앱 설치를 권장하지 않습니다.**  \
    카카오싱크 패치 범위를 튜닝 가이드에 맞게 개발하였는지 진단한 뒤, 자체 구축한 카카오싱크 기능을 사용하시길  바랍니다.&#x20;
    * [카카오싱크 패치 범위 확인하기 > ](https://www.nhn-commerce.com/support/board/35/39/3730)

***

## 카카오싱크 신청&설정 방법

#### ① 카카오싱크 앱 설치 방법

* NHN 커머스 사이트 > 성장/운영 > 스토어에 접속 후 '카카오싱크' 앱 "설치하기" 버튼을 클릭합니다. [앱스토어 바로가기 > ](https://apps.nhn-commerce.com/apps/255)

<figure><img src="https://1819318178-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FC0jxYS3cZ07BC3ROfGpj%2Fuploads%2FxqpgDJLy13QNo9TUyiPL%2Fa%20%EC%8B%B1%ED%81%AC%20%EB%8B%A4%EC%9A%B4%EB%A1%9C%EB%93%9C.png?alt=media&#x26;token=53ceaddb-87c3-4079-bf52-c7209128d125" alt=""><figcaption></figcaption></figure>

* 로그인 후 설치를 원하시는 쇼핑몰을 선택하고 "설치" 버튼을 클릭합니다.&#x20;

<figure><img src="https://1819318178-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FC0jxYS3cZ07BC3ROfGpj%2Fuploads%2FU3EafIabklQ6Pux7QuTt%2Fb%20%EC%8B%B1%ED%81%AC%20%EB%8B%A4%EC%9A%B4%EB%A1%9C%EB%93%9C%201.png?alt=media&#x26;token=ae8a22bf-3987-4685-a5f0-9dab3f7a684a" alt="" width="375"><figcaption></figcaption></figure>

* 이용 동의 항목을 선택 후 "설치" 버튼을 클릭합니다.&#x20;

<figure><img src="https://1819318178-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FC0jxYS3cZ07BC3ROfGpj%2Fuploads%2F7Uzwg6egQR7QN7NH8ji0%2Fc%20%EC%8B%B1%ED%81%AC%20%EB%8B%A4%EC%9A%B4%EB%A1%9C%EB%93%9C%202.png?alt=media&#x26;token=c35d385d-5b50-4d6e-9cdf-680ef5f8cb49" alt="" width="426"><figcaption></figcaption></figure>

***

#### ② 카카오싱크 앱 설정 방법

* 1\) 카카오싱크 앱 설치 완료 후 앱서비스 > 설치  리스트에 설치된 카카오싱크 앱의 "실행" 버튼을 클릭합니다.&#x20;

<figure><img src="https://1819318178-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FC0jxYS3cZ07BC3ROfGpj%2Fuploads%2FVGpK1EjREFvquETgT9so%2Fd%20%EC%95%B1%EB%A6%AC%EC%8A%A4%ED%8A%B8.png?alt=media&#x26;token=29860dec-2ef0-4b18-a0b3-4ced8848f301" alt=""><figcaption></figcaption></figure>

* 2\) 카카오싱크 설정 페이지가 출력되면, "카카오싱크 연동" 버튼을 클릭합니다.&#x20;

<figure><img src="https://1819318178-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FC0jxYS3cZ07BC3ROfGpj%2Fuploads%2FATs2px5GJkDxjCrH8mP3%2Fe%20%EC%B9%B4%EC%B9%B4%EC%98%A4%20%EC%8B%B1%ED%81%AC%20%EC%84%A4%EC%A0%95%20-%20%EC%97%B0%EB%8F%99%20%EC%A0%84.png?alt=media&#x26;token=ac1ce660-7375-440b-a3e3-2500634eb21e" alt=""><figcaption></figcaption></figure>

* 3\) 사용할 카카오 계정으로 로그인합니다.&#x20;

<figure><img src="https://1819318178-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FC0jxYS3cZ07BC3ROfGpj%2Fuploads%2F6KcX67Ai66IYD6G7jGU1%2Ff%20%EC%B9%B4%EC%B9%B4%EC%98%A4%20%EB%A1%9C%EA%B7%B8%EC%9D%B8.png?alt=media&#x26;token=bd8f1165-0548-4c43-b96d-def0009e9437" alt="" width="366"><figcaption></figcaption></figure>

* 4\) 안내문을 확인하신 후 "동의하고 계속" 버튼을 클릭하여 카카오싱크 간편 설정을 진행합니다.&#x20;

<figure><img src="https://1819318178-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FC0jxYS3cZ07BC3ROfGpj%2Fuploads%2FCxNCoZfE1QDOW4LozJIy%2Fg%20%EC%B9%B4%EC%B9%B4%EC%98%A4%20%EA%B0%84%ED%8E%B8%20%EC%84%A4%EC%A0%95.png?alt=media&#x26;token=d757dfa7-49f6-40f5-a977-656ef5dc1696" alt="" width="366"><figcaption></figcaption></figure>

* 5\) 기존에 등록되어 있는 디벨로퍼스 앱이 없는 경우 새로운 앱을 생성합니다.&#x20;

{% hint style="warning" %}
카카오 간편가입(카카오 아이디 로그인)을 사용하고  있는 상점의 경우, \
기존에 사용  중인 동일한 디벨로퍼스 앱을 사용해 주세요. \
다른 앱으로 연동을 진행할 경우 기존 카카오 간편 가입(카카오 아이디 로그인) 회원은 로그인할 수 없으며, 신규 회원으로 가입 처리됩니다.
{% endhint %}

{% hint style="danger" %}
쇼핑몰 이전 시 반드시 테스트용 디벨로퍼스 앱을 생성하시어 사전 테스트 진행 부탁드립니다. \
테스트 완료 시 회원 DB 마이그레이션 작업이 필요하며, 마이그레이션 작업 완료 후 이전 쇼핑몰에서 사용하고 있던 디벨로퍼스 앱을 연결합니다. (마이그레이션 별도 요청 필요)
{% endhint %}

<figure><img src="https://1819318178-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FC0jxYS3cZ07BC3ROfGpj%2Fuploads%2FwvCFM7mXihtfeKr1N4iY%2Fh%20%EA%B0%84%ED%8E%B8%EC%84%A4%EC%A0%95%202.png?alt=media&#x26;token=d57d3b05-44be-4408-b7a9-d69eb2065f4e" alt=""><figcaption></figcaption></figure>

> 쇼핑몰 정보 항목
>
> * 쇼핑몰 로고 : 가이드에 맞는 쇼핑몰 로고 이미지를 등록합니다.
> * 쇼핑몰, 회사 이름 : 기본설정 > 기본정책 > 기본 정보 설정에 등록된 정보로 등록합니다.&#x20;

* 6\) 카카오싱크에 연결할 채널을 선택하거나, 신규 채널을 생성합니다.
  * 이미 생성된 채널을 연결하려면 해당 채널을 선택 후 "다음" 버튼을 클릭합니다.&#x20;

<figure><img src="https://1819318178-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FC0jxYS3cZ07BC3ROfGpj%2Fuploads%2FR8mj13y2JVQ7Qlu7MiKj%2Fi%20%EA%B0%84%ED%8E%B8%EC%84%A4%EC%A0%95%203.png?alt=media&#x26;token=bfd86213-c990-447a-b640-9f8cb1d2eab0" alt=""><figcaption></figcaption></figure>

* 7\) 카카오 간편 가입 동의(약관 동의) 화면에 노출할 카카오톡 채널 정보를 입력합니다.

<figure><img src="https://1819318178-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FC0jxYS3cZ07BC3ROfGpj%2Fuploads%2FFIuH0pgnbgiGrJEmzJnO%2Fj%20%EA%B0%84%ED%8E%B8%EC%84%A4%EC%A0%95%204.png?alt=media&#x26;token=f6d966c2-098b-4ee6-a239-913986709fbb" alt=""><figcaption></figcaption></figure>

> * 프로필 사진 : 가이드에 맞는 채널의 프로필 사진을 등록합니다.
> * 채널 이름 : 기본설정 > 기본정책 > 기본 정보 설정에 등록된 쇼핑몰 명이 출력됩니다.
> * 검색용 아이디 : 쇼핑몰의 카카오톡 채널을 검색할 때 사용되는 쇼핑몰 채널의 고유 아이디입니다.\
>   (쇼핑몰 채널의 고유 아이디이기 때문에 동일 아이디 생성은 불가합니다.)&#x20;
> * 카테고리 : 쇼핑몰에 맞는 카테고리를 설정합니다.&#x20;

* 8\) 설정하고자 하는 디벨로퍼스 앱과 카카오톡 채널 정보가 맞는지 확인 후 "완료" 버튼을 클릭합니다.&#x20;
  * 비즈니스 채널 신청 제한 업종이 아닐 경우 선택 항목을 체크합니다.&#x20;

<figure><img src="https://1819318178-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FC0jxYS3cZ07BC3ROfGpj%2Fuploads%2FF8gzOcNrS1SGyOaKtREN%2Fk%20%EA%B0%84%ED%8E%B8%EC%84%A4%EC%A0%95%205.png?alt=media&#x26;token=a58ece4a-eab8-417a-b0c7-ecf2f6c89b34" alt=""><figcaption></figcaption></figure>

{% hint style="danger" %}

* 카카오톡 비즈니스 채널이 아닐 경우 카카오싱크 간편 회원가입이 불가할 수 있습니다. &#x20;

* 카카오톡 일반 채널로 전환된 경우 카카오 가이드를 참고하시어 비즈니스 채널 재심사를 받아주세요.&#x20;
  * [카카오톡 비즈니스 채널 신청 가이드 바로가기>](https://cs.kakao.com/helps_html/1073204966)
    {% endhint %}

* 9\) 카카오싱크 설정을 완료합니다.&#x20;

<figure><img src="https://1819318178-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FC0jxYS3cZ07BC3ROfGpj%2Fuploads%2FXF7c7wD5yUerSsJ6maad%2Fl%20%EA%B0%84%ED%8E%B8%EC%84%A4%EC%A0%95%206.png?alt=media&#x26;token=a3c71956-c953-40b2-becb-920bffc81159" alt=""><figcaption></figcaption></figure>

***

#### ③ 카카오싱크 설정 확인

* 카카오크 설정 완료 시 REST API Key 값이 자동으로 입력됩니다.&#x20;

<figure><img src="https://1819318178-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FC0jxYS3cZ07BC3ROfGpj%2Fuploads%2F72YMvnmYlVQ8XVyGmXtt%2Fm%20%EC%8B%B1%ED%81%AC%20%EC%84%A4%EC%A0%95.png?alt=media&#x26;token=ade943c1-f32d-4473-bfd8-9548d4fbede3" alt=""><figcaption></figcaption></figure>

* 카카오 싱크 설정 완료 시 기본정보 및 부가정보에서 쇼핑몰의 회원가입 항목을 확인할 수 있습니다.
  * 쇼핑몰의 회원가입 항목 설정과  관계없이 "이메일"은 항상 필수항목으로 표시됩니다.

<figure><img src="https://1819318178-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FC0jxYS3cZ07BC3ROfGpj%2Fuploads%2FuLQwuRwM45TqyKxeVPPU%2Fn%20%EC%8B%B1%ED%81%AC%20%EC%84%A4%EC%A0%95%202.png?alt=media&#x26;token=1e8c1b51-9d34-46d7-b58e-7f7a21238b6c" alt=""><figcaption></figcaption></figure>

* 카카오싱크 설정 완료 시 쇼핑몰 회원가입/로그인 페이지에 "카카오 아이디 회원가입", "카카오 아이디로 로그인" 버튼이 생성됩니다.

<figure><img src="https://1819318178-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FC0jxYS3cZ07BC3ROfGpj%2Fuploads%2FwJdZTGkqdsuulpUHLMOf%2Fo%20%ED%9A%8C%EC%9B%90%20%EB%A1%9C%EA%B7%B8%EC%9D%B8.png?alt=media&#x26;token=4ca5293c-707c-4d24-865b-f731f9898a48" alt="" width="375"><figcaption><p>쇼핑몰 로그인 페이지</p></figcaption></figure>

<figure><img src="https://1819318178-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FC0jxYS3cZ07BC3ROfGpj%2Fuploads%2FoV66ILH3KB6ehUFpKyCH%2Fp%20%ED%9A%8C%EC%9B%90%20%EA%B0%80%EC%9E%85.png?alt=media&#x26;token=4117ac4c-d0f4-40f1-bff8-e55969cfff69" alt="" width="375"><figcaption><p>쇼핑몰 회원가입 페이지</p></figcaption></figure>

{% hint style="success" %}
카카오싱크 설정까지 완료하신 경우 쇼핑몰 화면에서 카카오 싱크를 통해 간편 가입 및 로그인이 가능합니다.
{% endhint %}

***

## 카카오싱크 가입/연동 방법&#x20;

#### ① 쇼핑몰에 신규로 가입하는 회원

* 1\) 쇼핑몰 회원가입 페이지에서 \[카카오 아이디 회원가입] 버튼을 클릭합니다.
* 2\) 카카오 계정 로그인을 진행합니다.
* 3\) 카카오싱크 가입 팝업에서 카카오 동의 항목, 쇼핑몰 동의 항목, 마케팅 수신 여부 선택 후 \[동의하고 계속하기] 버튼을 클릭합니다.\
  \
  &#x20;                                                 ![](https://1819318178-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FC0jxYS3cZ07BC3ROfGpj%2Fuploads%2FZ62jFp002rQcLhIiObov%2Fq%20%EC%B9%B4%EC%8B%B1%20%EA%B0%80%EC%9E%85%20%ED%8C%9D%EC%97%85.png?alt=media\&token=0a9a951c-9405-4196-9c8c-e74d38c2d9c0)<br>
* 4\) 회원가입이 완료된 상태로 쇼핑몰 메인 페이지로 이동하며, 이후부터 쇼핑몰 로그인 페이지에서 \[카카오 아이디로 로그인] 버튼 클릭 시 간편 로그인을 할 수 있습니다.&#x20;

{% hint style="info" %}

* 카카오 동의 항목 중 쇼핑몰 회원 가입 항목은 쇼핑몰 관리자 내 "회원 가입 항목 관리" 에서 설정할 수 있습니다.
* 쇼핑몰 동의 항목 중 쇼핑몰 이용약관은 쇼핑몰 관리자 내 "약관 / 개인정보처리방침"에서 설정할 수 있습니다.
* 카카오싱크로 쇼핑몰에 신규 가입한 회원의 아이디는 15자 난수로 생성됩니다.
  {% endhint %}

#### ② 쇼핑몰에 가입되어 있는 일반 회원&#x20;

* ⓐ 쇼핑몰 회원가입 페이지에서 카카오 계정을 연동할 경우
  * 1\) 쇼핑몰 회원가입 페이지에서 \[카카오 아이디 회원가입] 버튼을 클릭합니다.
  * 2\) 카카오 계정 로그인을 진행합니다.
  * 3\) 카카오싱크 가입 팝업에서 카카오 동의 항목, 쇼핑몰 동의 항목, 마케팅 수신 여부 선택 후 \[동의하고 계속하기] 버튼을 클릭합니다.
  * 4\) 회원정보 확인 페이지에서 카카오 계정을 연동할 회원을 선택하고 해당 회원의 아이디/비밀번호를 입력한 뒤 \[카카오 간편로그인으로 전환하기] 버튼을 클릭합니다.\
    &#x20;        &#x20;

    <figure><img src="https://1819318178-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FC0jxYS3cZ07BC3ROfGpj%2Fuploads%2FozU2M14cq9HrU6h3LTXC%2Fr%20%ED%9A%8C%EC%9B%90%20%EC%A0%95%EB%B3%B4%20%ED%99%95%EC%9D%B8.png?alt=media&#x26;token=ee95a649-68fc-4b18-b46c-bc876779c575" alt=""><figcaption></figcaption></figure>
  * 5\) 회원가입이 완료된 상태로 쇼핑몰 메인 페이지로 이동하며, 이후부터 쇼핑몰 로그인 페이지에서 \[카카오  아이디로  로그인] 버튼 클릭 시 간편 로그인을 할 수 있습니다. &#x20;

{% hint style="info" %}

* 카카오 계정 이메일을 쇼핑몰 아이디 혹은 이메일로 사용 중인 기존 일반 회원을 카카오 계정으로 연동할 수 있습니다.&#x20;
* 카카오 계정 연동 후에도 쇼핑몰 일반 로그인이 가능합니다.&#x20;
  {% endhint %}

{% hint style="warning" %}
휴면 상태 회원, 가입 미승인 회원, 카카오 외 SNS 간편 로그인 회원은 회원정보 확인 페이지에서 카카오싱크를 이용한 계정 연동이 불가합니다.
{% endhint %}

* ⓑ 쇼핑몰 마이페이지에서 카카오 계정을 연동할 경우
  * 1\) 마이페이지 > 회원정보 변경 > 계정 연결정보에서 \[카카오 아이디로 로그인] 버튼을 클릭합니다.
  * 2\) 카카오 계정 로그인을 진행합니다.
  * 3\) 카카오싱크 가입 팝업에서 카카오 동의 항목, 쇼핑몰 동의 항목, 마케팅 수신 여부 선택 후 \[동의하고 계속하기] 버튼을 클릭합니다.
  * 4\) 현재 쇼핑몰에 로그인한 회원과 카카오 계정이 연동됩니다. 이후부터 카카오 계정을 통해 쇼핑몰에 로그인 할 수 있습니다.

#### ③ 쇼핑몰에 가입되어 있는 카카오 아이디 로그인 회원&#x20;

* 1\) 쇼핑몰 로그인 페이지에서 \[카카오 아이디로 로그인] 버튼을 클릭합니다.
* 2\) 카카오 계정 로그인을 진행합니다.
* 3\) 카카오싱크 가입 팝업에서 카카오 동의 항목, 쇼핑몰 동의 항목, 마케팅 수신 여부 선택 후 \[동의하고 계속하기] 버튼을 클릭합니다.
  * 기존 카카오 아이디 로그인 회원의 경우, 카카오싱크 앱 설치 후 최초 1회에 한하여 카카오싱크 가입 팝업에서 약관 동의를 진행해야 합니다.
* 4\) 로그인 완료된 상태로 쇼핑몰 메인 페이지로 이동합니다.&#x20;

***

## 유의사항

* 샵바이 카카오싱크는 아래 가이드로 확인해주세요.
  * 샵바이 베이직, 프로: [\[베이직/프로\] 카카오싱크 신청 가이드 바로가기 > ](https://workspace-help.nhn-commerce.com/recommendedcontents/contents/undefined-1)
  * 샵바이 엔터프라이즈: [\[엔터프라이즈\] 카카오 싱크 신청 가이드 바로가기 > ](https://workspace-help.nhn-commerce.com/recommendedcontents/contents/prm_kakao-sync)
* 고도몰 카카오싱크를 최초 설치하신 경우 스킨 패치가 필요합니다.&#x20;
  * NHN 커머스 마이페이지 > 쇼핑몰 관리 > 패치&업그레이드에서 스킨 패치 파일을 확인해주세요.
  * 스킨 패치 파일명 : "카카오싱크 간편 회원가입 추가"
  * [패치&업그레이드 공지사항 바로가기 >](https://www.nhn-commerce.com/support/board/34/42/2239)
* **2024-12-30 이전에 카카오싱크 기능을 자체 구축한 상점은 NHN 커머스에서 제공하는 카카오싱크 앱 설치를 권장하지 않습니다.**  \
  카카오싱크 패치 범위를 튜닝 가이드에 맞게 개발하였는지 진단한 뒤, 자체 구축한 카카오싱크 기능을 사용하시길  바랍니다.&#x20;
  * [카카오싱크 패치 범위 확인하기 > ](https://www.nhn-commerce.com/support/board/35/39/3730)