회원관리

개인정보 수정

put

기능설명

회원 개인정보를 변경합니다.

상세설명

기존 입력했던 개인정보에서 변경된 정보가 존재할 경우, 개인정보 변경을 통해 회원의 정보를 업데이트합니다.
개인정보 변경이 가능한 정보
- 휴대폰번호
- 생년월일
- 주소 및 기본배송지 주소
- 이메일
- 마케팅이용정보 동의(이메일, SMS)

특이사항

baseDlvpYn 필드의 경우 필수 값입니다.
개인정보 일부 변경 시 변경되는 정보만 전달되어야 하며, 변경되지 않는 정보는 공란으로 전달되어야합니다.
정상 수정 후 이벤트DB에 수정된 배송지순번 및 배송지 정보를 동기화 처리합니다.

Query parameters

memberInfoUpdateRequeststringRequired

MemberInfoUpdateRequest

userDetailstringRequired

UserDetail

Header parameters

AuthorizationanyOptional

Access Token

Body

개인정보 수정 Reqeust

mbrNostringOptional

회원번호

Example: 10000001

mbrNmstringOptional

회원명

Example: 임성현

mbrMgrCdstring · enumOptional

회원관리코드(ME002)

Example: 20Possible values:

ciCtacValstringOptional

Ci 연계 값

Example: xksiajw77s221aZXSa

cellPhoneFullNostringOptional

휴대폰 전체 번호

Example: 01012344321

cellPhoneFirNostringOptional

휴대폰 첫째 번호

Example: 010

cellPhoneSecNostringOptional

휴대폰 둘째 번호

Example: 1234

cellPhoneThirNostringOptional

휴대폰 셋째 번호

Example: 4321

zipNostringOptional

우편번호

Example: 04123

addressstringOptional

주소

Example: 문정동 H비즈니스 파크 D동

dtlAddressstringOptional

상세 주소

Example: 6층

dlvpNmstringOptional

배송지명

Example: 라운지

baseDlvpYnstringOptional

기본배송지여부

Example: Y

brthstringOptional

생년월일

Example: 19980704

sexGbCdstring · enumOptional

성별구분코드 (ME017) (글로벌 계정 전용)

Example: MPossible values:

emailAddrstringOptional

이메일주소

Example: x2bee@plateer.com

bmanNmstringRequired

사업장명

Example: 비지니스파크

repTelFullNostringRequired

대표 전화

Example: 02-1234-1234

repTelSctNostringRequired

대표 전화 국번

Example: 02

repTelTxnoNostringRequired

대표 전화 중간번호

Example: 1234

repTelEndNostringRequired

대표 전화 끝번호

Example: 5678

bplcZipNostringRequired

사업장 우편번호

Example: 12345

bplcZipAddrstringRequired

사업장 주소

Example: 서울시 강남구 테헤란로 123

bplcDtlAddrstringRequired

사업장 상세주소

Example: 비지니스파크 D동 6층

mbrStatCdstring · enumOptional

회원상태 코드

Example: 10Possible values:

aempNmstringOptional

담당자명

Example: 이상훈

aempCellFullNostringOptional

담당자 휴대폰 전체 번호

Example: 01012344321

aempCellSctNostringOptional

담당자 휴대전화구분번호

Example: 010

aempCellTxnoNostringOptional

담당자 휴대전화국번번호

Example: 1234

aempCellEndNostringOptional

담당자 휴대전화끝번호

Example: 4321

aempCiCtacValstringOptional

담당자 Ci 연계 값

Example: xksiajw77s221aZXSa

aempYnstringOptional

담당자 여부

Example: Y

joinSgtStatCdstring · enumOptional

가입 승인 여부

Example: MPossible values:

Responses

200

성공

No content

900

업무처리 오류 내용

*/*

put/v1/member/modifyMemberInfo

PUT /api/member/v1/member/modifyMemberInfo?memberInfoUpdateRequest=text&userDetail=text HTTP/1.1
Host: api-member.x2bee.com/
Content-Type: application/json
Accept: */*
Content-Length: 855

