마이페이지 화면_회원정보
이해하기
쇼핑몰 회원의 정보를 확인, 수정, 관리할 수 있는 메뉴로 아래의 3가지 메뉴를 제공하고 있습니다.

회원 인증
회원 정보 수정 및 회원 탈퇴의 경우, 회원 인증과정을 거친 후 상세 화면 접근이 가능합니다.
회원 정보 수정 / 회원 탈퇴 시, 회원 본인임을 확인하기 위한 인증 과정입니다.
회원 인증 방식은 '일반회원', '간편 로그인 회원'에 따라 인증 방식 및 제공 API가 다르므로 아래의 프로세스로 처리됩니다.

- get회원 정보 조회
- /profile
회원의 정보를 조회합니다.
위의 API를 통해 회원 정보를 가져와서 일반 회원/간편로그인 회원 여부를 판단한 뒤, 회원 구분에 따라 인증을 처리 합니다.
- 일반 회원 인증
- 회원 비밀번호 입력을 통한 인증 - 간편 로그인 회원 인증
- 간편 로그인 연동 로직 수행

- post비밀번호 확인
- /profile/check-password
회원의 비밀번호를 확인합니다.
비밀번호 입력 후 비밀번호 확인하기 API를 호출하여 인증을 진행합니다.
비밀번호가 맞는 경우 회원 정보 수정 페이지 및 회원 탈퇴 페이지로 진입하며,
비밀번호가 틀린 경우는 회원 정보 수정 페이지 및 회원 탈퇴 페이지로 접근이 불가합니다.
회원 정보 변경 및 회원 탈퇴를 위한 비밀번호 본인인증 시, 비밀번호 10회 오류 발생 시 캡챠 입력을 통해 회원정보를 인증해야 합니다.
캡챠 이미지 조회 및 캡챠 인증코드 확인은 로그인화면에서 자세한 내용을 확인할 수 있습니다.
간편 로그인 회원 인증은 회원 가입 시 진행한 간편 로그인 인증과정과 동일하게 처리 됩니다.

간편 로그인 회원의 경우 '회원 탈퇴'만 쇼핑몰에서 처리 가능하며, '회원 정보 수정'을 지원하지 않습니다.
간편 로그인 로직은 간편 로그인 화면에서 자세히 확인이 가능합니다.
🅐 회원 정보 수정
간편 로그인 회원이 아닌 일반 회원에게만 회원 정보 수정 페이지가 제공되며, 비밀번호 인증 이후 접근 가능합니다.
회원 정보 수정 페이지는 회원 가입 시 회원 정보 입력 화면과 동일하게 제공되며, 회원 정보에 등록된 값을 그대로 노출합니다.
또한, 회원 가입과는 다르게 쇼핑몰 회원 가입 시에 동의 받는 약관에 대해 관리할 수 있도록 회원 정보 수정 페이지 하단에 약관과 동의 항목을 제공합니다.

- post회원정보 조회
- /profile/non-masking
비밀번호 인증으로 마스킹이 해제된 회원 정보를 조회합니다.
비밀번호 인증을 통해 회원 정보 수정 페이지 접근 시 해당하는 회원의 정보를 조회 하여 회원 수정 페이지에 출력합니다.
기본 스킨에서는 아이디의 경우 수정이 불가하도록 회원의 정보를 그대로 불러오며, 수정이 가능한 항목에 대해서는 input 내 DB저장값이 노출되도록 제공하고 있습니다.
쇼핑몰에서 본인인증을 제공하는 경우, 회원 정보 수정 페이지에서도 본인인증을 통해 개인정보를 수정할 수 있습니다.
- 이름
- 성별
- 생년월일
- CI (인증 완료 시 전송되는 본인인증 고유 값)

기본 스킨에서는 이름 입력 항목 옆 '재인증' 또는 '휴대폰 본인인증' 버튼을 통해 본인인증 기능을 제공하고 있습니다.
쇼핑몰에서 휴대폰 본인인증을 제공하는 경우 회원정보 수정 시 본인인증은 필수로 진행되어야 합니다.
(본인인증 여부가 'y'여야 회원 정보 수정이 가능합니다.)
* 본인인증 여부가 y인 경우 휴대폰 '재인증' 버튼을 제공하며, 클릭 시 KCP 본인인증 팝업을 출력 하여 본인인증 로직을 진행합니다.
* 본인인증 여부가 n이거나 SMS 혹은 이메일 인증을 진행한 회원에게는 '휴대폰 본인인증' 버튼을 제공하여 본인인증 로직을 시행합니다.
- post본인인증 후 개인정보 갱신
- /profile/rename
본인인증 후 개인정보를 갱신합니다.
본인인증 이후 정보수정 버튼을 통해 저장 처리를 해야만 본인인증여부 및 수정된 회원 정보가 DB에 반영됩니다.

