> For the complete documentation index, see [llms.txt](https://docs.allout.game/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.allout.game/all-out-docs/docs-zh/bian-xian/in-game-products.md).

# 游戏内产品

消耗品和游戏通行证的创建方式类似，但使用场景略有不同！

### 产品类型

#### 游戏通行证

使用游戏通行证用于永久性一次性购买：

* 解锁管理员通行证
* 永久性强化/能力
* 购买房屋

#### 消耗品

将消耗品用于你希望用户能够多次购买的产品：

* 生命药水
* 随时间过期的增益
* 一次性游戏内货币购买

### 创建产品

<figure><img src="https://866492016-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzA8RGUKJ88fD0oXVALlz%2Fuploads%2Fgit-blob-c14e477cb11e87cac616ceb940669663e39b8081%2Fimage.png?alt=media" alt="Add Product form in the Monetization tab"><figcaption><p>要创建产品，请点击你游戏的 Creator Portal 的“变现”选项卡中的“+ 添加产品”按钮</p></figcaption></figure>

<figure><img src="https://866492016-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzA8RGUKJ88fD0oXVALlz%2Fuploads%2Fgit-blob-e6392255f1c97f0c51da4ac8aeab7d7a8177ef4e%2Fimage.png?alt=media" alt="Product form with the consumable option clear"><figcaption><p>如果未勾选消耗品框，这将是“游戏通行证”</p></figcaption></figure>

{% hint style="warning" %}
上传产品图片目前仅限管理员。请在以下位置联系我们： [开发者支持](/all-out-docs/docs-zh/quan-li-yi-fu/developer-support.md) 以上传缩略图
{% endhint %}

### 了解产品列表

变现页面会显示你在所选日期范围内的产品及其活动：

* 产品名称、价格和 ID。复制产品 ID 以在你的 [购买代码](/all-out-docs/docs-zh/he-xin-yin-qing-gai-nian/purchasing-product-apis.md).
* 销售和 Spark 消耗历史。
* **可提现** 和 **不可提现** Spark 消耗。只有可提现部分会计入游戏的提现余额。
* **授予失败**，这样你就能找到游戏内奖励仍需发放的购买记录。

该 **游戏 Spark 余额** 显示在退款和之前提现之后，你剩余的已追踪可提现收益。它独立于报告的日期筛选器，涵盖整个

选择 **提现** 将可提现收益转给创作者或当前编辑。收款方将获得 70%，并向下取整为整数个 Spark。若要按 1 美元兑换 100 Spark 将收到的 Spark 兑换成现金，请联系 All Out 团队。参见 [Spark 提现](/all-out-docs/docs-zh/bian-xian/spark-withdrawals.md) 了解费用、权限、退款和提现详情。

#### 购买处理器 / 授予失败

当用户在你的游戏中购买产品时，我们会运行 `ao_purchase_handler` 你在游戏代码中定义的函数。

你的购买处理器通常会根据用户购买的产品 ID 向玩家授予一个物品或功能。仅在授予成功后返回 `true` 。

如果你的购买处理器失败——例如，他们的物品栏已满，而你没有处理该情况——返回 `false`。这将计为“授予失败”，并显示在 Creator Portal 的产品页面中，以便你修复问题。

授予失败将 **在玩家每次加入时自动重试，直到成功。** 处理器必须可以安全地再次运行，并且在返回之前不得部分授予奖励 `false`.

如果你的购买处理器已经成功，但由于游戏漏洞或其他原因，用户丢失了该物品，你可以 **重新运行** 通过在 [编辑/查看玩家数据](/all-out-docs/docs-zh/shu-ju-yu-chi-jiu-hua/editing-viewing-player-data.md) “购买” 部分中将该购买标记为未授予来为该用户运行购买处理器。请先确认重新运行处理器不会重复发放奖励。