> 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/naver.md).

# 네이버 로그인

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

## 1. 회원가입 설정

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

[**\[관리자페이지 > 상점설정 > 회원가입\]**](/customer_support/guide/setting/member/join.md)의 기본로그인 페이지를 통해 회원 가능 사용 설정 및 가입 폼을 통해 설정한 항목을 확인 부탁드립니다.

{% hint style="info" %}
사이트에 설정한 가입폼의 내용은 이후 진행이 될 **\[API 정보 입력]**&#xB2E8;계에서 사용하게 됩니다.
{% endhint %}

## 2. 어플리케이션 등록

### 2-1.어플리케이션 등록&#x20;

2-1-1. [네이버 개발자센터](https://developers.naver.com/)에 접속합니다.

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

2-1-3. 상단 메뉴에서 **\[Application > 애플리케이션 등록]**&#xC744; 클릭합니다.

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

### 2-2.약관 동의

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

API사용을 위한 약관 동의를 합니다.

{% hint style="info" %}
이전 어플리케이션 등록을 한 적이 있다면 이 과정은 무시됩니다.
{% endhint %}

### 2-3. 계정 정보 등록

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

계정 사용 설정을 위해 휴대폰 인증 및 이메일 계정 정보를 확인합니다.

{% hint style="info" %}
이전 어플리케이션 등록을 한 적이 있다면 이 과정은 무시됩니다.
{% endhint %}

### 2-4. API 정보 입력

2-4-1. 어플리케이션 항목에는 사이트 이름 또는 브랜드 이름을 입력합니다.

2-4-2. 사용 API 정보는 네이버 로그인을 선택합니다.

2-4-3. **제공 정보 선택** 항목은 네이버 계정으로 사이트 가입 시 네이버에서 제공 받을 가입자의 정보를 선택합니다. **\[회원가입 설정]**&#xACFC;정에서 확인하신 가입 항목을 기준으로 꼭 필요한 제공 정보만 필수로 선택합니다.

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

<table data-header-hidden><thead><tr><th width="149">버리는 항목</th><th width="384"></th><th>필수</th><th>추가</th></tr></thead><tbody><tr><td>항목</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>O</td><td>-</td></tr><tr><td><strong>별명</strong></td><td>현재 지원되지 않는 항목 입니다.</td><td>미지원</td><td>미지원</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><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>현재 지원되지 않는 항목 입니다.</td><td>미지원</td><td>미지원</td></tr></tbody></table>

{% hint style="danger" %}
제공 정보 선택 항목에서 선택한 항목과 사이트에서 받는 실제 가입 정보가 다른 경우, 네이버 로그인 검수 과정에서 심사 거절 사유가 됩니다.
{% endhint %}

2-4-4. 로그인 오픈 API 서비스 환경 -  PC웹을 선택합니다.

2-4-5. PC 웹 항목에 **서비스 URL** 과 **Callback URL** 을 입력합니다.

{% hint style="warning" %}
커스텀 도메인이 대표 도메인으로 설정된 경우, 해당 도메인을 반드시 네이버 개발자센터에 등록해야 합니다.
{% endhint %}

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

아래 내용을 참고하여 **서비스URL** 과 **Callback URL**을 입력합니다.

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

<table data-header-hidden><thead><tr><th width="165">버리는 항목</th><th></th></tr></thead><tbody><tr><td>항목</td><td>내용</td></tr><tr><td><strong>서비스 URL</strong></td><td><p><strong>https://도메인</strong> 형식으로 <strong>서비스 URL</strong> 을 입력합니다.</p><ul><li>한글 도메인 연결은 퓨니코드 주소를 입력합니다.</li></ul></td></tr><tr><td><strong>네이버 로그인 Callback URL</strong></td><td><p>아래 형식으로 Callback URL 을 모두 입력합니다. </p><ul><li><strong>https://도메인/api/auth/social/naver/callback</strong></li><li><strong>https://www.도메인/api/auth/social/naver/callback</strong></li></ul></td></tr></tbody></table>

### 2-5. Client ID 및 Client Secret 입력

2-5-1. **\[개요]** 탭에서 애플리케이션 정보를 확인하고, 복사합니다.

{% hint style="info" %}
보기 버튼을 클릭하여 Client Secret 값을 확인할 수 있습니다.
{% endhint %}

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

2-5-2. **관리자페이지 \[상점설정 > 회원가입] -** 소셜로그인 페이지에 접속합니다.

{% hint style="danger" %}
네이버 개발자센터 브라우저 탭은 아직 종료하지 마세요.
{% endhint %}

2-5-3. NAVER 로그인 **사용함** 체크 후 2-5-1.에서 복사한 값을 입력합니다. 우측 상단 저장하기 버튼을 클릭합니다.

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

### 2-6. 로고 이미지 등록

2-6-1. **네이버 개발자센터** 탭으로 돌아가 **API 설정** 탭을 클릭합니다.

2-6-2. **로그인 오픈 API 서비스 환경** 항목에서 **로고 이미지**를 등록합니다.

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

2-6-3. 페이지 하단의 \[**수정]** 버튼을 클릭합니다. (등록한 로고가 저장됩니다.)

2-6-4. **네이버 로그인 플러스** 항목은 OFF로 설정합니다.

2-6-5. **연결 끊기** 항목은 입력하지않고 비워둡니다.

2-6-6. **애플리케이션 개발 상태** 항목에서 \[**검수요청 하러 가기]** 버튼을 클릭합니다.

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

### 2-7. 검수 요청

<details>

<summary>2-7-1. 검수 신정 전 가이드 확인을 체크합니다. </summary>

[검수 요청 가이드](https://developers.naver.com/docs/login/verify/verify.md)를 클릭하여 사전 검수 가이드 내용을 확인해 주세요.

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

</details>

<details>

<summary>2-7-2. 제공 정보 활용처 확인을 합니다.</summary>

제공 정보는 이전 **\[API 설정]**&#xACFC;정에서 선택한 정보가 표시가 되며, 설정 정보 확인 및 해당 정보가 보여지는 실제 화면을 캡쳐하여 등록합니다.

1. 네이버로부터 제공받을 제공 정보 항목을 모두 체크합니다.

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

2. 운영중인 사이트 **\[마이페이지 > 나의 정보 > 개인 정보 관리]**&#xB97C; 클릭 후, 아래 예시 이미지와 같이 개인 정보 관리 내용을 캡쳐합니다.

{% hint style="warning" %}
파일 첨부 시 불필요한 개인정보가 노출되지 않도록 반드시 **마스킹 처리 후 첨부**해 주시기 바랍니다.
{% endhint %}

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

3. 네이버 검수 페이지로 돌아가, **\[파일선택]** 버튼을 클릭 후 캡쳐한 파일을 등록합니다.

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

</details>

<details>

<summary>2-7-3. 서비스 적용 형태 확인</summary>

1. **네이버 로그인을 통한 신규 회원 가입에 적용**을 체크합니다.

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

2. 네이버 로그인 이용 절차가 담긴 이미지를 하나의 이미지로 제작하여 이미지 파일을 첨부합니다.

{% hint style="info" %}
제작한 이미지에는 아래 내용이 포함되어야 합니다.

* 네이버 로그인이 적용된 페이지 스크린샷
* 회원가입 시 상세정보 입력 페이지 스크린샷
* 회원가입 완료 후 개인정보 페이지 스크린샷
  {% endhint %}

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

{% hint style="info" icon="plus" %}
네이버 로그인 절차 확인을 위해 **\[멤버관리]** 탭에서 테스터 ID를 등록할 수 있습니다.
{% endhint %}

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

3. **\[파일선택]** 버튼 클릭 후, 위 과정에서 만든 이미지 파일을 업로드 합니다.

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

</details>

<details>

<summary>2-7-4. 추가 제출 서류 확인</summary>

업종에 따라 네이버 로그인을 사용하기 위해서는 추가서류를 제출해야 합니다.&#x20;

사이트의 업종에 해당하는 항목 선택 후, 추가서류를 제출합니다.

* 해당되는 항목이 없다면 **없음**을 선택합니다.

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

</details>

<details>

<summary>2-7-5. 검수 요청하기</summary>

* 페이지 가장 아래 **\[검수 요청]** 버튼을 클릭합니다.

  <figure><img src="/files/55Na7lSxkqTXiFaEbmso" alt=""><figcaption></figcaption></figure>

</details>

### 2-8. 신청 완료

모든 과정이 완료되었습니다.&#x20;

네이버 로그인 검수는 약 3\~4일 정도의 시간이 소요될 수 있으며, 네이버 개발자센터에 로그인 한 계정으로 검수결과가 통보됩니다.


---

# 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/naver.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.