이메일 인증을 통해 가입한 회원의 경우 (인증여부 = y 이면서 인증수단이 이메일 인증인 회원 ) 이메일 주소 수정은 이메일 재인증을 통해 수정이 가능합니다.
이메일 입력 항목 내 [재인증] 버튼을 클릭 시 변경하려는 이메일 주소를 입력할 수 있으며,
입력한 변경 이메일 주소로 이메일 인증번호 발송하여 인증 후 정보수정 버튼을 통해 변경된 사항을 저장해야 합니다.
쇼핑몰에서 이메일 인증이 사용함인 경우 회원정보 수정 시 이메일 인증은 필수로 진행되어야 합니다.
(이메일 여부가 'y'여야 회원 정보 수정이 가능합니다.)
* 이메일 인증 여부가 y인 경우 '재인증' 버튼을 제공하며, 클릭 시 이메일 인증 로직을 진행합니다.
* 이메일 인증 여부가 n이거나 휴대폰 본인 인증 혹은 SMS 인증을 진행한 회원에게는 '이메일 인증' 버튼을 제공하여 이메일 인증 로직을 시행합니다.
- post이메일로 인증번호 발송
- /authentications/email
이메일로 인증번호를 발송합니다.
발송된 인증번호 확인은 아래의 API 를 참고하여 주세요.
- get이메일로 전달받은 인증번호 확인
- /authentications/email
이메일로 전달받은 인증번호를 확인합니다.
이메일 인증도 마찬가지로 인증 이후 정보수정 버튼을 통해 저장 처리를 해야만 인증여부 및 수정된 회원 정보가 DB에 반영됩니다.

sms 인증을 통해 가입한 회원의 경우 (인증여부 = y 이면서 인증수단이 sms 인증인 회원) 휴대폰번호 수정은 재인증을 통해 수정이 가능합니다.
휴대폰번호 입력 항목 내 [재인증] 버튼을 클릭 시 변경하려는 휴대폰번호를 입력할 수 있으며,
입력한 변경 번호로 인증번호 문자 발송하여 인증 후 정보수정 버튼을 통해 변경된 사항을 저장해야 합니다.
쇼핑몰에서 SMS 인증이 사용함인 경우 회원정보 수정 시 SMS 인증은 필수로 진행되어야 합니다.
(SMS 인증 여부가 'y'여야 회원 정보 수정이 가능합니다.)
* SMS 인증 여부가 y인 경우 '재인증' 버튼을 제공하며, 클릭 시 SMS 인증 로직을 진행합니다.
* SMS 인증 여부가 n이거나 휴대폰 본인 인증 혹은 이메일 인증을 진행한 회원에게는 'SMS 인증' 버튼을 제공하여 SMS 인증 로직을 시행합니다.
- post휴대폰 점유인증 인증코드 SMS 발송
- /authentications/sms
휴대폰 문자메시지로 인증번호(6자리)를 발송합니다.
발송된 인증번호 확인은 아래의 API 를 참고하여 주세요.
- getSMS로 전달받은 인증코드 확인
- /authentications/sms
휴대폰 문자메시지로 수신한 인증번호를 확인합니다.
SMS 인증 이후 정보수정 버튼을 통해 저장 처리를 해야만 인증여부 및 수정된 회원 정보가 DB에 반영됩니다.
기본 스킨에서는 이메일 SMS 수신 동의 여부에 대해 안내 하고 있습니다. 동의 여부에 대해서는 POST /profile/non-masking 의 응답 값을 통해 확인 가능합니다.


- get약관 조회
- /terms
해당 쇼핑몰의 약관을 조회합니다.

