sayren Docs
구매자

구매자 탈퇴 처리

구매자 계정·배송지·위시리스트·장바구니·적립금을 지우고 발급된 토큰을 모두 무효로 만든다. 되돌릴 수 없다. 주문·클레임·리뷰·문의 기록은 스토어에 남는다. 결제 대기부터 배송 중인 주문, 처리 중인 클레임, 진행 중인 결제가 있으면 409 `WITHDRAWAL_BLOCKED`(`error.details`에 항목 수)다. 콘솔에 로그인한 OWNER·ADMIN만 호출할 수 있다.

POST
/v1/customers/{customerId}/withdraw

구매자 계정·배송지·위시리스트·장바구니·적립금을 지우고 발급된 토큰을 모두 무효로 만든다. 되돌릴 수 없다. 주문·클레임·리뷰·문의 기록은 스토어에 남는다. 결제 대기부터 배송 중인 주문, 처리 중인 클레임, 진행 중인 결제가 있으면 409 WITHDRAWAL_BLOCKED(error.details에 항목 수)다. 콘솔에 로그인한 OWNER·ADMIN만 호출할 수 있다.

AuthorizationBearer <token>

userToken(계정 스코프) 또는 storeToken(스토어 스코프)

In: header

Path Parameters

customerId*string

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

reason*string

처리 사유 — 구매자 요청·장기 미이용·부정 이용·기타. 감사 로그에 남는다

Value in

  • "BUYER_REQUEST"
  • "DORMANT"
  • "ABUSE"
  • "OTHER"
memo?string

사유 보충(선택)

Lengthlength <= 200

Response Body

curl -X POST "https://example.com/v1/customers/string/withdraw" \  -H "Content-Type: application/json" \  -d '{    "reason": "BUYER_REQUEST"  }'
Empty