# 회원관리 ## 개인정보 수정 > \## 기능설명\ > \* 회원 개인정보를 변경합니다.\ > \---\ > \## 상세설명\ > \* 기존 입력했던 개인정보에서 변경된 정보가 존재할 경우, 개인정보 변경을 통해 회원의 정보를 업데이트합니다.\ > \* 개인정보 변경이 가능한 정보\ > \* 휴대폰번호\ > \* 생년월일\ > \* 주소 및 기본배송지 주소\ > \* 이메일\ > \* 마케팅이용정보 동의(이메일, SMS)\ > \---\ > \## 특이사항\ > \* baseDlvpYn 필드의 경우 필수 값입니다.\ > \* 개인정보 일부 변경 시 변경되는 정보만 전달되어야 하며, 변경되지 않는 정보는 공란으로 전달되어야합니다.\ > \* 정상 수정 후 이벤트DB에 수정된 배송지순번 및 배송지 정보를 동기화 처리합니다.\
```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/member/modifyMemberInfo":{"put":{"tags":["회원관리"],"summary":"개인정보 수정","description":"## 기능설명\n* 회원 개인정보를 변경합니다.\n---\n## 상세설명\n* 기존 입력했던 개인정보에서 변경된 정보가 존재할 경우, 개인정보 변경을 통해 회원의 정보를 업데이트합니다.\n* 개인정보 변경이 가능한 정보\n * 휴대폰번호\n * 생년월일\n * 주소 및 기본배송지 주소\n * 이메일\n * 마케팅이용정보 동의(이메일, SMS)\n---\n## 특이사항\n* baseDlvpYn 필드의 경우 필수 값입니다.\n* 개인정보 일부 변경 시 변경되는 정보만 전달되어야 하며, 변경되지 않는 정보는 공란으로 전달되어야합니다.\n* 정상 수정 후 이벤트DB에 수정된 배송지순번 및 배송지 정보를 동기화 처리합니다.\n\n","operationId":"modifyMemberInfo","parameters":[{"name":"memberInfoUpdateRequest","in":"query","description":"개인정보 변경 요청 정보","required":true,"schema":{"type":"string","description":"MemberInfoUpdateRequest"}},{"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/MemberInfoUpdateRequest"}}},"required":true},"responses":{"200":{"description":"성공"},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"MemberInfoUpdateRequest":{"type":"object","description":"개인정보 수정 Reqeust","properties":{"mbrNo":{"type":"string","description":"회원번호"},"mbrNm":{"type":"string","description":"회원명"},"mbrMgrCd":{"type":"string","description":"회원관리코드(ME002)","enum":["UNION_MEMBER","GENERAL_MEMBER","SOCIAL_MEMBER","ENTERPRISE_MEMBER","NO_MEMBER"]},"ciCtacVal":{"type":"string","description":"Ci 연계 값"},"cellPhoneFullNo":{"type":"string","description":"휴대폰 전체 번호"},"cellPhoneFirNo":{"type":"string","description":"휴대폰 첫째 번호"},"cellPhoneSecNo":{"type":"string","description":"휴대폰 둘째 번호"},"cellPhoneThirNo":{"type":"string","description":"휴대폰 셋째 번호"},"zipNo":{"type":"string","description":"우편번호"},"address":{"type":"string","description":"주소"},"dtlAddress":{"type":"string","description":"상세 주소"},"mktRecvAgrList":{"type":"array","description":"마케팅 수신 동의 여부 리스트","items":{"$ref":"#/components/schemas/MktRecvAgrRequest"}},"dlvpNm":{"type":"string","description":"배송지명"},"baseDlvpYn":{"type":"string","description":"기본배송지여부"},"brth":{"type":"string","description":"생년월일"},"sexGbCd":{"type":"string","description":"성별구분코드 (ME017) (글로벌 계정 전용)","enum":["MALE","FEMALE"]},"emailAddr":{"type":"string","description":"이메일주소"},"bmanNm":{"type":"string","description":"사업장명"},"repTelFullNo":{"type":"string","description":"대표 전화"},"repTelSctNo":{"type":"string","description":"대표 전화 국번"},"repTelTxnoNo":{"type":"string","description":"대표 전화 중간번호"},"repTelEndNo":{"type":"string","description":"대표 전화 끝번호"},"bplcZipNo":{"type":"string","description":"사업장 우편번호"},"bplcZipAddr":{"type":"string","description":"사업장 주소"},"bplcDtlAddr":{"type":"string","description":"사업장 상세주소"},"mbrStatCd":{"type":"string","description":"회원상태 코드","enum":["NORMAL_MEMBER","STOP_MEMBER","WITHDRAWAL_MEMBER","WAIT_MEMBER","REJECT_MEMBER"]},"aempNm":{"type":"string","description":"담당자명"},"aempCellFullNo":{"type":"string","description":"담당자 휴대폰 전체 번호"},"aempCellSctNo":{"type":"string","description":"담당자 휴대전화구분번호"},"aempCellTxnoNo":{"type":"string","description":"담당자 휴대전화국번번호"},"aempCellEndNo":{"type":"string","description":"담당자 휴대전화끝번호"},"aempCiCtacVal":{"type":"string","description":"담당자 Ci 연계 값"},"aempYn":{"type":"string","description":"담당자 여부"},"joinSgtStatCd":{"type":"string","description":"가입 승인 여부","enum":["MALE","FEMALE"]}},"required":["bmanNm","bplcDtlAddr","bplcZipAddr","bplcZipNo","repTelEndNo","repTelFullNo","repTelSctNo","repTelTxnoNo"]},"MktRecvAgrRequest":{"type":"object","description":"마케팅 수신 동의 여부 DTO","properties":{"svcAgrTypCd":{"type":"string","description":"서비스 동의 유형 코드(ME025)","enum":["SMS","EMAIL","APP_PUSH","AUTO_LOGIN","KAKAO"]},"agrYn":{"type":"string","description":"서비스 동의 여부"}}},"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"}}}}}} ``` ## 소셜 계정 연동 처리 > \## 기능설명\ > \* 로그인된 회원에 대한 소셜계정을 연동 처리합니다.\ > \---\ > \## 상세설명\ > \* 로그인은 및 \*\*소셜 타입(type)\*\*은 필수입니다.\ > \* 최초 연동의 경우 소셜 계정 인증 API(\*\*/api/member/v1/social/check\*\*)을 호출해 소셜 계정에 대한 정보를 가져옵니다.\ > \* 소셜계정의 CI연계값에 대한 회원번호와 토큰 정보의 회원번호가 일치하지 않으면 연동할 수 없습니다.\ > \* 넘어온 소셜 타입과 일치하는 기연동된 소셜 계정이 존재하면 새로 연동할 수 없습니다.\ > \* 기존 회원에 소셜계정 연동정보를 저장합니다. 연동종료일자는 2999-12-31 23:59:59로 지정됩니다.\ > \---\ > \## 수정번호\ > \* \`\`\`Release v2.00\_240530\`\`\`: 구글, 애플인 경우 CI값 미존재로 회원 정보 일치 체크 제외\ > \* \`\`\`Release v2.00\_240627\`\`\`: SNS 연동종료일시 infinity 타입 수정\ > \* \`\`\`Release v2.00\_240627\`\`\`: 구글, 애플인 경우 기 연동 여부 체크하여 중복 연동 불가하도록 수정
````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/social/snsLinkConnect":{"post":{"tags":["회원관리"],"summary":"소셜 계정 연동 처리","description":"## 기능설명\n* 로그인된 회원에 대한 소셜계정을 연동 처리합니다.\n---\n## 상세설명\n* 로그인은 및 **소셜 타입(type)**은 필수입니다.\n* 최초 연동의 경우 소셜 계정 인증 API(**/api/member/v1/social/check**)을 호출해 소셜 계정에 대한 정보를 가져옵니다.\n* 소셜계정의 CI연계값에 대한 회원번호와 토큰 정보의 회원번호가 일치하지 않으면 연동할 수 없습니다.\n* 넘어온 소셜 타입과 일치하는 기연동된 소셜 계정이 존재하면 새로 연동할 수 없습니다.\n* 기존 회원에 소셜계정 연동정보를 저장합니다. 연동종료일자는 2999-12-31 23:59:59로 지정됩니다.\n---\n## 수정번호\n* ```Release v2.00_240530```: 구글, 애플인 경우 CI값 미존재로 회원 정보 일치 체크 제외\n* ```Release v2.00_240627```: SNS 연동종료일시 infinity 타입 수정\n* ```Release v2.00_240627```: 구글, 애플인 경우 기 연동 여부 체크하여 중복 연동 불가하도록 수정\n","operationId":"snsLinkConnect","parameters":[{"name":"socialAuthRequest","in":"query","description":"소셜 계정 연동을 위한 회원 정보","required":true,"schema":{"type":"string","description":"SocialAuthRequest"}},{"name":"Authorization","in":"header","description":"Access Token","required":false}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SocialAuthRequest"}}},"required":true},"responses":{"200":{"description":"성공"},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"SocialAuthRequest":{"type":"object","description":"소셜로그인 인증, 소셜로그인 연동 Request","properties":{"code":{"type":"string","description":"소셜 사이트 인증 성공 시 넘겨주는 인증코드"},"state":{"type":"string","description":"소셜 사이트 인증 시 애플리케이션 상태"},"type":{"type":"string","description":"소셜 타입(ME052)","enum":["KAKAOTALK","NAVER","GOOGLE","APPLE"]}},"required":["code","type"]},"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"}}}}}} ```` ## 소셜 계정 연동 해제 > \## 기능설명\ > \* 액세스 토큰에 대한 회원의 연동소셜계정을 해제합니다.\ > \---\ > \## 상세설명\ > \* 로그인은 필수입니다.\ > \* \*\*소셜 타입(type)\*\*과 \*\*회원 번호(mbrNo)\*\*는 필수입니다.\ > \* 소셜회원일 시 가입했던 소셜타입으로는 해제가 불가능합니다. ex) 네이버 소셜 회원일 시 네이버 연동해제 불가능\ > \* 소셜계정에 대한 연동정보를 해제처리합니다.
```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/social/snsLinkCancel":{"post":{"tags":["회원관리"],"summary":"소셜 계정 연동 해제","description":"## 기능설명\n* 액세스 토큰에 대한 회원의 연동소셜계정을 해제합니다.\n---\n## 상세설명\n* 로그인은 필수입니다.\n* **소셜 타입(type)**과 **회원 번호(mbrNo)**는 필수입니다.\n* 소셜회원일 시 가입했던 소셜타입으로는 해제가 불가능합니다. ex) 네이버 소셜 회원일 시 네이버 연동해제 불가능\n* 소셜계정에 대한 연동정보를 해제처리합니다.\n","operationId":"snsLinkCancel","parameters":[{"name":"socialConnectRequest","in":"query","description":"소셜로그인 연동해제를 위한 회원 정보","required":true,"schema":{"type":"string","description":"SocialConnectRequest"}},{"name":"Authorization","in":"header","description":"Access Token","required":false}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SocialConnectRequest"}}},"required":true},"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/SocialAuthResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"SocialConnectRequest":{"type":"object","description":"소셜로그인 연동, 연동해제 Request","properties":{"type":{"type":"string","description":"소셜 타입(ME052)","enum":["KAKAOTALK","NAVER","GOOGLE","APPLE"]},"mbrNo":{"type":"string","description":"회원번호"},"smpctId":{"type":"string","description":"소셜고유ID"},"emailAddr":{"type":"string","description":"소셜ID"},"loginMediaCd":{"type":"string","description":"로그인매체코드(ME026)","enum":["PC_WEB","MOBILE_WEB","MOBILE_APP"]},"siteNo":{"type":"string","description":"사이트번호"}},"required":["loginMediaCd","mbrNo","smpctId","type"]},"SocialAuthResponse":{"type":"object","description":"소셜로그인 인증 성공 후 사용자 조회 응답값","properties":{"brth":{"type":"string","description":"생년월일"},"mbrNm":{"type":"string","description":"회원명"},"emailAddr":{"type":"string","description":"이메일"},"sexGbCd":{"type":"string","description":"성별구분코드","enum":["MALE","FEMALE"]},"mbrMgrCd":{"type":"string","description":"회원관리코드","enum":["UNION_MEMBER","GENERAL_MEMBER","SOCIAL_MEMBER","ENTERPRISE_MEMBER","NO_MEMBER"]},"ciCtacVal":{"type":"string","description":"CI연계값"},"smpctGbCd":{"type":"string","description":"소셜구분코드","enum":["KAKAOTALK","NAVER","GOOGLE","APPLE"]},"nafrGbCd":{"type":"string","description":"내외국인구분코드"},"phoneNumber":{"type":"string","description":"휴대폰번호"},"mbrNo":{"type":"string","description":"회원번호"},"connectYn":{"type":"string","description":"기연동여부","enum":["Y","N"]},"smpctId":{"type":"string","description":"소셜고유ID"},"loginId":{"type":"string","description":"로그인ID"}}},"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"}}}}}} ``` ## 회원 즐겨찾기 수정 > \## 기능설명\ > \* 회원의 메뉴 즐겨찾기 정보를 수정합니다.\ > \---\ > \## 상세설명\ > \* 로그인은 필수입니다.\ > \* 요청 type이 10이면 등록 20이면 삭제를 진행합니다.\ > \* 메뉴 등록은 최대 8개까지 가능합니다.
```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/myPage/bkmkMenu":{"post":{"tags":["회원관리"],"summary":"회원 즐겨찾기 수정","description":"## 기능설명\n* 회원의 메뉴 즐겨찾기 정보를 수정합니다.\n---\n## 상세설명\n* 로그인은 필수입니다.\n* 요청 type이 10이면 등록 20이면 삭제를 진행합니다.\n* 메뉴 등록은 최대 8개까지 가능합니다.\n","operationId":"bkmkMenu","parameters":[{"name":"Authorization","in":"header","description":"Access Token","required":false}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FavoritesRequest"}}},"required":true},"responses":{"200":{"description":"성공"},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"FavoritesRequest":{"type":"object","properties":{"type":{"type":"string","description":"요청 유형 (10: 등록, 20: 삭제)"},"bkmkMenuId":{"type":"string","description":"즐겨찾기메뉴ID"},"sortSeq":{"type":"string","description":"정렬순서"},"vaildType":{"type":"boolean"}},"required":["bkmkMenuId","type"]},"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"}}}}}} ``` ## 사업자 회원 승인 대기 정보 수정 > \## 기능설명\ > \* 사업자 회원의 승인대기 정보를 수정합니다.\ > \---\ > \## 상세설명\ > \* 기존 입력했던 개인정보에서 변경된 정보가 존재할 경우, 개인정보 변경을 통해 회원의 정보를 업데이트합니다.\ > \---\ > \## 수정번호\ > \* \`\`\`Release v2.01\_250808\`\`\`: 비밀번호 변경 제거
````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/member/modifyEnterpriseMemberInfo":{"post":{"tags":["회원관리"],"summary":"사업자 회원 승인 대기 정보 수정","description":"## 기능설명\n* 사업자 회원의 승인대기 정보를 수정합니다.\n---\n## 상세설명\n* 기존 입력했던 개인정보에서 변경된 정보가 존재할 경우, 개인정보 변경을 통해 회원의 정보를 업데이트합니다.\n---\n## 수정번호\n* ```Release v2.01_250808```: 비밀번호 변경 제거\n","operationId":"modifyEnterpriseMemberInfo","parameters":[{"name":"memberInfoUpdateRequest","in":"query","description":"개인정보 변경 요청 정보","required":true,"schema":{"type":"string","description":"MemberInfoUpdateRequest"}},{"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":{"type":"object","properties":{"memberInfoUpdateRequest":{"$ref":"#/components/schemas/MemberInfoUpdateRequest"},"bmanRegFile":{"type":"string","format":"binary"}},"required":["memberInfoUpdateRequest"]}}}},"responses":{"200":{"description":"성공"},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"MemberInfoUpdateRequest":{"type":"object","description":"개인정보 수정 Reqeust","properties":{"mbrNo":{"type":"string","description":"회원번호"},"mbrNm":{"type":"string","description":"회원명"},"mbrMgrCd":{"type":"string","description":"회원관리코드(ME002)","enum":["UNION_MEMBER","GENERAL_MEMBER","SOCIAL_MEMBER","ENTERPRISE_MEMBER","NO_MEMBER"]},"ciCtacVal":{"type":"string","description":"Ci 연계 값"},"cellPhoneFullNo":{"type":"string","description":"휴대폰 전체 번호"},"cellPhoneFirNo":{"type":"string","description":"휴대폰 첫째 번호"},"cellPhoneSecNo":{"type":"string","description":"휴대폰 둘째 번호"},"cellPhoneThirNo":{"type":"string","description":"휴대폰 셋째 번호"},"zipNo":{"type":"string","description":"우편번호"},"address":{"type":"string","description":"주소"},"dtlAddress":{"type":"string","description":"상세 주소"},"mktRecvAgrList":{"type":"array","description":"마케팅 수신 동의 여부 리스트","items":{"$ref":"#/components/schemas/MktRecvAgrRequest"}},"dlvpNm":{"type":"string","description":"배송지명"},"baseDlvpYn":{"type":"string","description":"기본배송지여부"},"brth":{"type":"string","description":"생년월일"},"sexGbCd":{"type":"string","description":"성별구분코드 (ME017) (글로벌 계정 전용)","enum":["MALE","FEMALE"]},"emailAddr":{"type":"string","description":"이메일주소"},"bmanNm":{"type":"string","description":"사업장명"},"repTelFullNo":{"type":"string","description":"대표 전화"},"repTelSctNo":{"type":"string","description":"대표 전화 국번"},"repTelTxnoNo":{"type":"string","description":"대표 전화 중간번호"},"repTelEndNo":{"type":"string","description":"대표 전화 끝번호"},"bplcZipNo":{"type":"string","description":"사업장 우편번호"},"bplcZipAddr":{"type":"string","description":"사업장 주소"},"bplcDtlAddr":{"type":"string","description":"사업장 상세주소"},"mbrStatCd":{"type":"string","description":"회원상태 코드","enum":["NORMAL_MEMBER","STOP_MEMBER","WITHDRAWAL_MEMBER","WAIT_MEMBER","REJECT_MEMBER"]},"aempNm":{"type":"string","description":"담당자명"},"aempCellFullNo":{"type":"string","description":"담당자 휴대폰 전체 번호"},"aempCellSctNo":{"type":"string","description":"담당자 휴대전화구분번호"},"aempCellTxnoNo":{"type":"string","description":"담당자 휴대전화국번번호"},"aempCellEndNo":{"type":"string","description":"담당자 휴대전화끝번호"},"aempCiCtacVal":{"type":"string","description":"담당자 Ci 연계 값"},"aempYn":{"type":"string","description":"담당자 여부"},"joinSgtStatCd":{"type":"string","description":"가입 승인 여부","enum":["MALE","FEMALE"]}},"required":["bmanNm","bplcDtlAddr","bplcZipAddr","bplcZipNo","repTelEndNo","repTelFullNo","repTelSctNo","repTelTxnoNo"]},"MktRecvAgrRequest":{"type":"object","description":"마케팅 수신 동의 여부 DTO","properties":{"svcAgrTypCd":{"type":"string","description":"서비스 동의 유형 코드(ME025)","enum":["SMS","EMAIL","APP_PUSH","AUTO_LOGIN","KAKAO"]},"agrYn":{"type":"string","description":"서비스 동의 여부"}}},"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"}}}}}} ```` ## 회원 환불 계좌 정보 조회 > \## 기능설명\ > \* 회원이 등록한 환불 계좌 정보를 조회합니다.\ > \---\ > \## 상세설명\ > \* 회원이 환불 받기 위해 등록한 계좌 정보를 조회합니다.\ > \---\ > \## 특이사항\ > \* 전달하는 데이터 중 계좌번호는 마스킹 처리되어 출력됩니다.\ > \---\ > \## 수정번호\ > \* Release 2.00\_240401: 본인계좌가 없을 시, 에러 처리에서 빈 객체를 받는 것으로 수정
```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/member/mbrRfdActnInfo":{"get":{"tags":["회원관리"],"summary":"회원 환불 계좌 정보 조회","description":"## 기능설명\n* 회원이 등록한 환불 계좌 정보를 조회합니다.\n---\n## 상세설명\n* 회원이 환불 받기 위해 등록한 계좌 정보를 조회합니다.\n---\n## 특이사항\n* 전달하는 데이터 중 계좌번호는 마스킹 처리되어 출력됩니다.\n---\n## 수정번호\n* Release 2.00_240401: 본인계좌가 없을 시, 에러 처리에서 빈 객체를 받는 것으로 수정\n","operationId":"getMbrRfdActnInfo","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":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/RfdInfoResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"RfdInfoResponse":{"type":"object","description":"환불 계좌정보 조회 Response","properties":{"rfdBankCd":{"type":"string","description":"은행코드 (OM026)"},"rfdBankNm":{"type":"string","description":"은행명"},"rfdActnNo":{"type":"string","description":"환불계좌번호"},"rfdActnDepositorNm":{"type":"string","description":"환불 계좌 예금주명"},"rfdActnCertiYn":{"type":"string","description":"환불 계좌 인증여부"}}},"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"}}}}}} ``` ## 회원 환불 계좌 정보 저장 > \## 기능설명\ > \* 회원의 환불 계좌 정보를 등록합니다.\ > \---\ > \## 상세설명\ > \* 회원이 환불 받기 위해 계좌 정보를 등록합니다.\ > \---\ > \## 특이사항\ > \* 기존 계좌 정보가 존재한다면 새로 입력한 계좌 정보로 수정됩니다.
```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/member/mbrRfdActnInfo":{"post":{"tags":["회원관리"],"summary":"회원 환불 계좌 정보 저장","description":"## 기능설명\n* 회원의 환불 계좌 정보를 등록합니다.\n---\n## 상세설명\n* 회원이 환불 받기 위해 계좌 정보를 등록합니다.\n---\n## 특이사항\n* 기존 계좌 정보가 존재한다면 새로 입력한 계좌 정보로 수정됩니다.\n","operationId":"saveMbrRfdActnInfo","parameters":[{"name":"RefundRequest","in":"query","description":"등록/수정할 환불계좌 정보","required":true,"schema":{"type":"string","description":"RefundRequest"}},{"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/RefundRequest"}}},"required":true},"responses":{"200":{"description":"성공"},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"RefundRequest":{"type":"object","description":"회원환불계좌 등록 Request","properties":{"rfdBankCd":{"type":"string","description":"환불은행코드(OM026)"},"rfdActnNo":{"type":"string","description":"환불계좌번호"},"rfdActnDepositorNm":{"type":"string","description":"환불계좌 예금주명"},"rfdActnCertiYn":{"type":"string","description":"환불계좌 인증여부"}}},"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"}}}}}} ``` ## 회원 환불 계좌 정보 삭제 > \## 기능설명\ > \* 기존 등록된 환불 계좌정보를 삭제합니다.\ > \---\ > \## 상세설명\ > \* 회원이 기존 등록했던 환불 계좌 정보를 삭제합니다.
```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/member/mbrRfdActnInfo":{"delete":{"tags":["회원관리"],"summary":"회원 환불 계좌 정보 삭제","description":"## 기능설명\n* 기존 등록된 환불 계좌정보를 삭제합니다.\n---\n## 상세설명\n* 회원이 기존 등록했던 환불 계좌 정보를 삭제합니다.\n","operationId":"deleteMbrRfdActnInfo","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"}}}}}} ``` ## 소셜 계정 연동정보 조회 > \## 기능설명\ > \* 회원의 소셜 계정 연동정보를 조회합니다.\ > \---\ > \## 상세설명\ > \* 로그인은 필수입니다.\ > \* 토큰 정보에 대한 회원의 연동된 소셜 정보를 조회합니다.\ > \* 응답 목록에 소셜타입에 대한 연동여부가 Y이면 연동 중 상태, N이면 연동 해제상태를 나타냅니다.\ > \* 응답 목록에 소셜타입에 대한 데이터가 존재하지 않으면 연동된 이력이 없음을 나타냅니다.\ > \---\ > \## 수정번호\ > \* \`\`\`Release v2.00\_240401\`\`\`: Response dto 내 소셜로그인 첫 연동 여부, 간편계정 연동 구분코드명 추가\ > \* \`\`\`Release v2.00\_240509\`\`\`: 소셜 계정 연동정보 조회 시 간편계정연동구분코드(ME052) 사용여부 및 정렬순서 추가
````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/social/snsLinkInfo":{"get":{"tags":["회원관리"],"summary":"소셜 계정 연동정보 조회","description":"## 기능설명\n* 회원의 소셜 계정 연동정보를 조회합니다.\n---\n## 상세설명\n* 로그인은 필수입니다.\n* 토큰 정보에 대한 회원의 연동된 소셜 정보를 조회합니다.\n* 응답 목록에 소셜타입에 대한 연동여부가 Y이면 연동 중 상태, N이면 연동 해제상태를 나타냅니다.\n* 응답 목록에 소셜타입에 대한 데이터가 존재하지 않으면 연동된 이력이 없음을 나타냅니다.\n---\n## 수정번호\n* ```Release v2.00_240401```: Response dto 내 소셜로그인 첫 연동 여부, 간편계정 연동 구분코드명 추가\n* ```Release v2.00_240509```: 소셜 계정 연동정보 조회 시 간편계정연동구분코드(ME052) 사용여부 및 정렬순서 추가\n","operationId":"snsLinkInfo","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":"성공","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/SnsLinkInfoResponse"}}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"SnsLinkInfoResponse":{"type":"object","description":"소셜 연동 정보 Response","properties":{"smpctAcctLinkGbCd":{"type":"string","description":"간편계정연동구분코드(ME052)","enum":["KAKAOTALK","NAVER","GOOGLE","APPLE"]},"smpctAcctLinkGbCdNm":{"type":"string","description":"간편계정연동구분코드명(ME052)","enum":["KAKAOTALK","NAVER","GOOGLE","APPLE"]},"snsLinkYn":{"type":"string","description":"SNS연동여부"},"firstSnsLinkYn":{"type":"string","description":"SNS첫연동여부"}}},"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"}}}}}} ```` ## 회원 환불 계좌 정보 조회(노마스킹, 시스템 전용) > \## 기능설명\ > \* 회원이 등록한 환불 계좌 정보를 마스킹 정보 없이 조회합니다.\ > \---\ > \## 상세설명\ > \* 회원이 환불 받기 위해 등록한 계좌 정보를 조회합니다.\ > \---
```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/member/mbrRfdActnInfoNoMasking":{"get":{"tags":["회원관리"],"summary":"회원 환불 계좌 정보 조회(노마스킹, 시스템 전용)","description":"## 기능설명\n* 회원이 등록한 환불 계좌 정보를 마스킹 정보 없이 조회합니다.\n---\n## 상세설명\n* 회원이 환불 받기 위해 등록한 계좌 정보를 조회합니다.\n---\n","operationId":"getMbrRfdActnInfoNoMasking","parameters":[{"name":"mbrNo","in":"query","description":"회원번호","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","description":"Access Token","required":false}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/RfdInfoResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"RfdInfoResponse":{"type":"object","description":"환불 계좌정보 조회 Response","properties":{"rfdBankCd":{"type":"string","description":"은행코드 (OM026)"},"rfdBankNm":{"type":"string","description":"은행명"},"rfdActnNo":{"type":"string","description":"환불계좌번호"},"rfdActnDepositorNm":{"type":"string","description":"환불 계좌 예금주명"},"rfdActnCertiYn":{"type":"string","description":"환불 계좌 인증여부"}}},"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"}}}}}} ``` --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://tech.x2bee.com/api/store-front-api/member-api/undefined-1.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.