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

# 회원관리

쇼핑몰 회원이 쇼핑몰을 편리하게 이용할 수 있도록 회원 정보를 관리하는 기능을 제공합니다. 이 서비스는 회원의 계좌 정보 조회, 등록, 수정, 삭제, 메뉴 즐겨찾기, 간편 로그인 설정 등 다양한 기능을 포함하고 있습니다.

***

## 주요 기능

* **계좌 정보 관리**
  * 회원은 주문 취소, 반품 등을 처리할 때 사용하는 환불 받을 계좌 정보를 관리할 수 있습니다.
* **즐겨찾기 기능**
  * 회원은 마이페이지에서 전체 메뉴 중 즐겨찾는 메뉴를 추가하고 관리할 수 있습니다.
  * 최대 8개의 메뉴까지 즐겨찾기에 저장 가능합니다.
* **간편 로그인 설정**
  * 회원은 소셜 계정을 통한 간편 로그인을 설정하거나 해제할 수 있습니다.
  * 네이버나 카카오 소셜 계정을 연동할 수 있습니다.
* **계정 정보 조회**
  * 회원 데이터베이스에서 회원의 계좌 정보 및 소셜 계정 연동 정보를 조회합니다.
* **계정 정보 등록 및 수정**
  * 회원은 회원 데이터베이스에 계좌 정보를 등록하거나 기존 등록된 정보를 수정할 수 있습니다.
* **계정 정보 삭제**
  * 회원은 회원 데이터베이스에서 등록된 계좌 정보를 삭제할 수 있습니다.
* **소셜 계정 연동 불가 안내**
  * 소셜 계정으로 회원 가입한 경우 해당 계정 연동을 해제할 수 없음을 안내합니다.
* **개인정보 수정**
  * 회원은 변경된 개인정보를 추가하거나 수정할 수 있습니다.

## 프로세스 정의 — 1

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

{% stepper %}
{% step %}

### 회원 환불 계좌 정보 조회

회원 데이터베이스에 회원이 등록한 환불 계좌 정보를 조회합니다. 이 때, 계좌번호는 마스킹 된 정보가 조회됩니다.
{% endstep %}

{% step %}

### 회원 환불 계좌 정보 삭제

회원이 등록한 회원 환불 계좌 정보를 회원 데이터베이스에서 삭제합니다.
{% endstep %}

{% step %}

### 회원 환불 계좌 정보 저장

회원의 환불 계좌 정보를 회원 데이터베이스에 저장합니다. 환불계좌 인증을 하지 않으면 저장되지 않습니다.
{% endstep %}

{% step %}

### 회원 즐겨찾기 수정

회원의 즐겨찾기 목록을 등록하거나 삭제합니다. 즐겨찾기는 최대 8개까지 저장되어 현재 저장 목록이 8개일 경우 더 이상 추가되지 않습니다.
{% endstep %}

{% step %}

### 소셜 계정 연동정보 조회

회원의 소셜 계정 연동 정보를 조회합니다.
{% endstep %}

{% step %}

### 소셜 계정 연동 처리

회원의 계정을 소셜 계정과 연동합니다. 만약 기존 연동한 이력이 없는 최초 연동이라면 해당 소셜 로그인 인증을 해야 연동 처리가 됩니다. 기존에 연동을 한 후 연동을 해제한 상태라면 소셜 로그인 인증 절차를 거치지 않고 바로 연동하게 됩니다. 이미 해당 소셜 계정과 연동 되어있는 상태인지 확인합니다.
{% endstep %}

{% step %}

### 소셜 계정 연동 해제

소셜 계정에 연동되어 있는 회원의 계정을 연동 해제처리 합니다. 이 때, 해당 소셜 계정으로 회원가입을 진행한 회원은 해당 소셜 계정과 연동을 해제할 수 없습니다.
{% endstep %}
{% endstepper %}

## 프로세스 정의 — 2

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

{% stepper %}
{% step %}

