# 회원가입

새로운 사용자를 등록하고 이커머스 플랫폼에 회원으로 추가하는 기능을 제공합니다. 이 API를 통해 사용자는 개인 정보를 제공하고 회원 계정을 생성할 수 있습니다. X2BEE는 기본 로그인과 간편 로그인을 위한 2가지 방법으로 회원가입 서비스를 제공하고 있습니다. 각 회원가입 절차는 해당 사용자가 기존 회원인지 인증 후 회원가입 절차를 진행할 수 있습니다.

신규 회원의 경우 다음과 같은 절차를 통해 회원가입이 진행 됩니다.

* \[회원가입] 버튼 클릭 > 본인인증 진행 > 회원가입 페이지
* \[간편로그인] 버튼 클릭 > 간편 로그인 인증 진행 > 회원가입 페이지

***

## 본인 인증하기

로그인 페이지에서 \[회원가입] 버튼을 클릭하여 본인인증 절차를 진행합니다.

정상적인 본인인증 절차가 완료된 후 회원가입 절차를 진행할 수 있습니다.

<figure><img src="https://2999922013-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXTxKSWMmuxEkop1pvuwe%2Fuploads%2FXVP6gm4nx2wIX9vnDyJR%2FFO%20API%20%ED%99%9C%EC%9A%A9%ED%95%98%EA%B8%B0%20-%20%ED%9A%8C%EC%9B%90%EA%B0%80%EC%9E%851.drawio.png?alt=media&#x26;token=7793777d-3aa6-483b-85bd-a7e2f8eebcd2" alt="" width="375"><figcaption></figcaption></figure>

{% stepper %}
{% step %}

### 휴대폰 본인인증하기

회원 가입 여부를 판단하기 위한 본인인증 절차를 진행합니다.

