> 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/api-guides-en/store-front/member/member-management.md).

# Member Management

Provides functions for managing member information so that shopping mall members can conveniently use the shopping mall. This service includes various features such as viewing, registering, modifying, and deleting account information, managing menu favorites, and configuring simple login.

***

## Key Features

* **Account Information Management**
  * Members can manage the refund account information used when processing order cancellations, returns, and similar actions.
* **Favorites Feature**
  * Members can add and manage favorite menus from among all available menus on My Page.
  * Up to 8 menus can be saved as favorites.
* **Simple Login Configuration**
  * Members can enable or disable simple login through a social account.
  * Naver or Kakao social accounts can be linked.
* **Account Information Lookup**
  * Retrieves the member's account information and social account linkage information from the member database.
* **Account Information Registration and Modification**
  * Members can register new account information in the member database or modify existing registered information.
* **Account Information Deletion**
  * Members can delete registered account information from the member database.
* **Social Account Linkage Restriction Notice**
  * Notifies the member that an account created via social sign-up cannot have that social account linkage removed.
* **Personal Information Modification**
  * Members can add or modify changed personal information.

## Process Definition — 1

<figure><img src="https://2999922013-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXTxKSWMmuxEkop1pvuwe%2Fuploads%2FeevaX4nc3pv3i5U48arr%2F%E1%84%92%E1%85%AC%E1%84%8B%E1%85%AF%E1%86%AB%E1%84%80%E1%85%AA%E1%86%AB%E1%84%85%E1%85%B51.png?alt=media&#x26;token=be93745f-09d2-4a29-80cb-7c84bd0fee5d" alt=""><figcaption></figcaption></figure>

{% stepper %}
{% step %}

### Get Member Refund Account Information

Retrieves the refund account information registered by the member in the member database. The account number is retrieved in masked form.
{% endstep %}

{% step %}

### Delete Member Refund Account Information

Deletes the member's registered refund account information from the member database.
{% endstep %}

{% step %}

### Save Member Refund Account Information

Saves the member's refund account information to the member database. It is not saved unless refund account verification is completed.
{% endstep %}

{% step %}

### Modify Member Favorites

Adds or deletes items in the member's favorites list. Up to 8 favorites can be saved; if the list already has 8 items, no more can be added.
{% endstep %}

{% step %}

### Get Social Account Linkage Information

Retrieves the member's social account linkage information.
{% endstep %}

{% step %}

### Process Social Account Linkage

Links the member's account with a social account. If this is the first linkage with no prior linkage history, the linkage is processed only after social login authentication. If the account was previously linked and then unlinked, it is relinked immediately without requiring social login authentication again. The system checks whether the account is already linked to the given social account.
{% endstep %}

{% step %}

### Unlink Social Account

Unlinks the member's account from a linked social account. Note that a member who signed up using that social account cannot unlink it.
{% endstep %}
{% endstepper %}

## Process Definition — 2

<figure><img src="https://2999922013-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXTxKSWMmuxEkop1pvuwe%2Fuploads%2FIU6pMyxEAlcrP7WZ4txB%2F%E1%84%92%E1%85%AC%E1%84%8B%E1%85%AF%E1%86%AB%E1%84%80%E1%85%AA%E1%86%AB%E1%84%85%E1%85%B52.png?alt=media&#x26;token=045564d3-87ca-4ab9-8acc-a50bf87cb1b3" alt=""><figcaption></figcaption></figure>

{% stepper %}
{% step %}

### Verify Password

The account password is entered to confirm account ownership.
{% endstep %}

{% step %}

### Change Password

Within personal information modification, the password change is handled independently via the Change Password API; refer to the password change flow in \[Find ID/Password] for the password change process.
{% endstep %}

{% step %}

### Identity Verification

When changing the mobile phone number, the NICE identity verification pop-up is used for the modification.\
When changing the member's address, the Daum address pop-up is used for the modification.
{% endstep %}

{% step %}

### Modify Personal Information