### 비밀번호 확인

계정 비밀번호를 입력하여 계정 소유주임을 확인 합니다.
{% endstep %}

{% step %}

### 비밀번호 변경

개인정보 수정 중 비밀번호 변경은 비밀번호 변경 API를 사용하여 단독으로 변경되며, 비밀번호 변경 프로세스는 \[아이디 비밀번호 찾기 기능개요] 중 비밀번호 변경 흐름도를 참고 해주세요.
{% endstep %}

{% step %}

### 본인인증

휴대폰번호 변경 시 NICE 본인인증 팝업을 활용하여 수정합니다. \
회원 주소 변경 시 다음주소 팝업을 활용하여 수정합니다.
{% endstep %}

{% step %}

### 개인정보 수정

비밀번호 변경을 제외한 변경된 휴대폰번호, 생년월일, 주소, 기본 배송지 여부, 이메일, 마케팅 수신정보를 취합하여 개인정보를 저장 및 수정 합니다.
{% endstep %}

{% step %}

### 이메일 전송

마케팅 정보 수신동의 변경 시 수신동의여부 결과가 계정에 입력된 이메일로 전송 됩니다.
{% endstep %}

{% step %}

### 회원 기본 배송지 병합

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

## API 기능 목록

<table><thead><tr><th width="105.6666259765625">API</th><th width="333.3333740234375">설명</th><th width="95.77783203125">Server</th><th width="90.22216796875">메소드</th><th>비고</th></tr></thead><tbody><tr><td>회원 환불 계좌 정보 조회</td><td>회원의 환불 계좌 정보를 조회합니다.</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%B4%80%EB%A6%AC&#x26;path=getMbrRfdActnInfo">🔗API 확인하기></a></td></tr><tr><td>공통코드 단건 조회</td><td>공통코드를 단건으로 조회합니다.</td><td>Common</td><td>GET</td><td><a href="http://api.x2bee.com/content?msa=common&#x26;depth=%EA%B3%B5%ED%86%B5&#x26;path=getGrp">🔗API 확인하기 ></a></td></tr><tr><td>회원 환불 계좌 정보 저장</td><td>회원의 환불 계좌 정보를 새로 등록하거나 기존의 등록 되어 있는 정보를 수정합니다.</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%B4%80%EB%A6%AC&#x26;path=saveMbrRfdActnInfo">🔗API 확인하기></a></td></tr><tr><td>회원 환불 계좌 정보 삭제</td><td>회원의 등록되어 있는 환불 계좌 정보를 <br>삭제합니다.</td><td>Member</td><td>DELTE</td><td><a href="http://api.x2bee.com/content?msa=member&#x26;depth=%ED%9A%8C%EC%9B%90%EA%B4%80%EB%A6%AC&#x26;path=deleteMbrRfdActnInfo">🔗API 확인하기></a></td></tr><tr><td>회원 즐겨찾기 수정</td><td>회원의 메뉴 즐겨찾기 정보를 추가하거나 삭제합니다.</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%B4%80%EB%A6%AC&#x26;path=bkmkMenu">🔗API 확인하기></a></td></tr><tr><td>소셜 계정 연동정보 조회</td><td>회원의 소셜 계정 연동 정보를 조회합니다.</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%B4%80%EB%A6%AC&#x26;path=snsLinkInfo">🔗API 확인하기></a></td></tr><tr><td>소셜 계정 연동 처리</td><td>회원의 계정을 카카오나 네이버 같은 소셜 계정에 연동할 수 있습니다.</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%B4%80%EB%A6%AC&#x26;path=snsLinkConnect">🔗API 확인하기></a></td></tr><tr><td>소셜 계정 연동 해제</td><td>회원이 연동하고 있는 소셜 계정을 해제 <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%B4%80%EB%A6%AC&#x26;path=snsLinkCancel">🔗API 확인하기></a></td></tr><tr><td>개인정보 수정</td><td>회원의 개인정보를 변경합니다.</td><td>Member</td><td>PUT</td><td><p><a href="http://api.x2bee.com/content?msa=member&#x26;depth=%ED%9A%8C%EC%9B%90%EA%B4%80%EB%A6%AC&#x26;path=modifyMemberInfo">🔗API 확인하기></a><br>회원 기본 배송지 병합 처리: api/event/v1/common/mergeMbrDlvp<br><br></p><p>알림메시지 단건 전송: api/common/interface/bizmessage/sendmail</p></td></tr><tr><td>비밀번호 수정</td><td>회원의 비밀번호를 수정합니다. 개인정보 수정 – 비밀번호 변경은 개인정보 수정에서 진행되지 않으며, 단독으로 실행됩니다.</td><td>Member</td><td>PUT</td><td><p><a href="http://api.x2bee.com/content?msa=member&#x26;depth=%EC%95%84%EC%9D%B4%EB%94%94%20%EB%B9%84%EB%B0%80%EB%B2%88%ED%98%B8%EC%B0%BE%EA%B8%B0&#x26;path=modifyPassword">🔗API 확인하기></a></p><p>[아이디 비밀번호 찾기] 중분류 API</p></td></tr></tbody></table>

