# 본인인증

본인인증 기능은 회원가입, 아이디/비밀번호 찾기 등의 서비스를 이용하기 위해 회원 본인을 확인하는 프로세스를 의미합니다. 쇼핑몰에서는 본인인증을 통해 회원이 적합한 나이인지(만 14세 이상) 확인하며, 미성년자의 경우 유해 상품 및 콘텐츠에 접근을 제한하여 안전한 서비스 이용을 보장합니다.

***

## 주요 기능

* 회원가입 및 기타 서비스 이용 시, 본인인증을 통해 회원의 만 14세 이상임을 확인합니다.
* 성인인증 여부를 통해 성인 회원에게만 특정 상품 및 콘텐츠에 접근할 수 있는 권한을 부여합니다.
* 본인인증을 통해 계정의 소유주를 확인하고, 개인정보 변경 및 아이디 또는 비밀번호 찾기 서비스를 지원합니다.

## 프로세스 정의

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

{% stepper %}
{% step %}

### 회원 본인인증 이력저장

본인인증 요청 시 구분 코드를 전달 후 본인인증 이력을 삽입합니다. 성인인증 구분코드가 전달 되었을 경우 회원의 성인인증 여부를 수정합니다.
{% endstep %}
{% endstepper %}

## API 기능 목록

<table><thead><tr><th width="96.77783203125">API</th><th width="390.666748046875">설명</th><th width="92.4444580078125">Server</th><th width="90.2222900390625">메소드</th><th>비</th></tr></thead><tbody><tr><td>회원 본인인증 이력 저장</td><td>휴대폰 본인인증 이후 모듈 별 본인인증 프로세스가 진행된 결과를 저장하고, 요청 구분 코드 중 성인<br>인증 요청 시 회원의 성인인증 여부를 수정합니다.</td><td>Member</td><td>POST</td><td><a href="http://api.x2bee.com/content?msa=member&#x26;depth=%EB%B3%B8%EC%9D%B8%EC%9D%B8%EC%A6%9D&#x26;path=saveCertiInfo">🔗API 확인하기></a></td></tr></tbody></table>

## 용어 정의

<table><thead><tr><th width="108.4443359375">명칭</th><th>설명</th><th data-hidden>비고</th></tr></thead><tbody><tr><td>본인인증</td><td>휴대폰 본인인증을 통해 고유식별정보(CI)를 제공 받을 수 있습니다. <br>해당 정보를 통해 회원의 신분을 확인할 수 있고, 개인정보를 보호하고 안전한 거래를 도와주는 데 활용됩니다.</td><td></td></tr></tbody></table>

## 기타 참고사항

* **본인인증**
  * NICE 본인인증 API를 사용합니다.
  * 본인인증을 통해 전달 받는 값은 다음과 같습니다.

<details open>

<summary>본인인증으로 전달되는 값 (펼치기)</summary>

<table><thead><tr><th width="98.77783203125">인증결과</th><th width="161.6666259765625">명칭</th><th width="155.333251953125">키값</th><th>비고</th></tr></thead><tbody><tr><td><strong>공통</strong></td><td>CP요청번호</td><td>REQ_SEQ</td><td>최대 30 Byte (생성/임의값)</td></tr><tr><td></td><td>인증수단</td><td>AUTH_TYPE</td><td>M: 휴대폰 C: 카드 X: 인증서 <br>P: 삼성패스</td></tr><tr><td><strong>인증성공</strong></td><td>처리결과 고유번호</td><td>RES_SEQ</td><td>24 Byte</td></tr><tr><td></td><td>이름</td><td>NAME</td><td>50 Byte, EUC-KR</td></tr><tr><td></td><td>UTF-8 이름</td><td>UTF8_NAME</td><td>50 Byte, UTF-8, URLDecode <br>처리 필요</td></tr><tr><td></td><td>생년월일</td><td>BIRTHDATE</td><td>YYYYMMDD</td></tr><tr><td></td><td>성별 코드</td><td>GENDER</td><td>0: 여성, 1: 남성</td></tr><tr><td></td><td>내/외국인 코드</td><td>NATIONAINFO</td><td>0: 내국인, 1: 외국인</td></tr><tr><td></td><td>중복가입 확인값 (DI값)</td><td>DI</td><td>64 Byte, 카드-생년월일 인증 시 리턴X</td></tr><tr><td></td><td>연계정보 확인값 (CI값)</td><td>CI</td><td>88 Byte, 카드-생년월일 인증 시 리턴X</td></tr><tr><td></td><td>통신사정보</td><td>MOBILE_CO</td><td>3 Byte, 핸드폰 인증 전용</td></tr><tr><td></td><td>휴대폰번호</td><td>MOBILE_NO</td><td>24 Byte, 핸드폰 인증 전용</td></tr></tbody></table>

</details>

* **비회원 본인인증**

  * 비회원은 상품 구매 시 본인인증 이후 서비스 이용 가능합니다.
  * 비회원이 성인전용 상품 상세페이지 접근 시, 본인인증 과정을 거쳐야 하고 만 19세 이상의 고객일 때 서비스 이용이 가능합니다.
  * 비회원 본인인증 시 나이, 성인인증 여부 데이터는 암호화 되어 쿠키에 설정됩니다.
  * 비회원 본인인증 시 고객명, 전화번호 데이터는 세션스토리지에 설정됩니다.

* **본인인증 개발 세팅**

<table><thead><tr><th width="189">파일</th><th>설정/설명</th><th>비고</th></tr></thead><tbody><tr><td>niceid.js</td><td>8번 라인 sSiteCode = 사이트 코드<br>9번 라인 sSitePW = 사이트 비밀번호 Windows OS 사용자<br>16번 라인 주석 해제<br>17번 라인 주석 MAC OS 사용자<br>16번 라인 주석<br>17번 라인 주석 해제</td><td>MAC OS 사용자는 본인인증 모듈의 권한변경을 필수로 진행 해 주셔야 합니다. <br>ex)venus-x2bee-mo-vanilla 경로에서 $ sudo chmod 755 CPClient_mac 이후, CPClient_mac 파일을 최초 1회 실행 한 후 '확인 되지 않은 개발자가 배포한 앱 열기' 에 대한 권한을 <br>승인 해 주어야 합니다.</td></tr><tr><td>checkplus_success.js</td><td>7번 라인 sSiteCode = 사이트 코드<br>8번 라인 sSitePW = 사이트 비밀번호 Windows OS 사용자<br>13번 라인 주석 해제<br>14번 라인 주석 MAC OS 사용자<br>13번 라인 주석<br>14번 라인 주석 해제</td><td>MAC OS 사용자는 본인인증 모듈의 권한변경을 필수로 진행 해 주셔야 합니다. <br>ex)venus-x2bee-mo-vanilla 경로에서 $ sudo chmod 755 CPClient_mac 이후, CPClient_mac 파일을 최초 1회 실행 한 후 '확인 되지 않은 개발자가 배포한 앱 열기' 에 대한 권한을 승인 해 주어야 합니다.</td></tr></tbody></table>

{% hint style="info" %}
MAC OS 권한 관련 안내: CPClient\_mac 실행 권한 변경 및 최초 실행 시 '확인 되지 않은 개발자가 배포한 앱 열기' 권한 승인이 필요합니다.
{% endhint %}


---

# Agent Instructions: 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://tech.x2bee.com/api-guide/store-front/member/undefined-2.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.