- put회원정보 수정
- /profile
회원 정보를 수정합니다.
회원 정보 수정 페이지에서 항목을 입력 하고 저장 처리 시 회원 정보 수정하기 API 를 호출하여 수정한 내용을 회원 DB에 반영합니다.
수정 처리 시 응답 되는 값에 따라 ALERT 혹은 회원 정보 수정 완료를 진행합니다.
🅑 회원 탈퇴
일반 회원, 간편 로그인 회원 모두에게 제공되는 페이지이며 회원 인증후 회원 탈퇴 페이지에 접근이 가능합니다.
기본 스킨에서는 탈퇴 페이지 내 탈퇴 사유 입력과 탈퇴 동의 체크박스를 제공합니다.

회원 탈퇴 페이지 내 회원 탈퇴에 대한 약관을 명시 하고자 하는 경우 아래의 API를 통해 약관 정보를 조회할 수 있습니다.
- get약관 조회
- /terms
해당 쇼핑몰의 약관을 조회합니다.
탈퇴 안내에 대한 약관을 확인하기 위해서는 termsTypes=WITHDRAWAL_GUIDE로 요청하시면 탈퇴 안내 약관을 응답 받을 수 있습니다.
탈퇴 사유와 탈퇴 안내에 대해 동의 시 탈퇴가 가능하며, 탈퇴 처리는 아래 API를 호출하시면 됩니다.
- delete회원 탈퇴
- /profile
회원 탈퇴 처리합니다.
🅒 배송지 관리
회원 기준으로 배송지를 관리할 수 있는 페이지 입니다.
배송지를 등록하거나 수정, 삭제 할 수 있으며, 배송지는 개수 제한 없이 등록 가능합니다.
배송지 등록 혹은 수정 시에 기본배송지를 설정할 수 있으며 기본배송지는 1개만 설정 가능합니다.
기본배송지로 등록된 배송지는 주문 페이지 내 배송지데이터로 출력됩니다.

등록된 배송지 목록 조회는 아래의 API를 통해 확인 가능합니다.
- get배송지 목록 조회
- /profile/shipping-addresses
배송지 관리에 등록된 배송지 목록을 조회합니다.
기본배송지가 가장 상단에 노출되며, 기본배송지는 삭제가 불가능합니다.
기본배송지로 설정된 주소 삭제를 원하는 경우 기본배송지 설정을 해제하고 삭제해야 합니다.
배송지 목록 가져오기를 통해 응답된 값 중 저장된 배송지값을 배송지 관리 목록에 출력할 수 있습니다.
- post배송지 등록
- /profile/shipping-addresses
배송지 관리에 배송지를 등록합니다.
배송지 목록에 배송지를 추가 하는 기능을 제공할 수 있습니다.
추가 시 defaultYn=Y 로 호출 하는 경우 기본 배송지로 설정됩니다.
기존에 기본배송지가 설정되어 있는 경우 다른 배송지를 기본배송지로 설정하는 경우 기본 배송지가 변경됩니다.
개인고유통관부호 입력이 필요한 주소의 경우 request body 값으로 customsIdNumber 값을 추가하여 배송지 등록이 가능합니다.

배송지 추가 버튼을 통해 출력한 나의 배송지 관리 팝업 내 주소찾기 버튼 클릭 시 우편번호 찾기를 통한 주소 검색 기능을 제공합니다.
- get주소 조회
- /addresses/search
키워드 검색을 통한 주소정보를 검색합니다.
등록한 배송지를 수정하고자 하는 경우 아래의 API를 통해 수정 가능합니다.
배송지 수정 하기를 위해서는 선택한 배송지 정보를 먼저 조회 후 나의 배송지 관리 팝업에서 등록된 정보로 배송지를 먼처 출력하여 제공합니다.
- get배송지 조회
- /profile/shipping-addresses/{addressNo}
선택한 배송지 정보를 조회합니다.
등록된 정보를 기준으로 구매자가 수정을 완료 한 경우 아래 API 를 통해 배송지 정보를 수정합니다.
- put배송지 수정
- /profile/shipping-addresses/{addressNo}
선택한 배송지 정보를 수정합니다.
해당 API는 나의 배송지 관리 팝업 내 저장 버튼 클릭 시 호출하여 입력 값을 저장합니다.
배송지 관리 목록 내 [삭제] 버튼 클릭 시 선택한 배송지를 삭제 처리 합니다.
- delete배송지 삭제
- /profile/shipping-addresses/{addressNo}
선택한 배송지 정보를 삭제합니다.
기본배송지로 설정된 배송지는 삭제할 수 없습니다.
기본배송지 삭제 시도 시 응답 되는 에러 메시지를 참고 하여 안내해주시면 됩니다.