{
  "mbrNo": 10000001,
  "mbrNm": "임성현",
  "mbrMgrCd": 20,
  "ciCtacVal": "xksiajw77s221aZXSa",
  "cellPhoneFullNo": "01012344321",
  "cellPhoneFirNo": "010",
  "cellPhoneSecNo": 1234,
  "cellPhoneThirNo": 4321,
  "zipNo": "04123",
  "address": "문정동 H비즈니스 파크 D동",
  "dtlAddress": "6층",
  "mktRecvAgrList": [
    {
      "svcAgrTypCd": 10,
      "agrYn": "Y"
    }
  ],
  "dlvpNm": "라운지",
  "baseDlvpYn": "Y",
  "brth": 19980704,
  "sexGbCd": "M",
  "emailAddr": "x2bee@plateer.com",
  "bmanNm": "비지니스파크",
  "repTelFullNo": "02-1234-1234",
  "repTelSctNo": "02",
  "repTelTxnoNo": 1234,
  "repTelEndNo": 5678,
  "bplcZipNo": 12345,
  "bplcZipAddr": "서울시 강남구 테헤란로 123",
  "bplcDtlAddr": "비지니스파크 D동 6층",
  "mbrStatCd": 10,
  "aempNm": "이상훈",
  "aempCellFullNo": "01012344321",
  "aempCellSctNo": "010",
  "aempCellTxnoNo": 1234,
  "aempCellEndNo": 4321,
  "aempCiCtacVal": "xksiajw77s221aZXSa",
  "aempYn": "Y",
  "joinSgtStatCd": "M"
}

No content

post

기능설명

로그인된 회원에 대한 소셜계정을 연동 처리합니다.

상세설명

로그인은 및 **소셜 타입(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: 구글, 애플인 경우 기 연동 여부 체크하여 중복 연동 불가하도록 수정

Query parameters

socialAuthRequeststringRequired

SocialAuthRequest

Header parameters

AuthorizationanyOptional

Access Token

Body

소셜로그인 인증, 소셜로그인 연동 Request

codestringRequired

소셜 사이트 인증 성공 시 넘겨주는 인증코드

statestringOptional

소셜 사이트 인증 시 애플리케이션 상태

typestring · enumRequired

소셜 타입(ME052)

Example: 10Possible values:

Responses

200

성공

No content

900

업무처리 오류 내용

*/*

post/v1/social/snsLinkConnect

POST /api/member/v1/social/snsLinkConnect?socialAuthRequest=text HTTP/1.1
Host: api-member.x2bee.com/
Content-Type: application/json
Accept: */*
Content-Length: 40

{
  "code": "text",
  "state": "text",
  "type": 10
}

No content

post

기능설명

액세스 토큰에 대한 회원의 연동소셜계정을 해제합니다.

상세설명

로그인은 필수입니다.
**소셜 타입(type)**과 **회원 번호(mbrNo)**는 필수입니다.
소셜회원일 시 가입했던 소셜타입으로는 해제가 불가능합니다. ex) 네이버 소셜 회원일 시 네이버 연동해제 불가능
소셜계정에 대한 연동정보를 해제처리합니다.

Query parameters

socialConnectRequeststringRequired

SocialConnectRequest

Header parameters

AuthorizationanyOptional

Access Token

Body

소셜로그인 연동, 연동해제 Request

typestring · enumRequired

소셜 타입(ME052)

Example: 10Possible values:

mbrNostringRequired

회원번호

Example: 100001641

smpctIdstringRequired

소셜고유ID

emailAddrstringOptional

소셜ID

loginMediaCdstring · enumRequired

로그인매체코드(ME026)

Example: 10Possible values:

siteNostringOptional

사이트번호

Responses

200

성공

*/*

소셜로그인 인증 성공 후 사용자 조회 응답값

brthstringOptional

생년월일

Example: 19940101

mbrNmstringOptional

회원명

Example: 홍길동

emailAddrstringOptional

이메일

sexGbCdstring · enumOptional

성별구분코드

Example: MPossible values:

mbrMgrCdstring · enumOptional

회원관리코드

Example: 10Possible values:

ciCtacValstringOptional

CI연계값

smpctGbCdstring · enumOptional

소셜구분코드

Example: 10Possible values:

nafrGbCdstringOptional

내외국인구분코드

phoneNumberstringOptional

휴대폰번호

mbrNostringOptional

회원번호

Example: 100001641

connectYnstring · enumOptional

기연동여부

Example: NPossible values:

smpctIdstringOptional

소셜고유ID

loginIdstringOptional

로그인ID

900

업무처리 오류 내용

*/*