## 용어 정의

<table><thead><tr><th width="97.333251953125">명칭</th><th>설명</th><th data-hidden></th></tr></thead><tbody><tr><td>소셜 계정</td><td>소셜 계정 로그인이란 국내외 대표 포털 사이트, 소셜 미디어 등의 계정 정보를 이용해 다른 여러 인터넷 서비스를 로그인 또는 회원가입할 수 있는 기능을 말합니다. <br>현재 X2BEE 서비스에서는 네이버와 카카오 연동을 제공하고 있습니다.</td><td></td></tr></tbody></table>

## 기타 참고사항

* **외부 API**
  * 계좌 인증은 이니시스 API를 이용해 진행됩니다.
  * 우편주소 조회는 다음 주소 API를 이용해 진행됩니다.
  * 전화번호 본인 인증은 NICE 본인인증 API를 이용해 진행됩니다.
* 회원 즐겨찾기 수정 API 파라미터로 type을 받습니다. type 이 10일 때 등록 프로세스가, 20일 때 삭제 프로세스가 실행됩니다.
  * type의 값이 10이나 20 이외에 다른 값이 들어오면 예외가 발생합니다.
* 최초 소셜 계정 연동 시 해당 소셜(카카오, 네이버) API를 통해 소셜 로그인 인증을 진행합니다.
* 비밀번호 변경
  * 비밀번호 변경의 경우 개인정보 수정 API를 사용하지 않고 비밀번호 변경 API를 사용하여 단독 처리 됩니다.
  * 개인정보 수정 – 비밀번호 변경은 이전 과정 중 비밀번호 확인 과정 이후 진행하는 프로세스로, 비밀번호 변경 프로세스 중 ’즉시 변경’ 서비스를 사용하여 진행됩니다.
  * 비밀번호 변경 API의 상세한 설명은 \[아이디 비밀번호 찾기] 기능 개요 문서의 6번 페이지에서 확인하실 수 있습니다.
* 개인정보 수정
  * 개인정보 수정 사항으로는 ’휴대폰 번호’, ‘생년월일’, ‘주소’, ‘기본배송지 여부’, ‘이메일’, ‘마케팅 정보 수신 동의’ 총 6가지 정보를 변경할 수 있습니다.
  * 개명한 회원의 이름은 1:1 문의 혹은 고객센터 통화를 위하여 관리자 권한에 한하여 변경이 가능합니다.
  * 마케팅 정보 수신동의 여부가 변경 된 경우 회원의 이메일로 마케팅 정보 수신동의 변경 결과가 전송 됩니다.
  * 별도로 관리 되고 있는 이벤트 DB의 정보 동기화를 위하여 ‘회원 기본 배송지 병합’ API를 호출합니다.

##