Excluding the password change, the changed mobile phone number, date of birth, address, default delivery address status, email, and marketing consent information are collected and saved and modified.
{% endstep %}

{% step %}

### Send Email

When marketing information consent status is changed, the result of the consent change is sent to the email address registered on the account.
{% endstep %}

{% step %}

### Merge Member Basic Delivery Address

Calls the member information sync API on the separately managed event DB to synchronize member information and member delivery address data.
{% endstep %}
{% endstepper %}

## API Function List

<table><thead><tr><th width="105.6666259765625">API</th><th width="333.3333740234375">Description</th><th width="95.77783203125">Server</th><th width="90.22216796875">Method</th><th>Remarks</th></tr></thead><tbody><tr><td>Get Member Refund Account Information</td><td>Retrieves the member's refund account information.</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">🔗View API></a></td></tr><tr><td>Get Common Code (Single)</td><td>Retrieves a single common code.</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">🔗View API ></a></td></tr><tr><td>Save Member Refund Account Information</td><td>Newly registers the member's refund account information, or modifies existing registered information.</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">🔗View API></a></td></tr><tr><td>Delete Member Refund Account Information</td><td>Deletes the member's registered refund account information.</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">🔗View API></a></td></tr><tr><td>Modify Member Favorites</td><td>Adds or deletes the member's menu favorites information.</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">🔗View API></a></td></tr><tr><td>Get Social Account Linkage Information</td><td>Retrieves the member's social account linkage information.</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">🔗View API></a></td></tr><tr><td>Process Social Account Linkage</td><td>Links the member's account to a social account such as Kakao or Naver.</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">🔗View API></a></td></tr><tr><td>Unlink Social Account</td><td>Unlinks the social account the member has linked.</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">🔗View API></a></td></tr><tr><td>Modify Personal Information</td><td>Changes the member's personal information.</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">🔗View API></a><br>Merge member basic delivery address processing: api/event/v1/common/mergeMbrDlvp<br><br></p><p>Send single alert message: api/common/interface/bizmessage/sendmail</p></td></tr><tr><td>Change Password</td><td>Changes the member's password. Personal information modification – password change is not handled through personal information modification and is executed independently.</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">🔗View API></a></p><p>[Find ID/Password] mid-category API</p></td></tr></tbody></table>

## Definition of Terms

<table><thead><tr><th width="97.333251953125">Term</th><th>Description</th><th data-hidden></th></tr></thead><tbody><tr><td>Social Account</td><td>Social account login refers to the feature that allows users to log in to or sign up for various other internet services using account information from major domestic and international portal sites, social media, and similar platforms.<br>The X2BEE service currently provides linkage with Naver and Kakao.</td><td></td></tr></tbody></table>

## Other Notes

* **External APIs**
  * Account verification is performed using the Inicis API.
  * Postal address lookup is performed using the Daum Address API.
  * Phone number identity verification is performed using the NICE identity verification API.
* The Modify Member Favorites API takes a `type` parameter. When type is 10, the registration process runs; when type is 20, the deletion process runs.
  * If a value other than 10 or 20 is provided for type, an exception occurs.
* The first time a social account is linked, social login authentication is performed through the respective social (Kakao, Naver) API.
* Password Change
  * Password changes are processed independently using the Change Password API rather than the Modify Personal Information API.
  * Personal information modification – password change is a process that runs after the prior password verification step, using the 'immediate change' service among the password change processes.
  * A detailed description of the Change Password API can be found on page 6 of the \[Find ID/Password] feature overview document.
* Personal Information Modification
  * The following six items can be changed: 'mobile phone number', 'date of birth', 'address', 'default delivery address status', 'email', and 'marketing information consent'.
  * A member's name after a legal name change can only be modified by an administrator, for use in 1:1 inquiries or customer service calls.
  * If the marketing information consent status is changed, the result of the change is sent to the member's email.
  * The 'Merge Member Basic Delivery Address' API is called to synchronize information with the separately managed event DB.

##