> ## 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 玩家對玩家交易 API 概觀，讓玩家可以直接透過您的遊戲安全地交換庫存物品。

PlayFab 用戶端 API 可讓玩家彼此交易物品。這些 API 方法預設為啟用，因此為了您遊戲的安全性，您可能需要使用我們的原則 API 將其停用。

<Note>
  庫存交易功能處於預覽階段。這些方法可以運作，但缺少一些可讓其成為完整功能的實用元素。目前您只能交易虛擬物品。您無法要求或交易虛擬貨幣，而且 PlayFab 不會提供其他玩家可供您進行的交易清單。交易方法只能在用戶端 API 中使用，無法從伺服器 API 使用。
</Note>

## 重要概念

**目錄** - 目錄提供簡單的方式來管理遊戲的虛擬物品。目錄是遊戲中所有可用物品的清單。

**目錄物品** – PlayFab 物品幾乎可以代表您可能使用的任何類型虛擬商品，從耐久性物品、組合包到上鎖的容器皆可。

**庫存** - 所有帳戶 (玩家帳戶和角色帳戶) 都有庫存。庫存包含所有擁有的物品執行個體，以及物品歷程記錄。

**虛擬貨幣** - 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

- [交易記錄](/zh-TW/services/playfab/economy-monetization/economy-v2/inventory/transaction-history.md)
- [取消交易](/zh-TW/services/playfab/api-references/rest/client/trading/cancel-trade.md)
- [開啟交易](/zh-TW/services/playfab/api-references/rest/client/trading/open-trade.md)
- [接受交易](/zh-TW/services/playfab/api-references/rest/client/trading/accept-trade.md)
- [交易式寫入](/zh-TW/services/playfab/player-progression/statistics/transactional-writes.md)