post/v1/social/snsLinkCancel

POST /api/member/v1/social/snsLinkCancel?socialConnectRequest=text HTTP/1.1
Host: api-member.x2bee.com/
Content-Type: application/json
Accept: */*
Content-Length: 99

{
  "type": 10,
  "mbrNo": 100001641,
  "smpctId": "text",
  "emailAddr": "text",
  "loginMediaCd": 10,
  "siteNo": "text"
}

{
  "brth": 19940101,
  "mbrNm": "홍길동",
  "emailAddr": "text",
  "sexGbCd": "M",
  "mbrMgrCd": 10,
  "ciCtacVal": "text",
  "smpctGbCd": 10,
  "nafrGbCd": "text",
  "phoneNumber": "text",
  "mbrNo": 100001641,
  "connectYn": "N",
  "smpctId": "text",
  "loginId": "text"
}

회원 즐겨찾기 수정

post

기능설명

회원의 메뉴 즐겨찾기 정보를 수정합니다.

상세설명

로그인은 필수입니다.
요청 type이 10이면 등록 20이면 삭제를 진행합니다.
메뉴 등록은 최대 8개까지 가능합니다.

Header parameters

AuthorizationanyOptional

Access Token

Body

typestringRequired

요청 유형 (10: 등록, 20: 삭제)

Example: 10

bkmkMenuIdstringRequired

즐겨찾기메뉴ID

Example: 22000027

sortSeqstringOptional

정렬순서

Example: 1

vaildTypebooleanOptional

Responses

200

성공

No content

900

업무처리 오류 내용

*/*

post/v1/myPage/bkmkMenu

POST /api/member/v1/myPage/bkmkMenu HTTP/1.1
Host: api-member.x2bee.com/
Content-Type: application/json
Accept: */*
Content-Length: 62

{
  "type": 10,
  "bkmkMenuId": 22000027,
  "sortSeq": 1,
  "vaildType": true
}

No content

사업자 회원 승인 대기 정보 수정

post

기능설명

사업자 회원의 승인대기 정보를 수정합니다.

상세설명

기존 입력했던 개인정보에서 변경된 정보가 존재할 경우, 개인정보 변경을 통해 회원의 정보를 업데이트합니다.

수정번호

Release v2.01_250808: 비밀번호 변경 제거

Query parameters

memberInfoUpdateRequeststringRequired

MemberInfoUpdateRequest

userDetailstringRequired

UserDetail

Header parameters

AuthorizationanyOptional

Access Token

Body

bmanRegFilestring · binaryOptional

Responses

200

성공

No content

900

업무처리 오류 내용

*/*

post/v1/member/modifyEnterpriseMemberInfo

