> ## 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 Legacy Economy 플레이어 간 거래 API 개요.

PlayFab 클라이언트 API를 사용하면 플레이어가 서로 아이템을 거래할 수 있습니다. 이러한 API 메서드는 기본적으로 활성화되어 있으므로, 타이틀 보안을 위해 정책 API를 사용하여 비활성화해야 할 수 있습니다.

<Note>
  인벤토리 거래 기능은 프리뷰 단계입니다. 메서드는 동작하지만 완성된 기능이 되기에는 유용한 요소가 일부 부족합니다. 현재 가상 아이템만 거래할 수 있습니다. 가상 화폐를 요청하거나 거래할 수 없으며, PlayFab은 다른 플레이어가 제공하는 사용 가능한 거래 목록을 제공하지 않습니다. 거래 메서드는 클라이언트 API에서만 사용할 수 있으며 서버 API에서는 사용할 수 없습니다.
</Note>

## 주요 개념

**카탈로그** - 카탈로그는 게임의 가상 아이템을 관리하는 쉬운 방법을 제공합니다. 게임에서 사용 가능한 모든 아이템의 목록입니다.

**카탈로그 아이템** – PlayFab 아이템은 durables부터 bundles, locked containers까지 사용할 수 있는 거의 모든 유형의 가상 재화를 표현할 수 있습니다.

**인벤토리** - 모든 계정(플레이어 계정과 캐릭터 계정)에는 인벤토리가 있습니다. 인벤토리에는 소유한 모든 아이템 인스턴스와 아이템 이력이 포함됩니다.

**가상 화폐** - PlayFab은 타이틀당 최대 10개의 가상 화폐를 제공합니다. 화폐는 카탈로그나 상점에서 아이템을 구매하는 데 사용하거나, 인앱 결제에서 변환된 소프트 화폐를 표현하거나, 게임 플레이를 유도하는 메커니즘으로 사용할 수 있습니다.

## 사전 요구 사항

거래는 카탈로그와 인벤토리 아이템에 대한 이해가 필요합니다. 플레이어는 거래하려는 인벤토리 아이템을 소유하고 있어야 합니다.

## API

거래 흐름은 몇 가지 API로 처리됩니다.

[OpenTrade](xref:titleid.playfabapi.com.client.trading.opentrade)\
새로운 미체결 거래를 엽니다. 이 거래는 특정 두 플레이어(PlayfabID) 사이에서 이루어질 수도 있고, 한 플레이어가 누구나 참여할 수 있는 거래를 열 수도 있습니다. 하나의 아이템 인스턴스는 한 번에 하나의 열린 거래에만 포함될 수 있음에 유의하세요.

[GetTradeStatus](xref:titleid.playfabapi.com.client.trading.gettradestatus)\
클라이언트가 현재 상태를 가져와 특정 거래를 평가할 수 있게 합니다.

[AcceptTrade](xref:titleid.playfabapi.com.client.trading.accepttrade)\
열린 거래를 수락합니다. 호출이 성공하면 제공된 아이템과 수락된 아이템이 두 플레이어의 인벤토리 사이에서 교환됩니다.

[CancelTrade](xref:titleid.playfabapi.com.client.trading.canceltrade)\
열린 거래를 취소합니다. 부당한 방해를 방지하기 위해 이 API 호출로는 거래를 만든 플레이어만 취소할 수 있음에 유의하세요.

[GetPlayerTrades](xref:titleid.playfabapi.com.client.trading.getplayertrades)\
**GetPlayerTrades**는 플레이어가 열었거나 수락한 모든 거래를 반환하며, 필요에 따라 거래 상태별로 필터링할 수 있습니다.


## Related topics

- [아이템 및 인벤토리 개요](/ko/services/playfab/economy-monetization/economy-v2/inventory/items-and-inventory-overview.md)
- [PFInventoryTransactionOperation](/ko/services/playfab/api-references/c/pfinventorytypes/structs/pfinventorytransactionoperation.md)
- [PFInventoryTransaction](/ko/services/playfab/api-references/c/pfinventorytypes/structs/pfinventorytransaction.md)
- [트레이딩 빠른 시작](/ko/services/playfab/economy-monetization/economy/trading/trading-quickstart.md)
- [PFInventoryGetTransactionHistoryRequest](/ko/services/playfab/api-references/c/pfinventorytypes/structs/pfinventorygettransactionhistoryrequest.md)