구매자 관리
가입한 구매자 조회, 구매 통계, 탈퇴 처리
가입한 구매자의 정보·구매 통계·동의 이력을 보고 탈퇴를 대신 처리합니다. 가입·로그인은 구매자 인증에 있습니다.
권한
조회는 소유자·관리자·스태프(customer:r), 탈퇴 처리는 상점 플랫폼으로 로그인한 소유자·관리자(customer:rw)입니다.
목록
상점 플랫폼에서 상점 관리 › 고객 › 구매자로 이동합니다(소유자·관리자·스태프).
이름·이메일·휴대폰 뒤 4자리로 검색하고 가입일·마케팅 수신으로 거릅니다. 휴대폰은 가운데를 가립니다. API: GET /v1/customers
상세
목록에서 구매자를 선택하면 상세가 열립니다. 상세는 기본 정보(휴대폰 전체·로그인 방법·마케팅·적립금), 배송지, 구매 통계, 주문, 동의 이력입니다. 구매 금액은 취소와 완료된 반품(수량 비율)을 뺀 금액입니다.
API: GET /v1/customers/{customerId}, GET /v1/customers/{customerId}/orders
동의 이력
상세의 동의 카드에서 현재 상태와 이력을 봅니다. 이력은 탈퇴할 때만 지워집니다.
| 열 | 값 |
|---|---|
| 항목 | 이용약관 · 개인정보 수집이용 · 마케팅 수신 |
| 처리 | 동의 · 철회 |
| 버전 · 약관 | 동의 시점의 버전과 주소(마케팅 없음) |
| 경로 | 가입 · 소셜 가입 · 회원 연동 · 재동의 · 구매자 변경 · 셀러 처리 |
재동의 필요는 현재 약관 버전과 다른 버전에 동의한 상태입니다. 동의가 함께 오지 않은 소셜 가입자도 이렇게 보입니다.
약관을 개정하면 상점 플랫폼에서 설정 › 상점 정보로 이동합니다(소유자만).
- 약관 카드에서 이용약관 버전·개인정보 수집이용 버전(
2026-09-26같은 문자열)을 올립니다. - 저장합니다. 이전 버전 동의자에게 재동의 안내가 뜹니다.
약관 주소(https)를 적으면 동의 시점 주소가 이력에 남습니다.
API: GET /v1/customers/{customerId}/consents(kind 필터), 변경은 PATCH /v1/store의 termsVersion·privacyVersion·termsUrl·privacyUrl
탈퇴 처리
셀러가 대신 탈퇴 처리합니다.
탈퇴 처리는 되돌릴 수 없습니다.
- 목록에서 구매자를 선택합니다.
- 상세 화면의 **[탈퇴 처리]**를 누릅니다.
- 처리 사유를 고릅니다.
- 확인용으로 구매자 이메일을 입력합니다. 이메일 없는 소셜 구매자는 구매자 이름입니다.
- 회원 정보·배송지·위시리스트·장바구니·동의 이력·적립금이 지워집니다. 주문·클레임·리뷰·문의 기록은 남습니다.
- 진행 중인 주문 상품·클레임·결제가 있으면
409 WITHDRAWAL_BLOCKED입니다(error.details에 항목별 건수).
API: POST /v1/customers/{customerId}/withdraw