POST /api/member/v1/member/modifyEnterpriseMemberInfo?memberInfoUpdateRequest=text&userDetail=text HTTP/1.1
Host: api-member.x2bee.com/
Content-Type: application/json
Accept: */*
Content-Length: 906

{
  "memberInfoUpdateRequest": {
    "mbrNo": 10000001,
    "mbrNm": "임성현",
    "mbrMgrCd": 20,
    "ciCtacVal": "xksiajw77s221aZXSa",
    "cellPhoneFullNo": "01012344321",
    "cellPhoneFirNo": "010",
    "cellPhoneSecNo": 1234,
    "cellPhoneThirNo": 4321,
    "zipNo": "04123",
    "address": "문정동 H비즈니스 파크 D동",
    "dtlAddress": "6층",
    "mktRecvAgrList": [
      {
        "svcAgrTypCd": 10,
        "agrYn": "Y"
      }
    ],
    "dlvpNm": "라운지",
    "baseDlvpYn": "Y",
    "brth": 19980704,
    "sexGbCd": "M",
    "emailAddr": "x2bee@plateer.com",
    "bmanNm": "비지니스파크",
    "repTelFullNo": "02-1234-1234",
    "repTelSctNo": "02",
    "repTelTxnoNo": 1234,
    "repTelEndNo": 5678,
    "bplcZipNo": 12345,
    "bplcZipAddr": "서울시 강남구 테헤란로 123",
    "bplcDtlAddr": "비지니스파크 D동 6층",
    "mbrStatCd": 10,
    "aempNm": "이상훈",
    "aempCellFullNo": "01012344321",
    "aempCellSctNo": "010",
    "aempCellTxnoNo": 1234,
    "aempCellEndNo": 4321,
    "aempCiCtacVal": "xksiajw77s221aZXSa",
    "aempYn": "Y",
    "joinSgtStatCd": "M"
  },
  "bmanRegFile": "binary"
}

No content

회원 환불 계좌 정보 조회

get

기능설명

회원이 등록한 환불 계좌 정보를 조회합니다.

상세설명

회원이 환불 받기 위해 등록한 계좌 정보를 조회합니다.

특이사항

전달하는 데이터 중 계좌번호는 마스킹 처리되어 출력됩니다.

수정번호

Release 2.00_240401: 본인계좌가 없을 시, 에러 처리에서 빈 객체를 받는 것으로 수정

Query parameters

userDetailstringRequired

UserDetail

Header parameters

AuthorizationanyOptional

Access Token

Responses

200

성공

*/*

환불 계좌정보 조회 Response

rfdBankCdstringOptional

은행코드 (OM026)

Example: 203

rfdBankNmstringOptional

은행명

Example: KB국민은행

rfdActnNostringOptional

환불계좌번호

Example: 33330********

rfdActnDepositorNmstringOptional

환불 계좌 예금주명

Example: 임성현

rfdActnCertiYnstringOptional

환불 계좌 인증여부

Example: Y

900

업무처리 오류 내용

*/*

get/v1/member/mbrRfdActnInfo

GET /api/member/v1/member/mbrRfdActnInfo?userDetail=text HTTP/1.1
Host: api-member.x2bee.com/
Accept: */*

{
  "rfdBankCd": 203,
  "rfdBankNm": "KB국민은행",
  "rfdActnNo": "33330********",
  "rfdActnDepositorNm": "임성현",
  "rfdActnCertiYn": "Y"
}

회원 환불 계좌 정보 저장

post

기능설명

회원의 환불 계좌 정보를 등록합니다.

상세설명

회원이 환불 받기 위해 계좌 정보를 등록합니다.

특이사항

기존 계좌 정보가 존재한다면 새로 입력한 계좌 정보로 수정됩니다.

Query parameters

RefundRequeststringRequired

RefundRequest

userDetailstringRequired

UserDetail

Header parameters

AuthorizationanyOptional

Access Token

Body

회원환불계좌 등록 Request

rfdBankCdstringOptional

환불은행코드(OM026)

Example: 203

rfdActnNostringOptional

환불계좌번호

Example: 1254084747123

rfdActnDepositorNmstringOptional

환불계좌 예금주명

Example: 홍길동

rfdActnCertiYnstringOptional

환불계좌 인증여부

Example: Y

Responses

200

성공

No content

900

업무처리 오류 내용

*/*

post/v1/member/mbrRfdActnInfo

POST /api/member/v1/member/mbrRfdActnInfo?RefundRequest=text&userDetail=text HTTP/1.1
Host: api-member.x2bee.com/
Content-Type: application/json
Accept: */*
Content-Length: 97

{
  "rfdBankCd": 203,
  "rfdActnNo": 1254084747123,
  "rfdActnDepositorNm": "홍길동",
  "rfdActnCertiYn": "Y"
}

No content

회원 환불 계좌 정보 삭제

delete

기능설명

기존 등록된 환불 계좌정보를 삭제합니다.

상세설명

회원이 기존 등록했던 환불 계좌 정보를 삭제합니다.

Query parameters

userDetailstringRequired

UserDetail

Header parameters

AuthorizationanyOptional

Access Token

Responses

200

성공

No content

900

업무처리 오류 내용

