> 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/store-front-api/member-api/undefined-5.md).

# 회원탈퇴

## 회원탈퇴

> \## 기능설명\
> \* 회원탈퇴를 처리합니다.\
> \---\
> \## 상세설명\
> \* 탈퇴 가능여부를 체크합니다. ( API URL : \*\*/api/member/v1/withdrawal/chkWithdrawalMember\*\* )\
> \* 회원 상태를 탈퇴로 변경하고, 화면에서 넘어온 탈퇴사유를 저장합니다.\
> \* 연동된 소셜로그인 계정 존재 시 연동을 해제처리합니다.\
> \* 탈퇴 대상 회원의 회원정보, 주문내역, 1:1문의내역, 상품문의내역, 이벤트내역에 존재하는 개인정보를 마스킹처리합니다.\
> \* 정상적으로 탈퇴 되면 탈퇴메일, 탈퇴알림톡을 전송합니다.\
> \---\
> \## 특이사항\
> \* 로그인이 필수입니다.\
> \* 주문내역, 1:1문의내역, 상품문의내역, 이벤트내역 중 마스킹 처리가 실패된 내역 존재 시 분리보관 실패데이터를 쌓아 재처리할 수 있도록합니다.<br>

```json
{"openapi":"3.1.0","info":{"title":"X2BEE Member API","version":"v1"},"servers":[{"url":"https://api-member.x2bee.com/api/member/","description":"prd"}],"paths":{"/v1/withdrawal/procWithdrawal":{"post":{"tags":["회원탈퇴"],"summary":"회원탈퇴","description":"## 기능설명\n* 회원탈퇴를 처리합니다.\n---\n## 상세설명\n* 탈퇴 가능여부를 체크합니다. ( API URL : **/api/member/v1/withdrawal/chkWithdrawalMember** )\n* 회원 상태를 탈퇴로 변경하고, 화면에서 넘어온 탈퇴사유를 저장합니다.\n* 연동된 소셜로그인 계정 존재 시 연동을 해제처리합니다.\n* 탈퇴 대상 회원의 회원정보, 주문내역, 1:1문의내역, 상품문의내역, 이벤트내역에 존재하는 개인정보를 마스킹처리합니다.\n* 정상적으로 탈퇴 되면 탈퇴메일, 탈퇴알림톡을 전송합니다.\n---\n## 특이사항\n* 로그인이 필수입니다.\n* 주문내역, 1:1문의내역, 상품문의내역, 이벤트내역 중 마스킹 처리가 실패된 내역 존재 시 분리보관 실패데이터를 쌓아 재처리할 수 있도록합니다.\n","operationId":"withdrawal","parameters":[{"name":"withDrawalRequest","in":"query","description":"탈퇴회원 정보","required":true,"schema":{"type":"string","description":"WithDrawalRequest"}},{"name":"userDetail","in":"query","description":"회원 정보","required":true,"schema":{"type":"string","description":"UserDetail"}},{"name":"Authorization","in":"header","description":"Access Token","required":false}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WithDrawalRequest"}}},"required":true},"responses":{"200":{"description":"성공"},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"WithDrawalRequest":{"type":"object","description":"회원탈퇴 Request","properties":{"mbrNo":{"type":"string","description":"회원번호"},"reasonList":{"type":"array","description":"탈퇴사유리스트","items":{"$ref":"#/components/schemas/WithdrawReason"},"minItems":1},"etWdraCausList":{"type":"array","items":{"$ref":"#/components/schemas/EtMbrWdraCausInfo"}}},"required":["mbrNo","reasonList"]},"WithdrawReason":{"type":"object","description":"회원탈퇴사유 Request","properties":{"cd":{"type":"string","description":"회원탈퇴 사유 중분류코드","enum":["PRIVACY","SITE","SERVICE","SYSTEM"]},"lgrpCd":{"type":"string","description":"회원탈퇴 사유 대분류코드","enum":["CHANGE_ID","LONG_ABSENCE","INFORMATION_LEAK","SERVICE_LACK","SITE","LOW_FREQUENCY","BENEFIT_LACK","GOODS","PRICE","DELIVERY","CLAIM","FOLLOW_UP","ETC","SYSTEM"]}},"required":["cd","lgrpCd"]},"EtMbrWdraCausInfo":{"type":"object","properties":{"mbrNo":{"type":"string"},"mbrWdraCausLgrpCd":{"type":"string"},"mbrWdraCausMgrpCd":{"type":"string"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}}}}}
```

## 회원탈퇴 가능여부 조회

> \## 기능설명\
> \* 회원탈퇴 가능여부를 조회합니다.\
> \---\
> \## 상세설명\
> \* 진행 중인 주문 건 존재 시 탈퇴 불가합니다.\
> \* 진행 중인 클레임(교환, 반품) 건 존재 시 탈퇴 불가합니다.\
> \* 진행 중인 1:1 문의 존재 시 탈퇴 불가합니다.\
> \* 사용 가능한 마일리지 존재 시 탈퇴 불가합니다.\
> \* 탈퇴 불가 시 탈퇴실패로그를 생성합니다.\
> \---\
> \## 수정번호\
> \* \`\`\`Release v1.07\_231228\`\`\`: 휴면회원 로직 제거로 인한 공통화 로직 제거<br>

````json
{"openapi":"3.1.0","info":{"title":"X2BEE Member API","version":"v1"},"servers":[{"url":"https://api-member.x2bee.com/api/member/","description":"prd"}],"paths":{"/v1/withdrawal/chkWithdrawalMember":{"post":{"tags":["회원탈퇴"],"summary":"회원탈퇴 가능여부 조회","description":"## 기능설명\n* 회원탈퇴 가능여부를 조회합니다.\n---\n## 상세설명\n* 진행 중인 주문 건 존재 시 탈퇴 불가합니다.\n* 진행 중인 클레임(교환, 반품) 건 존재 시 탈퇴 불가합니다.\n* 진행 중인 1:1 문의 존재 시 탈퇴 불가합니다.\n* 사용 가능한 마일리지 존재 시 탈퇴 불가합니다.\n* 탈퇴 불가 시 탈퇴실패로그를 생성합니다.\n---\n## 수정번호\n* ```Release v1.07_231228```: 휴면회원 로직 제거로 인한 공통화 로직 제거\n","operationId":"chkWithdrawalMember","parameters":[{"name":"userDetail","in":"query","description":"회원 정보","required":true,"schema":{"type":"string","description":"UserDetail"}},{"name":"Authorization","in":"header","description":"Access Token","required":false}],"responses":{"200":{"description":"성공"},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}}}}}
````
