> ## Documentation Index
> Fetch the complete documentation index at: https://docs.headlesscommerce.io/llms.txt
> Use this file to discover all available pages before exploring further.

# 고객 삭제 (익명화)

> For GDPR and other data deletion requests.
Anonymizes customer PII (name, email, phone, address) and sets status to disabled.
Existing order data is retained, but personally identifiable information is masked.




## OpenAPI

````yaml openapi.ko.yaml delete /admin/customers/{id}
openapi: 3.1.0
info:
  title: Headless Commerce API
  description: >
    Headless Commerce as a Service — REST API 명세서.


    ## 인증

    모든 요청에 API 키를 Bearer 토큰으로 전달하세요.

    - **Secret Key** (`sk_live_*`, `sk_test_*`): 서버 사이드. Admin + Storefront API
    전체 접근 가능.

    - **Publishable Key** (`pk_live_*`, `pk_test_*`): 클라이언트 사이드. Storefront API만
    접근 가능.


    ## 고객 인증 (Storefront)

    고객 식별이 필요한 Storefront 엔드포인트 (/storefront/customers/*, /storefront/orders/*)는

    `X-Customer-Token` 헤더가 필요합니다.

    1. 백엔드에서 `sk_*` 키로 `POST /admin/customers/{id}/token`을 호출하여 토큰 발급

    2. 프론트엔드에서 `pk_*` 키 + `X-Customer-Token` 헤더와 함께 요청 전송


    ## 페이지네이션

    커서 기반 페이지네이션을 사용합니다.

    - `limit`: 페이지 크기 (기본 20, 최대 100)

    - `starting_after`: 이 ID 이후의 결과 반환

    - 응답에 `has_more`와 `next_cursor` 포함


    ## 금액

    모든 금액은 최소 통화 단위의 정수입니다 (KRW=원, USD=센트).


    ## 속도 제한

    모든 응답에 다음 헤더가 포함됩니다:

    - `X-RateLimit-Limit`: 분당 최대 요청 수 (플랜별: Free 100, Starter 500, Pro 2000,
    Enterprise 10000)

    - `X-RateLimit-Remaining`: 현재 윈도우의 남은 요청 수

    - 초과 시 `429 Too Many Requests` 반환


    ## 멱등성

    결제/주문 관련 POST 요청에 `Idempotency-Key` 헤더를 포함하면 동일한 키의 중복 요청에 대해 원래 응답을 반환합니다.

    권장 대상: checkout, refund, payment 생성
  version: 1.0.0
  contact:
    name: Headless Commerce Support
    url: https://headlesscommerce.io
servers:
  - url: https://api.headlesscommerce.io/v1
    description: 프로덕션
  - url: https://api.headlesscommerce.io/v1
    description: 테스트 (동일 URL, 테스트 API 키)
security:
  - BearerAuth: []
tags:
  - name: Storefront - Products
    description: 구매자를 위한 상품 조회
  - name: Storefront - Cart
    description: 장바구니 관리 및 결제
  - name: Storefront - Orders
    description: 주문 조회 (본인 주문)
  - name: Storefront - Customers
    description: 고객 프로필 (본인 프로필)
  - name: Storefront - Shipping
    description: 배송 방법 조회
  - name: Admin - Products
    description: 상품 관리
  - name: Admin - Variants
    description: 변형(Variant) 관리
  - name: Admin - Categories
    description: 카테고리 관리
  - name: Admin - Collections
    description: 컬렉션 관리
  - name: Admin - Inventory
    description: 재고 관리
  - name: Admin - Orders
    description: 주문 관리
  - name: Admin - Fulfillments
    description: 출고 관리
  - name: Admin - Customers
    description: 고객 관리
  - name: Admin - Discounts
    description: 할인 관리
  - name: Admin - Shipping Methods
    description: 배송 방법 관리
  - name: Admin - Webhooks
    description: 웹훅 관리
  - name: Admin - Store
    description: 스토어 설정
  - name: Admin - Settings
    description: API 키, 조직 및 팀 관리
  - name: Admin - Returns
    description: 반품 관리
  - name: Admin - Regions
    description: 리전, 다국어 및 환율 관리
  - name: Admin - Dashboard
    description: 대시보드 통계
  - name: Admin - Logs
    description: API 로그 조회
  - name: Admin - Uploads
    description: 파일 업로드
  - name: Storefront - Returns
    description: 고객 반품 요청 및 조회
  - name: Storefront - Customer Auth
    description: 고객 회원가입 및 로그인
  - name: Storefront - Payments
    description: 결제 확인
  - name: OAuth
    description: OAuth 2.1 인가 코드 플로우 (PKCE 지원)
  - name: Auth
    description: 대시보드 사용자 비밀번호 재설정
  - name: Admin - CSV
    description: 대량 CSV 가져오기 및 내보내기
paths:
  /admin/customers/{id}:
    delete:
      tags:
        - Admin - Customers
      summary: 고객 삭제 (익명화)
      description: >
        For GDPR and other data deletion requests.

        Anonymizes customer PII (name, email, phone, address) and sets status to
        disabled.

        Existing order data is retained, but personally identifiable information
        is masked.
      parameters:
        - $ref: '#/components/parameters/ResourceId'
      responses:
        '200':
          description: 성공
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DeleteResponse'
components:
  parameters:
    ResourceId:
      name: id
      in: path
      required: true
      schema:
        type: string
      description: Resource ID
  schemas:
    DeleteResponse:
      type: object
      properties:
        id:
          type: string
        deleted:
          type: boolean
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      description: 'API Key. Example: sk_live_xxxxx or pk_live_xxxxx'

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.