*/*

delete/v1/member/mbrRfdActnInfo

DELETE /api/member/v1/member/mbrRfdActnInfo?userDetail=text HTTP/1.1
Host: api-member.x2bee.com/
Accept: */*

No content

get

기능설명

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

상세설명

로그인은 필수입니다.
토큰 정보에 대한 회원의 연동된 소셜 정보를 조회합니다.
응답 목록에 소셜타입에 대한 연동여부가 Y이면 연동 중 상태, N이면 연동 해제상태를 나타냅니다.
응답 목록에 소셜타입에 대한 데이터가 존재하지 않으면 연동된 이력이 없음을 나타냅니다.

수정번호

Release v2.00_240401: Response dto 내 소셜로그인 첫 연동 여부, 간편계정 연동 구분코드명 추가
Release v2.00_240509: 소셜 계정 연동정보 조회 시 간편계정연동구분코드(ME052) 사용여부 및 정렬순서 추가

Query parameters

userDetailstringRequired

UserDetail

Header parameters

AuthorizationanyOptional

Access Token

Responses

200

성공

*/*

소셜 연동 정보 Response

smpctAcctLinkGbCdstring · enumOptional

간편계정연동구분코드(ME052)

Example: 10Possible values:

smpctAcctLinkGbCdNmstring · enumOptional

간편계정연동구분코드명(ME052)

Example: 카카오Possible values:

snsLinkYnstringOptional

SNS연동여부

Example: Y

firstSnsLinkYnstringOptional

SNS첫연동여부

Example: Y

900

업무처리 오류 내용

*/*

get/v1/social/snsLinkInfo

GET /api/member/v1/social/snsLinkInfo?userDetail=text HTTP/1.1
Host: api-member.x2bee.com/
Accept: */*

[
  {
    "smpctAcctLinkGbCd": 10,
    "smpctAcctLinkGbCdNm": "카카오",
    "snsLinkYn": "Y",
    "firstSnsLinkYn": "Y"
  }
]

회원 환불 계좌 정보 조회(노마스킹, 시스템 전용)

get

기능설명

회원이 등록한 환불 계좌 정보를 마스킹 정보 없이 조회합니다.

상세설명

회원이 환불 받기 위해 등록한 계좌 정보를 조회합니다.

Query parameters

mbrNostringRequired

회원번호

Header parameters

AuthorizationanyOptional

Access Token

Responses

200

성공

*/*

환불 계좌정보 조회 Response

rfdBankCdstringOptional

은행코드 (OM026)

Example: 203

rfdBankNmstringOptional

은행명

Example: KB국민은행

rfdActnNostringOptional

환불계좌번호

Example: 33330********

rfdActnDepositorNmstringOptional

환불 계좌 예금주명

Example: 임성현

rfdActnCertiYnstringOptional

환불 계좌 인증여부

Example: Y

900

업무처리 오류 내용

*/*

get/v1/member/mbrRfdActnInfoNoMasking

GET /api/member/v1/member/mbrRfdActnInfoNoMasking?mbrNo=text HTTP/1.1
Host: api-member.x2bee.com/
Accept: */*

{
  "rfdBankCd": 203,
  "rfdBankNm": "KB국민은행",
  "rfdActnNo": "33330********",
  "rfdActnDepositorNm": "임성현",
  "rfdActnCertiYn": "Y"
}

이전알림함

다음회원공통

마지막 업데이트 7개월 전

개인정보 수정

기능설명

상세설명

특이사항

소셜 계정 연동 처리

기능설명

상세설명

수정번호

소셜 계정 연동 해제

기능설명

상세설명

회원 즐겨찾기 수정

기능설명

상세설명

사업자 회원 승인 대기 정보 수정

기능설명

상세설명

수정번호

회원 환불 계좌 정보 조회

기능설명

상세설명

특이사항

수정번호

회원 환불 계좌 정보 저장

기능설명

상세설명

특이사항

회원 환불 계좌 정보 삭제

기능설명

상세설명

소셜 계정 연동정보 조회

기능설명

상세설명

수정번호

회원 환불 계좌 정보 조회(노마스킹, 시스템 전용)

기능설명

상세설명