# 회원가입

<div align="left"><figure><img src="https://67612295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLt0GowPleXLWRjzGIAiV%2Fuploads%2FpdqYYXA2jWvg1GtZUHaJ%2F%E1%84%92%E1%85%AC%E1%84%8B%E1%85%AF%E1%86%AB%E1%84%80%E1%85%A1%E1%84%8B%E1%85%B5%E1%86%B8.png?alt=media&#x26;token=05d3d1cf-19e7-4c3d-9069-95be53b660da" alt="" width="375"><figcaption></figcaption></figure></div>

일반 회원가입 / 간편 회원가입 중 하나를 선택합니다.&#x20;

* 일반 회원가입
  * 아래 문서에서 상세 프로세스를 화면 별로 안내해 드립니다.
* 간편 회원가입
  * [간편 로그인](https://workspace-help.nhn-commerce.com/aurora-guide/api-1/open-id) 문서 내용을 참고하시길 바랍니다. &#x20;

***

### 일반 회원가입 화면

<div align="left"><figure><img src="https://67612295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLt0GowPleXLWRjzGIAiV%2Fuploads%2Fwr0fWGXUZO9EYN5AMtqM%2Fimage.png?alt=media&#x26;token=f41e083e-8008-4290-951d-ffbc065796d2" alt="" width="375"><figcaption></figcaption></figure></div>

* 🅐[ 회원정보 입력 영역](#a)
* 🅑[ 약관동의 영역](#b)
* 🅒[ 회원가입 완료](#c)
* 🅓 [회원가입 승인대기](#undefined-10)

***

### 🅐 회원정보 입력 영역

회원가입 항목은 아래 어드민에서 설정이 가능합니다.&#x20;

```
shop by basic/pro : 회원 > 회원관리 > 회원가입 항목 관리
shop by premium : 회원관리 > 회원가입 항목 관리
```

#### ■  회원가입 시 입력 항목

* 아이디
* 비밀번호
* 비밀번호 확인
* 이름
* 닉네임
* 이메일 주소
* 휴대폰 번호
* 전화번호
* 주소
* 생년월일
* 성별

{% hint style="info" %}
단, 회원가입 항목은 어드민 '회원가입 항목 관리'에서 '사용함'으로 설정된 항목만 노출됩니다.&#x20;
{% endhint %}

#### ■ 입력 정보 중복 여부 확인

회원정보 입력 항목 중 아이디, 이메일, 닉네임의 경우 중복 여부를 확인해야 합니다.

오로라 개별형 기본 스킨에서는 해당 쇼핑몰 내 중복된 회원정보가 없을 경우 *'ex) 사용 가능한 아이디 입니다.'* 라는 안내 메시지를 노출하며, 중복된 회원정보가 존재하는 경우 *'ex) 이미 사용중인 아이디 입니다.  다른 아이디를 입력해 주세요.'* 라는 안내 메세지를 노출합니다.&#x20;

> [GET /profile/id/exist](https://docs.shopby.co.kr/?url.primaryName=member/#/Profile/get-profile-ci-exists)
>
> ► CI 중복 확인하기\
> 해당 쇼핑몰에 이미 해당 아이디로 가입한 회원이 존재하는지 확인합니다.&#x20;

> [GET /profile/email/exist](https://docs.shopby.co.kr/?url.primaryName=member/#/Profile/get-profile-email-exist)
>
> ► 이메일 중복 여부 체크하기\
> 해당 쇼핑몰에 이미 해당 이메일로 가입한 회원이 존재하는지 확인합니다.&#x20;

> [GET /profile/nickname/exist](https://docs.shopby.co.kr/?url.primaryName=member/#/Profile/get-profile-nickname-exist)
>
> ► 닉네임 중복 여부 체크하기\
> 해당 쇼핑몰에 이미 해당 닉네임으로 가입한 회원이 존재하는지 확인합니다.&#x20;

#### ■ 인증번호 노출 여부

이메일 인증 버튼, SMS 인증 버튼 또는 휴대폰 본인인증 버튼의 경우 [샵바이 API 호출 가이드](https://workspace-help.nhn-commerce.com/aurora-guide/api/shopbyapi) 문서에서 소개한\ <mark style="background-color:yellow;">GET /malls</mark> 를 통해 어드민의 이메일/SMS/휴대폰 인증 사용함 여부를 확인하여 인증버튼 노출 여부를 결정합니다.&#x20;

아래 어드민에서 설정할 수 있습니다.&#x20;

```
shop by basic/pro : 설정 > 기본정책 > 쇼핑몰관리 > 회원 인증 설정
shop by premium : 서비스관리 > 쇼핑몰관리 > 회원 인증 설정
```

<div><figure><img src="https://67612295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLt0GowPleXLWRjzGIAiV%2Fuploads%2FESpLY7k5ZzrNiCXUjLgc%2F%E1%84%8B%E1%85%B5%E1%84%86%E1%85%A6%E1%84%8B%E1%85%B5%E1%86%AF%20%E1%84%8B%E1%85%B5%E1%86%AB%E1%84%8C%E1%85%B3%E1%86%BC.png?alt=media&#x26;token=8a183aa6-c1fc-4502-a304-cd7b9bc4bc63" alt=""><figcaption><p>이메일인증</p></figcaption></figure> <figure><img src="https://67612295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLt0GowPleXLWRjzGIAiV%2Fuploads%2FbsIvWjpzV7odTWDqlkvu%2Fsms%E1%84%8B%E1%85%B5%E1%86%AB%E1%84%8C%E1%85%B3%E1%86%BC.png?alt=media&#x26;token=9801ee39-7887-4b1e-9ab3-b3dd9a6739c8" alt=""><figcaption><p>SMS인증</p></figcaption></figure> <figure><img src="https://67612295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLt0GowPleXLWRjzGIAiV%2Fuploads%2F6R3FphFVBPCh8s4ZqKP4%2F%E1%84%92%E1%85%B2%E1%84%83%E1%85%A2%E1%84%91%E1%85%A9%E1%86%AB%20%E1%84%87%E1%85%A5%E1%86%AB%E1%84%92%E1%85%A9%20%E1%84%8B%E1%85%B5%E1%86%AB%E1%84%8C%E1%85%B3%E1%86%BC.png?alt=media&#x26;token=7d2f2b27-84e3-4a21-90bc-0a142470e2f3" alt=""><figcaption><p>휴대폰인증</p></figcaption></figure></div>

* 인증 종류 설정&#x20;
  * 이메일인증 선택 시 : 이메일 인증 버튼 노출
  * SMS인증 선택 시 : SMS 인증 버튼 노출
  * 휴대폰인증 선택 시 : 휴대폰 본인인증 버튼 노출

> [GET /malls](https://docs.shopby.co.kr/?url.primaryName=admin/#/Mall/get-malls)\
> ► 쇼핑몰 기본 정보 조회하기\
> 쇼핑몰 전반에 대한 기본 정보와 설정 데이터를 조회할 수 있습니다.

해당 API는 쇼핑몰 어느 화면에서든 공통적으로 필요한 기본 API 입니다.

#### ■ 인증번호 발송 및 확인

이메일, SMS, 휴대폰 인증 모두 아래 API가 동일하게 적용됩니다.&#x20;

> [POST /authentications](https://docs.shopby.co.kr/?url.primaryName=auth/#/Authentication/SendAuthenticationNumber)
>
> ► 인증번호 발송하기\
> 인증번호를 발송 합니다.&#x20;

회원의 연락처 또는 입력한 연락처로 인증번호를 발송합니다.\
해당 API는 회원가입 화면 뿐만 아니라, 아이디/비밀번호 찾기 및 회원정보 수정 등의 화면에서도 사용됩니다. \
Request body 내 <mark style="background-color:yellow;">type</mark>에서 SMS인증의 경우 SMS, 이메일 인증의 경우 EMAIL을 입력합니다.

* SMS 인증 : 5분
* 이메일 인증 : 10분

> [GET /authentications](https://docs.shopby.co.kr/?url.primaryName=auth/#/Authentication/get-authentications)
>
> ► 인증번호 확인하기\
> 입력 받은 인증번호를 확인합니다.&#x20;

사용자로부터 입력 받은 인증 번호의 유효성을 체크하며, 실패 시 에러코드 메시지를 전달합니다.

#### ■ 우편번호 찾기

우편번호 찾기 버튼 클릭 시, 우편번호 찾기 레이어 팝업이 출력됩니다.

<div align="left"><figure><img src="https://67612295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLt0GowPleXLWRjzGIAiV%2Fuploads%2FtuUVt0xoxUGsmajcWoU1%2F%E1%84%8B%E1%85%AE%E1%84%91%E1%85%A7%E1%86%AB%E1%84%87%E1%85%A5%E1%86%AB%E1%84%92%E1%85%A9%20%E1%84%8E%E1%85%A1%E1%86%BD%E1%84%80%E1%85%B5.png?alt=media&#x26;token=e79ec9bf-9a25-4e92-b53f-c1e65d7a496c" alt="" width="375"><figcaption></figcaption></figure></div>

> [GET /addresses/search](https://docs.shopby.co.kr/?url.primaryName=manage/#/Address/search-addresses)
>
> ► 주소 조회하기\
> 검색 키워드로 주소 정보를 조회합니다.&#x20;

***

### 🅑 약관동의 영역

<div align="left"><figure><img src="https://67612295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLt0GowPleXLWRjzGIAiV%2Fuploads%2FWT7Qzt2XR8V254YPMk1f%2F%E1%84%8B%E1%85%A3%E1%86%A8%E1%84%80%E1%85%AA%E1%86%AB%E1%84%83%E1%85%A9%E1%86%BC%E1%84%8B%E1%85%B4.png?alt=media&#x26;token=833f5d38-bb30-4790-8959-f89f0d3edd12" alt="" width="375"><figcaption></figcaption></figure></div>

#### ■ 약관 데이터 호출

어드민 아래 경로에서 설정할 수 있습니다.&#x20;

```
shop by basic/pro : 설정 > 기본정책 > 약관/개인정보처리방침
shop by premium : 서비스관리 > 약관/개인정보처리방침
```

> [GET /terms](https://docs.shopby.co.kr/?url.primaryName=manage/#/Terms/search-used-terms)
>
> ► 적용 중인 몰 약관 조회하기\
> 해당 쇼핑몰에 적용 중인 약관을 조회합니다.

해당 API는 회원가입 화면 뿐만 아니라, 주문서 구매 동의 화면 / 회원탈퇴 화면 / 쇼핑몰 푸터 영역에서도 활용됩니다.&#x20;

* 조회할 약관 타입 리스트
  * \[필수] 이용약관 USE
  * \[필수] 전자금융 거래 이용 약관 E\_COMMERCE
  * \[필수] 개인정보 수집 및 이용동의 PI\_COLLECTION\_AND\_USE\_REQUIRED
  * \[필수] 만 14세 이상 가입 동의 PI\_14\_AGE
  * \[선택] 개인정보 수집 및 이용동의 PI\_COLLECTION\_AND\_USE\_OPTIONAL
  * \[선택] 개인정보 처리/위탁에 대한 동의 PI\_PROCESS\_CONSIGNMENT
  * \[선택] 개인정보 제 3자 제공에 대한 동의 PI\_THIRD\_PARTY\_PROVISION
  * \[선택] 마케팅 목적의 개인정보 수집/이용 동의 MARKETING\_INFO\_USAGE
  * \[선택] 광고성 수신 동의 MARKETING\_RECEIVE

`약관/개인정보처리방침`에서 `추가 동의 항목`을 추가할 수 있습니다.\
추가된 동의항목은 [POST /terms/custom 추가 약관 조회하기](https://docs.shopby.co.kr/?url.primaryName=manage/#/Terms/post-search-used-terms) API를 통해 확인할 수 있습니다.

***

### 🅒 회원가입 완료&#x20;

<div align="left"><figure><img src="https://67612295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLt0GowPleXLWRjzGIAiV%2Fuploads%2F51Bb3aJhkSbYfbHLfCHx%2F%E1%84%80%E1%85%A1%E1%84%8B%E1%85%B5%E1%86%B8%20%E1%84%8B%E1%85%AA%E1%86%AB%E1%84%85%E1%85%AD.png?alt=media&#x26;token=8f3fb352-307c-4ca0-8784-06d30c6dfb5d" alt="" width="375"><figcaption></figcaption></figure></div>

POST /profile 을 통해 회원가입이 진행됩니다.&#x20;

> [POST /profile](https://docs.shopby.co.kr/?url.primaryName=member/#/Profile/post-profile)
>
> ► 프로필 생성하기\
> 회원 프로필이 등록됩니다.&#x20;

***

### 🅓 회원가입 승인대기

회원가입 승인 사용 설정을 '승인 후 가입'으로 설정한 경우 사용자가 회원가입 완료 시,\
회원가입 승인대기 화면이 출력됩니다.&#x20;

어드민 아래 경로에서 설정하실 수 있습니다.&#x20;

```
shop by basic/pro : 설정 > 기본정책 > 쇼핑몰 관리 > 쇼핑몰 수정 > 회원 설정 - 회원가입 승인 사용설정
shop by premium : 서비스관리 > 쇼핑몰 관리 > 쇼핑몰 수정 > 회원 설정 - 회원가입 승인 사용설정
```

<div align="left"><figure><img src="https://67612295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLt0GowPleXLWRjzGIAiV%2Fuploads%2FOB5s7SRdqnZtFLcTaVYW%2F%E1%84%92%E1%85%AC%E1%84%8B%E1%85%AF%E1%86%AB%E1%84%80%E1%85%A1%E1%84%8B%E1%85%B5%E1%86%B8%20%E1%84%89%E1%85%B3%E1%86%BC%E1%84%8B%E1%85%B5%E1%86%AB%E1%84%83%E1%85%A2%E1%84%80%E1%85%B5.png?alt=media&#x26;token=ce8562c9-403d-40c0-b258-73d4477bd85f" alt="" width="375"><figcaption></figcaption></figure></div>