虚拟货币
运行机制
虚拟货币是用于购买和销售虚拟商品的虚拟资金。根据使用方式，虚拟货币可用于调节游戏内经济系统，或作为应用变现的手段。
主要功能：
- 销售任意数量的虚拟货币，或销售固定数量的虚拟货币套餐。
- 以真实货币或虚拟货币作为定价方式销售虚拟货币及虚拟货币套餐。
- 限制虚拟货币套餐的可购买数量。
- 限制虚拟货币及虚拟货币套餐在商店中的展示时长。
- 提供免费虚拟货币套餐。
注意
在折扣活动及使用促销码或优惠券的活动中，必须使用虚拟货币套餐的形式。任意数量的虚拟货币仅可用于奖励活动。
虚拟货币支持以下销售方式：
- 任意数量 — 允许销售用户自定义数量的虚拟货币。使用此方式时，需在客户端侧实现输入字段，让用户在购买时输入所需的货币数量。
- 套餐 — 允许销售预设数量的虚拟货币。货币套餐的价格可单独设置，与相同数量货币的标准价格可以不同。
- 示例：某套餐包含100金币，售价$90，而单个金币的标准价格为$1。
限制：
- 每个套餐仅支持添加一种虚拟货币。
- 使用另一种虚拟货币定价仅可通过API调用配置。
- 虚拟货币套餐可设为免费，即无需指定真实货币或虚拟货币价格。可通过发布商帐户或API调用进行配置。不属于套餐的免费虚拟货币仅可通过API调用创建。
- 套餐中的虚拟货币数量仅支持整数。
如何设置
通过发布商帐户进行设置
注：
在设置虚拟货币或虚拟货币套餐前，建议先创建组，以便对商品分类并管理其在商店中的展示。
通过API设置
要设置虚拟货币，您可以使用虚拟物品和货币组管理子部分下的调用。
注意
管理子部分下的调用不适用于在前端创建商店目录，因此请勿将其用于着陆页、网页商城和游戏内逻辑。
| 任务 | API调用 |
|---|---|
| 创建虚拟货币。 | 创建虚拟货币。 |
| 获取虚拟货币。 | 获取虚拟货币。 |
| 获取虚拟货币列表。 | 获取虚拟货币列表。 |
| 更新虚拟货币。 | 更新虚拟货币。 |
| 删除虚拟货币。 | 删除虚拟货币。 |
| 限制虚拟货币可购买的数量。 | 在创建虚拟货币或更新虚拟货币API调用中传递以下参数：
|
| 创建虚拟货币套餐。 | 创建虚拟货币套餐。 |
| 获取虚拟货币套餐。 | 获取虚拟货币套餐。 |
| 获取虚拟货币套餐列表。 | 获取虚拟货币套餐列表。 |
| 更新虚拟货币套餐。 | 更新虚拟货币套餐。 |
| 删除虚拟货币套餐。 | 删除虚拟货币套餐。 |
| 限制虚拟货币套餐的可购买数量。 | 在创建虚拟货币套餐或更新虚拟货币套餐API调用中传递以下参数：
|
注：
有关数量限制的更多信息，请参阅以下指南：
注意
虚拟货币在商店中的显示周期仅可通过API调用配置。
在商店中显示虚拟货币
虚拟货币或虚拟货币套餐的显示方式取决于目录的实现方式 — 通过建站器还是通过API。
通过建站器显示
注：
商店目录中仅可显示虚拟货币套餐。
- 在商店区块部分，于商品类型字段中选择要在网站上销售的虚拟货币套餐。
- 设置商品卡片布局。
- 完成所有必要更改并准备发布网站后：
- 在建站器右上角，单击发布。
- 勾选您要发布的页面。
- 单击发布。
注意
如果无法发布网站，请确保满足以下所有条件：
- 网站上没有空白区段（红色标记的部分）。
- 已签署与艾克索拉的许可协议。
- 主页已发布或已勾选待发布。主页发布前无法发布子页面。
网站发布后，包含虚拟货币套餐的区段将可用。如果未显示套餐，请检查其状态是否设置为可用以及是否启用了基于时间的显示限制。
通过API获取虚拟货币信息
要在客户端侧检索虚拟货币和虚拟货币套餐目录，请使用虚拟物品和货币组中目录子部分下的调用。
| 任务 | API调用 |
|---|---|
| 按SKU获取虚拟货币。 | 在按SKU获取虚拟货币API调用中传入virtual_currency_sku参数。 |
| 获取虚拟货币列表。 | 获取虚拟货币列表。 |
| 按SKU获取虚拟币套餐。 | 在按SKU获取虚拟币套餐API调用中传入virtual_currency_package_sku参数。 |
| 获取虚拟货币套餐列表。 | 获取虚拟货币套餐列表。 |
向用户发放虚拟货币
根据商品类型和集成设置，虚拟货币将通过以下方式之一发放给用户：
- 如果已集成PlayFab，虚拟货币和商品将自动发放到用户的PlayFab物品库中。
- 如果使用自定义交付系统，所有虚拟物品和货币将在己侧发放。建议设置Webhook处理程序以在后端接收订单数据。必要的数据包含在订单成功支付Webhook中。
本文对您的有帮助吗？
感谢您的反馈！
我们会查看您的留言并运用它改进用户体验。发现了错别字或其他内容错误？ 请选择文本，然后按Ctrl+Enter。
