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

# 트랜잭션 이력

> PlayFab Economy v2 Transaction History API를 쿼리하여 플레이어 계정에서 수행된 인벤토리 작업, 구매 및 아이템 부여를 감사합니다.

<Info>
  Economy v2는 이제 정식으로 사용할 수 있습니다(GA). 지원 및 피드백은 [PlayFab Forum](https://community.playfab.com)을 방문하세요.
</Info>

Economy v2 Inventory 서비스에는 플레이어의 인벤토리에서 수행된 모든 작업의 뷰를 얻을 수 있는 Transaction History API가 있습니다. 이 데이터를 사용하여 게임 시스템 사용을 추적하고, 버그를 해결하고, 악의적인 행위자를 식별할 수 있습니다.

트랜잭션 이력은 플레이어의 서로 다른 Inventory Collections로 그룹화되며 각 Collection에는 자체 이력이 있습니다. `CollectionId` 사용 및 플레이어당 여러 인벤토리에 대한 자세한 내용은 [여기](/services/playfab/economy-monetization/economy-v2/inventory/collections)에서 찾을 수 있습니다.

CollectionCreated와 CollectionDeleted와 같은 일부 이벤트는 트랜잭션 이력에 표시되지 않습니다.

## 플레이어의 트랜잭션 이력 가져오기

### Game Manager

1. [Game Manager](/services/playfab/live-service-management/gamemanager)에서 `Players`로 이동합니다.
2. 확인하려는 플레이어를 선택한 다음 `Transaction History`로 이동합니다.

### API

`GetTransactionHistory` API를 사용하여 플레이어의 트랜잭션 이력을 가져올 수 있습니다. 어떤 Inventory Collection의 이력을 볼지 표시하기 위해 `CollectionId` 매개 변수가 전달됩니다. 플레이어는 자신의 트랜잭션 이력에만 액세스할 수 있도록 제한됩니다. Title Entities는 액세스하려는 플레이어의 트랜잭션 이력을 표시하기 위해 `Entity` 매개 변수를 전달할 수 있습니다.

`Filter` 매개 변수를 사용하여 트랜잭션의 특정 시간 창을 볼 수 있는 타임스탬프 제약 조건을 전달할 수 있습니다. `Filter`는 `timestamp ge`(크거나 같음)와 `timestamp le`(작거나 같음)만 지원하며 트랜잭션 이력을 보기 위한 최대 6개월 길이의 타임스탬프 기간 제한이 있습니다.

`GetTransactionHistory` 요청 예:

```json theme={null}
{
    "Entity": {
        "Id": "ABCD12345678",
        "Type": "title_player_account",
    },
    "CollectionId": "default",
    "Count": 10,
    "Filter": "timestamp ge 2021-12-30T23:00Z and timestamp le 2021-12-31T23:00Z"
}
```

#### Continuation Token

응답에서 반환된 `ContinuationToken` 필드를 트랜잭션 이력 요청에 전달하여 여러 개의 결과 카운트를 페이지 매김할 수 있습니다.


## Related topics

- [Economy V2 제한](/ko/services/playfab/economy-monetization/economy-v2/limits.md)
- [아이템 및 인벤토리 개요](/ko/services/playfab/economy-monetization/economy-v2/inventory/items-and-inventory-overview.md)
- [Microsoft Store Marketplace 리뎀션](/ko/services/playfab/economy-monetization/economy-v2/marketplace/marketplace-redemption/microsoft.md)
- [Apple App Store 인앱 구매 리뎀션](/ko/services/playfab/economy-monetization/economy-v2/marketplace/marketplace-redemption/apple.md)
- [Google Marketplace 리뎀션](/ko/services/playfab/economy-monetization/economy-v2/marketplace/marketplace-redemption/google.md)