> ## 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>

## 关键概念

**目录 (Catalog)** - 目录提供了一种简单的方式来管理游戏的虚拟物品。它们是游戏中所有可用物品的列表。

**目录物品 (Catalog Items)** – PlayFab 物品几乎可以代表你可能使用的任何类型的虚拟商品——从耐用品到捆绑包再到锁定容器。

**库存 (Inventory)** - 所有帐户（玩家帐户和角色帐户）都有一个库存。库存包含所有拥有的物品实例以及物品历史记录。

**虚拟货币 (Virtual Currency)** - PlayFab 每个游戏最多支持 10 种虚拟货币。货币可用于从目录或商店购买物品，可以代表由应用内购买转换而来的软货币，或作为推动游戏玩法的机制。

## 先决条件

交易需要熟悉目录和库存物品。玩家必须拥有他们想要交易的库存物品。

## API

交易流程由少数几个 API 处理：

[OpenTrade](xref:titleid.playfabapi.com.client.trading.opentrade)\
打开一个新的未完成交易。这可以是两个特定玩家（PlayfabIDs）之间的交易，也可以是一个玩家开启一个对任何人开放的交易。请注意，任何单个给定的物品实例一次只能出现在一个未完成交易中。

[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-CN/services/playfab/economy-monetization/economy-v2/inventory/transaction-history.md)
- [交易快速入门](/zh-CN/services/playfab/economy-monetization/economy/trading/trading-quickstart.md)
- [Economy v2 中的幂等交易和重试模式](/zh-CN/services/playfab/economy-monetization/economy-v2/tutorials/idempotent-transactions-and-retries.md)
- [兑换 Apple App Store 应用内购](/zh-CN/services/playfab/economy-monetization/economy-v2/marketplace/marketplace-redemption/apple.md)
- [Economy V2 限制](/zh-CN/services/playfab/economy-monetization/economy-v2/limits.md)
