# 사용자의 로열티 포인트 잔액 차감

지정된 금액만큼 사용자의 로열티 포인트 잔액을 차감합니다.

Endpoint: POST /projects/{project_id}/users/{user_id}/points/{point_id}/balance/debit
Version: 2.0.0
Security: basicAuth

## Path parameters:

  - `project_id` (integer, required)
    프로젝트 ID. 이 매개 변수는 프로젝트 이름 옆의 관리자 페이지에서 또는 프로젝트 작업 시 브라우저 주소 표시줄에서 확인할 수 있습니다. URL 형식은 다음과 같습니다: https://publisher.xsolla.com//projects/.
    Example: 44056

  - `user_id` (string, required)
    시스템의 사용자 ID입니다. 이 ID는 user.id 매개 변수 전달하는 값과 일치해야 합니다. 이 매개 변수는 결제 토큰 생성 시 사용되며, 로열티 포인트는 이 사용자 ID와 연결됩니다.
    Example: "d342dad2-9d59-11e9-a384-42010aa8003f"

  - `point_id` (string, required)
    로열티 포인트 ID입니다. 로열티 포인트는 관리자 페이지의 LiveOps > 로열티 프로그램 섹션에서 구성합니다. ID를 가져오려면 카탈로그 조회 API 호출을 사용합니다. ID는 loyalty_rewards[].sku 매개 변수로 반환됩니다.
    Example: "3fa85f64-5717-4562-b3fc-2c963f66afa6"

## Request fields (application/json):

  - `amount` (number, required)
    차감할 로열티 포인트 금액입니다. 양수여야 합니다.
    Example: 50

  - `reason` (string, required)
    자유 텍스트 형식의 잔액 변경 사유입니다(예: 리워드, 보상, 수동 조정).
    Example: "Manual adjustment"

## Response 200 fields (application/json):

  - `transaction_id` (string, required)
    이 요청으로 생성된 차감 트랜잭션의 ID.
    Example: "3fa85f64-5717-4562-b3fc-2c963f66afa6"

  - `previous_balance` (number, required)
    차감 전 잔액.
    Example: 150.5

  - `new_balance` (number, required)
    차감 후 잔액.
    Example: 100.5

  - `amount` (number, required)
    잔액에서 차감된 금액.
    Example: 50

## Response 400 fields (application/json):

  - `message_id` (string, required)
    오류 코드.
    Example: "error_bad_request"

  - `message` (string, required)
    간단한 오류 설명.
    Example: "Invalid request body."

## Response 401 fields (application/json):

  - `statusCode` (integer)
    HTTP 응답 상태.

  - `errorCode` (integer)
    오류 코드.

  - `errorMessage` (string)
    간단한 오류 설명.

  - `transactionId` (string)
    요청 ID. 이 특정 요청 또는 작업과 관련된 로그 엔트리를 추적하고 연결하는 데 사용되는 ID입니다. 이 ID는 문제 해결, 디버깅 및 감사 목적으로 유용하게 활용될 수 있습니다.

## Response 404 fields (application/json):

  - `message_id` (string, required)
    오류 코드.
    Example: "error_not_found"

  - `message` (string, required)
    간단한 오류 설명.
    Example: "User account or loyalty points not found."

## Response 422 fields (application/json):

  - `message_id` (string, required)
    오류 코드.
    Example: "error_bad_request"

  - `message` (string, required)
    간단한 오류 설명.
    Example: "Insufficient loyalty point balance."