> For the complete documentation index, see [llms.txt](https://tech.x2bee.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://tech.x2bee.com/api-guide/store-front/member/undefined-2.md).

# 본인인증

본인인증 기능은 회원가입, 아이디/비밀번호 찾기 등의 서비스를 이용하기 위해 회원 본인을 확인하는 프로세스를 의미합니다. 쇼핑몰에서는 본인인증을 통해 회원이 적합한 나이인지(만 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 %}