> 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-1.md).

# 회원 가입

쇼핑몰의 모든 서비스를 이용하기 위해 신규 회원을 등록하는 기능을 제공합니다. 회원은 개인 정보를 입력하여 일반 회원가입 또는 소셜 회원가입을 선택할 수 있습니다. 이 API는 안전한 회원 정보 관리를 위해 암호화 및 마스킹 처리를 적용하고 있으며, 소셜 회원가입은 네이버와 카카오톡을 지원합니다.

***

## 주요 기능

* **일반 회원가입**
  * 쇼핑몰의 모든 서비스를 이용하기 위해 필요한 개인 정보를 입력하여 회원가입을 진행합니다.
  * 개인 정보로는 이메일, 비밀번호, 본인인증 고유식별정보(CI) 등이 필수로 입력되어야 합니다.
* **소셜 회원가입**
  * 네이버 또는 카카오톡 계정을 활용하여 쇼핑몰 회원가입을 간편하게 완료할 수 있습니다.
  * 소셜 계정의 비밀번호를 사용하지 않으며, 각 소셜 채널에서 제공하는 인증을 통해 본인인증이 이루어집니다.
* **암호화 및 마스킹**
  * 회원의 비밀번호는 Spring Security에서 제공하는 Bcrypt 암호화를 사용하여 안전하게 보관됩니다.
  * 민감한 개인 정보는 마스킹 처리를 통해 가독성을 낮추고 안전하게 관리됩니다.

## 프로세스 정의

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

{% stepper %}
{% step %}

### CI 인증 회원 정보조회

본인인증 고유식별인증(CI) 값을 활용하여 X2BEE쇼핑몰의 회원 여부를 판단합니다.
{% endstep %}

{% step %}

### 소셜 계정 인증

소셜 계정 인증 과정을 활용하여, X2BEE쇼핑몰의 회원 여부를 판단합니다. 기존 회원인 경우 기존 계정으로 로그인 또는 연동을 할 수 있고, 비회원의 경우 회원가입 페이지로 이동합니다.
{% endstep %}

{% step %}

### 회원가입

회원가입 처리를 통해 중복 계정 생성 및 가입을 방지합니다. X2BEE 쇼핑몰을 탈퇴한 회원은 90일간 재가입을 할 수 없으며, 재가입 시 카카오톡 알림톡이 전송되지 않습니다.
{% endstep %}

{% step %}

### 알림톡 전송

알림전송API를 호출하여 알림톡/알림함 메시지를 전송합니다.
{% endstep %}

{% step %}

### 쿠폰 다운로드(BO)

회원가입 시 쿠폰발급 API를 호출하여 신규회원 쿠폰을 발급을 합니다. 단, 재가입한 회원은 쿠폰 발급 대상에서 제외 됩니다.
{% endstep %}

{% step %}

### 회원 기본 정보 및 배송지 병합

별도로 분리되어 관리되고 있는 이벤트 DB에 회원정보동기화API를 호출하여 회원 정보와 회원 배송지 정보 데이터 Sync를 맞춥니다.
{% endstep %}
{% endstepper %}

## API 기능 목록

<table><thead><tr><th width="117.888916015625">API</th><th width="362.5555419921875">설명</th><th width="95.77783203125">Server</th><th width="90.22216796875">메소드</th><th>비고</th></tr></thead><tbody><tr><td>회원가입</td><td>X2BEE 쇼핑몰에 신규회원 가입을 진행합니다. X2BEE 쇼핑몰 회원은 모든 서비스를 제한 없이 사용할 수 있습니다. <br>알림메시지 단건 전송: api/common/v1/common/sendMessage <br>자동발급유형별 쿠폰 조회: api/order/v1/marketing/getCouponListByAutoIssuTypCd <br>쿠폰 다운로드(BO): api/order/v1/marketing/cpnDownBo <br>회원 기본 정보 병합: api/event/v1/common/mergeMbrBase​ <br>회원 기본 배송지 병합: api/event/v1/common/mergeMbrDlvp​</td><td>Member</td><td>POST</td><td><a href="http://api.x2bee.com/content?msa=member&#x26;depth=%ED%9A%8C%EC%9B%90%EA%B0%80%EC%9E%85&#x26;path=insertMemberJoin">🔗API 확인하기></a></td></tr><tr><td>CI 인증 회원정보 조회</td><td>회원가입 시, 본인인증 고유식별정보(CI)로 <br>회원 여부를 판단합니다.</td><td>Member</td><td>POST</td><td><a href="http://api.x2bee.com/content?msa=member&#x26;depth=%ED%9A%8C%EC%9B%90%EA%B0%80%EC%9E%85&#x26;path=getCheckMobileCert">🔗API 확인하기></a></td></tr><tr><td>이메일 중복 확인</td><td>X2BEE 쇼핑몰에 회원 가입 시 기존에 중복된 <br>이메일이 존재하는지 확인 합니다.</td><td>Member</td><td>GET</td><td><a href="http://api.x2bee.com/content?msa=member&#x26;depth=%ED%9A%8C%EC%9B%90%EA%B0%80%EC%9E%85&#x26;path=checkEmail">🔗API 확인하기></a></td></tr><tr><td>소셜 계정 <br>인증</td><td>소셜 계정 정보 및 본인인증 CI 값을 활용하여 회원 여부 및 소셜 연동 여부를 판단하고 소셜 계정이 연동된 계정이면 로그인 처리, 소셜 계정이 연동되어 있지 않은 회원이면 연동을 위한 권한 메세지, 비회원일 경우 회원가입 페이지를 이동하는 서비스를 지원합니다.</td><td>Member</td><td>POST</td><td><a href="http://api.x2bee.com/content?msa=member&#x26;depth=%EB%A1%9C%EA%B7%B8%EC%9D%B8&#x26;path=check">🔗API 확인하기></a></td></tr></tbody></table>

## 용어 정의

<table><thead><tr><th width="99.5555419921875">명칭</th><th>설명</th></tr></thead><tbody><tr><td>소셜 계정</td><td>소셜 계정 로그인이란 국내외 대표 포털 사이트, 소셜 미디어 등의 계정 정보를 이용해 다른 여러 인터넷 서비스를 로그인 또는 회원가입할 수 있는 기능을 말합니다. <br>현재 저희 서비스에서는 네이버와 카카오를 이용하고 있습니다.</td></tr><tr><td>알림톡</td><td>카카오톡 알림톡을 의미하며, 카카오톡의 채널이 등록되어 있지 않은 이용자에게도 메세지를 전달할 수 있습니다. 단, 알림톡의 경우 불특정 다수에게 전송이 가능한 시스템이기 때문에, 전송하고자 하는 메세지 템플릿을 생성하여 카카오톡에 심사를 받아야 합니다.</td></tr></tbody></table>

## 기타 참고사항

* X2BEE 쇼핑몰은 ‘일반회원가입’ 과 ’소셜 회원가입’ 두 가지 회원가입 서비스를 제공하고 있습니다.
* 회원가입 시 본인인증 고유식별정보(CI)는 필수이며, NICE 본인인증 및 가입한 소셜 채널의 계정 정보를 통해 전달 받습니다.
* 탈퇴한 회원은 90일간 회원가입이 제한되며, 재가입 시 알림톡 및 신규가입 쿠폰 발급 대상에서 제외됩니다.
* Event DB의 회원 정보 Sync를 위해 회원 가입 후 ‘회원 기본 배송지 병합 API’와 ’회원 기본 정보 병합 API’를 전송합니다.
* 회원가입 시 알림메세지는 알림함(ALM-PO3C)과 카카오톡(PO3C)을 발송을 합니다.