* **본인인증 호출 (**[🔗API 확인하기 >](https://api.x2bee.com/content?msa=member\&depth=%EB%B3%B8%EC%9D%B8%EC%9D%B8%EC%A6%9D%ED%98%B8%EC%B6%9C/getOAuthToken))\
  Nice 본인인증 팝업을 호출하기 위해서 Nice → token 정보를 가져옵니다.
  \
  token 정보가 유효하고, 암호화 대상 token정보를 Nice에 전달하여 본인인증 팝업창을 \
  생성합니다.

```
POST /v1/member/getOAuthToken 
```

{% endstep %}

{% step %}

### 인증 확인하기

Nice 본인인증을 진행하고, 팝업창을 닫게 되면 인증 확인이 되며, Nice에 전달한 암호화 정보데이터를 복호화하여 인증확인을 하고, 본인인증 이력도 동시에 저장합니다.

* **회원 본인인증 이력 저장 (**[🔗API 확인하기 >](https://api.x2bee.com/content?msa=member\&depth=%EB%B3%B8%EC%9D%B8%EC%9D%B8%EC%A6%9D%20%EA%B2%B0%EA%B3%BC/niceOpenResponse))\
  본인인증을 진행하고, 인증을 한 모든 것은 이력으로 저장됩니다.

```
POST /v1/member/niceOpenResponse
```

{% endstep %}
{% endstepper %}

***

## 간편 로그인 인증하기

X2BEE에서 쉬운 로그인을 위해 제공하는 간편 로그인 서비스는 카카오, 네이버입니다.

간편 로그인 서비스에 등록되지 않은 회원은 각 서비스별 로그인 및 인증 절차를 진행합니다.

정상적인 인증 절차가 완료되면 다음과 같이 진행됩니다.

* **회원인 경우: 기존 회원 아이디와 연동 안내 팝업**
* **비회원인 경우: 회원가입 페이지로 이동**

<figure><img src="https://2999922013-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXTxKSWMmuxEkop1pvuwe%2Fuploads%2FUPCWIYex9FzCLsvsginx%2FFO%20API%20%ED%99%9C%EC%9A%A9%ED%95%98%EA%B8%B0%20-%20%EA%B0%84%ED%8E%B8%EB%A1%9C%EA%B7%B8%EC%9D%B8%20%EC%9D%B8%EC%A6%9D.drawio.png?alt=media&#x26;token=b538d4ba-5add-4f45-8328-b76c662cf106" alt="" width="375"><figcaption></figcaption></figure>

{% stepper %}
{% step %}

### 인증 동의하기

카카오, 네이버의 로그인 API를 통해 발급된 각 간편 로그인 서비스의 인가코드를 통해 자사 사이트의 회원여부를 체크할 수 있습니다. 해당 API는 본인 인증과 동일한 API를 활용합니다.

* **회원 본인인증 이력 저장**([🔗API 확인하기 >](https://api.x2bee.com/content?msa=member\&depth=%EB%B3%B8%EC%9D%B8%EC%9D%B8%EC%A6%9D/saveCertiInfo))\
  각 API 모듈에서 본인인증 완료 후 회원 성인인증 및 본인인증 이력을 저장합니다.

```
POST /v1/member/certiInfo
```

{% endstep %}

{% step %}

### 간편 로그인 연동하기

쇼핑몰 회원으로 이미 등록된 경우 간편 로그인으로 연동을 알리는 팝업이 나타나며 \[확인] 버튼을 클릭하면 연동됩니다.비회원인 경우는 회원가입 페이지로 이동해 회원가입 절차를 진행합니다.

#### 2.1 간편 로그인 계정정보 조회하기

로그인할 소셜계정 정보를 찾아 인증한 후, 후처리 방식을 결정합니다.

* **간편 로그인 계정정보 조회 (**[🔗API 확인하기 >](https://api.x2bee.com/content?msa=member\&depth=%EB%A1%9C%EA%B7%B8%EC%9D%B8/check))\
  해당 간편 로그인 계정 정보로 기 연동여부, 소셜계정의 CI 인증여부를 조회합니다.

```
POST /v1/social/check
```

#### 2.2 본인인증 CI 회원정보 조회하기

* **본인 인증 CI회원정보 조회**([🔗API 확인하기 >](https://api.x2bee.com/content?msa=member\&depth=%ED%9A%8C%EC%9B%90%EA%B0%80%EC%9E%85/getCheckMobileCert))\
  소셜계정의 CI 인증여부가 N인 경우, 본인인증을 진행합니다. \
  본인인증 후, 해당 CI 연계 값을 통하여 기존 회원 정보를 조회합니다.

```
POST /v1/member/checkMobileCert
```

#### 2.3 간편 로그인 연동하기

회원 가입 여부를 판단하기 위한 본인인증 절차를 진행합니다.

* **소셜로그인 처리** ([🔗API 확인하기 >](http://api.x2bee.com/content?msa=member\&depth=%EB%A1%9C%EA%B7%B8%EC%9D%B8\&path=connect))\
  각 간편 로그인 서비스로부터 전달받은 데이터를 활용하여 자사 사이트 회원 여부를 체크하여 연동 및 로그인 처리를 진행합니다.

```
POST /v1/social/connect
```

{% endstep %}
{% endstepper %}

***

## 회원 가입하기

가입되지 않은 사용자는 본인인증 절차 혹은 간편 로그인을 통한 회원가입을 완료하면 회원가입 절차를\
진행합니다.

<figure><img src="https://2999922013-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXTxKSWMmuxEkop1pvuwe%2Fuploads%2FAYKzFmrUHt1R1tp3oXBH%2Fimage.png?alt=media&#x26;token=064f950f-bdfb-4bb7-acc8-92aac7da43e6" alt="" width="200"><figcaption></figcaption></figure>

{% stepper %}
{% step %}

### 회원가입 버튼 클릭

회원가입 화면에서 필수값 입력을 완료하고 \[회원가입] 버튼을 클릭하면 회원가입 요청이 완료됩니다.

* **회원가입 (**[🔗API 확인하기 >](https://api.x2bee.com/content?msa=member\&depth=%ED%9A%8C%EC%9B%90%EA%B0%80%EC%9E%85/insertMemberJoin))\
  사용자가 입력한 정보로 회원가입을 요청합니다.

```
POST /v1/member/memberJoin
```

{% endstep %}
{% endstepper %}