> For the complete documentation index, see [llms.txt](https://docs.ggwp.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ggwp.com/kr/api-6/player-spend.md).

# 플레이어 지출

\[ 기본 URL: `api.ggwp.com`]

`POST` /users/v1/player-spend

## **설명**

개별 플레이어가 게임 내 구매에 지출한 실제 통화를 보고합니다. 이 정보는 GGWP의 중재 워크플로 패널에 추가적인 맥락을 제공하여, 커뮤니티 관리자와 중재 팀이 플레이어의 행동을 평가할 때 최선의 결정을 내릴 수 있도록 사용됩니다.

## **매개변수**

`본문`: 다음 필드를 포함하는 사전:

* **user\_id**: 플레이어의 고유 식별자.
* **(선택 사항) platform:** 구매가 발생한 위치(예: Xbox, PlayStation, Android 등)
* **currency**: 사용된 통화 유형(예: “USD”, “EUR”, “JPY”, “BTC” 등)
* **transaction\_amount**: 완료된 거래의 숫자 값.
* **item\_category**: `game_purchase` / `battlepass` / `cosmetic`.
* **item\_id**: 구매한 아이템 유형의 식별자.
* **(선택 사항)lifetime\_spend**: 플레이어의 평생 동안 지출한 누적 총액.
* **(선택 사항) timestamp:** 거래가 실행된 시간 *YYYY-MM-DD HH:MM:SS* 형식의 UTC 시간입니다. 비어 있는 경우, 서버 측 UTC 타임스탬프가 대신 사용됩니다.
* 예시 호출

  ```bash
  curl --request POST 'https://api.ggwp.com/users/v1/player-spend' \\
  --header 'x-api-key: api_key' \\
  --header 'Content-Type: application/json' \\
  --data-raw '{
    "user_id": "<id1>",
    "platform": "android",
    "currency": "USD",
    "transaction_amount": 6.50,
    "item_category": "cosmetic",
    "item_id": "skin",
    "lifetime_spend": 124.75,
    "timestamp": "2022-01-25 09:44:00"
  }'
  ```

## **출력**

* 200 - 성공적인 작업

  ```json
  {
    "status": "success"
  }
  ```
* 400
  * 오류 응답입니다. 이벤트가 시스템에 삽입되지 않았습니다. 이 오류는 다음 경우에 발생합니다:
    * `잘못된 본문. JSON 입력이 필요합니다`
      * 데이터 페이로드가 JSON 형식이 아닙니다
    * `데이터 페이로드가 너무 큽니다`
      * 데이터 페이로드가 1MB를 초과합니다
* 403
  * 잘못되었거나 누락된 API 키입니다.
* 500
  * 오류 응답입니다. 이벤트가 시스템에 삽입되지 않았습니다. 요청을 처리하는 동안 서버에서 오류가 발생했습니다.