虚拟货币

工作原理

虚拟货币是用于购买虚拟商品的虚拟资金。根据使用方式，虚拟货币可用于调节游戏内经济系统，或作为应用变现的手段。

主要功能：

销售任意数量的虚拟货币，或销售固定数量的虚拟货币套餐。
以真实货币或虚拟货币销售虚拟货币及虚拟货币套餐。
限制可购买的虚拟货币套餐数量。
限制虚拟货币及虚拟货币套餐在商店中的显示时间。
免费的虚拟货币套餐。

在折扣活动和包含兑换码或优惠券的活动中，必须使用虚拟货币套餐。任意数量的虚拟货币只能用于奖励活动。

虚拟货币支持以下销售方式：

任意数量 — 允许按用户指定的数量销售虚拟货币。要使用此选项，需要在客户端实现一个输入字段，让用户在购买时输入所需的货币数量。
套餐 — 允许按预设数量销售虚拟货币。货币套餐的价格单独设置，可能与相同数量该货币的标准价格不同。

**示例：**某套餐包含100枚金币，售价90 美元，而单个金币的价格为1 美元。

限制：

一个套餐中只能添加一种虚拟货币。
以其他虚拟货币计价的价格仅可通过API调用进行配置。

虚拟货币套餐可设为免费，即无需指定真实货币或虚拟货币价格。可通过发布商帐户或API调用进行配置。不属于套餐的免费虚拟货币只能通过API调用创建。

虚拟货币套餐可设为免费，即无需指定真实货币或虚拟货币价格。可通过您的帐户或API调用进行配置。不属于套餐的免费虚拟货币只能通过API调用创建。

虚拟货币套餐可设为免费，即无需指定真实货币或虚拟货币价格。可在移动端游戏帐户中或通过API调用进行配置。不属于套餐的免费虚拟货币只能通过API调用创建。

套餐中的虚拟货币数量仅支持整数。

设置方法

在发布商帐户中设置

在您的帐户中设置

在设置虚拟货币或虚拟货币套餐前，建议先创建组，以便对商品分类并管理其在商店中的展示。

在发布商帐户中打开您的项目，并前往Items catalog > All items > Virtual currencies部分。

在您的帐户中打开项目，并前往Items catalog > All items > Virtual currencies部分。

在您的帐户中打开项目，并前往Items catalog > All items > Virtual currencies部分。

在您的帐户中打开项目，并前往Items catalog > All items > Virtual currencies部分。

在移动端游戏专用帐户中打开项目，并前往Catalog部分。

点击Create manually，并在下拉列表中选择Virtual currency。

在General settings部分，填写以下内容：
1. SKU
2. 商品所属的一个或多个组（可选）
3. 名称
4. 简短描述
5. 扩展描述—若要添加，请打开相应的开关（可选）

在 Media 部分，上传一张或多张图片或视频（可选）——可从设备上传或通过链接添加。使用艾克索拉建站器创建的网站中，所有商品卡片都会显示被标记为 Main 的文件，其余文件仅在带有媒体图库的商品卡片中可见。被标记为 Main 的文件也会在目录检索API调用的响应中返回。

在Price settings部分，设置价格或创建免费商品：
- 如需设置价格，选择Paid item，打开Pricing in real currency开关，并指定价格。必要时，配置区域价格。
- 如需创建免费商品，选择Free item。

若要限制可购买的商品数量：
1. 在Limits部分打开开关并指定数量。
2. 配置限制重置频率。为此，从下拉列表中选择一个周期：
  - Daily。
  - Weekly。
  - Monthly。
  - Custom interval。区间从商品在商店开始显示之日开始计算。
  - No regular refresh。
3. 根据所选周期设置重置计划，填写相应参数。

默认情况下，达到购买数量限制后，商品会从目录中隐藏。若已配置自动限制重置，勾选 Show item even after users reach the purchase limit 复选框可使商品保持可见，直到下一个重置周期开始。

配置商品的显示时间限制（可选）：
1. 在 Add specific display period 部分打开开关。
2. 指定时区以及该时间段的开始和结束时间。
如需不指定商品显示结束时间，请打开 No end date 开关。

To add another display period for the item in the catalog, click +. If an item has multiple display periods, each must have an end date. The display period ends at the last second of the specified minute. For example, if an end time is set to 12:00, the display period runs until 12:00:59.

按以下任一方式配置属性（可选）：
1. 以JSON格式添加属性及其值。
2. 手动创建属性及其值，并将其链接到商品。

若该付费商品将用于任何随机奖励机制（如战利品箱或扭蛋），请启用Mark as paid randomized reward开关。

在对此类机制有法律限制的国家/地区分发游戏时，可能需要此参数。

点击Create。
在打开的窗口中，选择商品状态，然后点击Continue。

创建的商品会显示在 All items 部分。

在发布商帐户中打开您的项目，并前往Items catalog > All items > Virtual currency packages部分。

在您的帐户中打开项目，并前往Items catalog > All items > Virtual currency packages部分。

在您的帐户中打开项目，并前往Items catalog > All items > Virtual currency packages部分。

在您的帐户中打开项目，并前往Items catalog > All items > Virtual currency packages部分。

在移动端游戏专用帐户中打开项目，并前往Catalog部分。

点击Create manually，并在下拉列表中选择Virtual currency。

在General settings部分，填写以下内容：
1. SKU
2. 商品所属的一个或多个组（可选）
3. 名称
4. 简短描述
5. 扩展描述—若要添加，请打开相应的开关（可选）

在 Media 部分，上传一张或多张图片或视频（可选）——可从设备上传或通过链接添加。使用艾克索拉建站器创建的网站中，所有商品卡片都会显示被标记为 Main 的文件，其余文件仅在带有媒体图库的商品卡片中可见。被标记为 Main 的文件也会在目录检索API调用的响应中返回。

指定套餐中包含的虚拟货币及其数量。
在Price settings部分，设置价格或创建免费商品：
- 如需设置价格，选择Paid item，打开Pricing in real currency和/或Pricing in virtual currency开关，并指定价格。如需，配置区域价格。
- 如需创建免费商品，选择Free item。

一个商品可以设置多种真实货币和虚拟货币的价格。在这种情况下，必须为每种类型指定默认货币：一种用于真实货币，一种用于虚拟货币。

只有当项目中已创建对应的虚拟货币时，才能以虚拟货币指定价格。

若要限制可购买的商品数量：
1. 在Limits部分打开开关并指定数量。
2. 配置重置频率。为此，从下拉列表中选择一个周期：
  - Daily。
  - Weekly。
  - Monthly。
  - Custom interval。区间从商品在商店开始显示之日开始计算。
  - No regular refresh。
3. 根据所选周期设置重置计划，填写相应参数。

配置商品的显示时间限制（可选）：
1. 在Add specific display period部分打开开关。
2. 指定时区以及该时间段的开始和结束时间。
如需不指定商品显示结束时间，请打开No end date开关。

按以下任一方式配置属性（可选）：
1. 以JSON格式添加属性及其值。
2. 手动创建属性及其值，并将其关联到商品。

如果该付费商品将用于任何随机奖励机制（如战利品箱或扭蛋），启用Mark as paid randomized reward开关。

在对此类机制有法律限制的国家/地区分发游戏时，可能需要此参数。

点击Create。
在打开的窗口中，选择商品状态，然后点击Continue。

创建的商品会显示在 All items 部分。

通过API设置

要设置虚拟货币，您可以使用虚拟物品和货币组中Admin子部分的API调用。

Admin子部分下的调用不用于在前端构建商店目录。请勿将其用于落地页、网页商店和游戏内逻辑。

任务	API调用
创建虚拟货币。	创建虚拟货币。
获取虚拟货币。	获取虚拟货币。
获取虚拟货币列表。	获取虚拟货币列表。
更新虚拟货币。	更新虚拟货币。
删除虚拟货币。	删除虚拟货币。
限制可购买的虚拟货币数量。	在创建虚拟货币或更新虚拟货币API调用中传递以下参数： `limits` — 指定可购买的虚拟货币最大数量。 `limits.recurrent_schedule` — 定义限制重置的频率。
创建虚拟货币套餐。	创建虚拟货币套餐。
获取虚拟货币套餐。	获取虚拟货币套餐。
获取虚拟货币套餐列表。	获取虚拟货币套餐列表。
更新虚拟货币套餐。	更新虚拟货币套餐。
删除虚拟货币套餐。	删除虚拟货币套餐。
限制可购买的虚拟货币套餐数量。	在创建虚拟货币套餐或更新虚拟货币套餐API调用中传递以下参数： `limits` — 指定可购买的虚拟货币套餐最大数量。 `limits.recurrent_schedule` — 定义限制重置的频率。

关于限制的更多信息，请参阅以下指南：

虚拟货币在商店中的显示周期仅可通过API调用配置。

在目录中显示虚拟货币

虚拟货币或虚拟货币套餐的显示方式取决于目录的实现方式 — 通过建站器或通过API。

通过建站器显示

商店目录中仅可显示虚拟货币套餐。

要显示虚拟货币套餐：

创建虚拟货币套餐。
在发布商帐户的项目中，前往Storefronts > Websites部分。
点击所需网站的窗格。

创建虚拟货币套餐。
在您的帐户的项目中，前往Storefronts > Websites部分。
点击所需网站的窗格。

创建虚拟货币套餐。
在您的帐户的项目中，前往Storefronts > Websites部分。
点击所需网站的窗格。

创建虚拟货币套餐。
在您的帐户的项目中，前往Storefronts > Websites部分。
点击所需网站的窗格。

创建虚拟货币套餐。
在移动端游戏专用帐户的项目中，前往Web Shop部分。
点击所需网站的窗格。

如果网站包含多个页面，请选择需要的页面：
1. 点击编辑器顶部的当前页面标题。
2. 在下拉列表中选择所需页面。
在Store区块部分，于Item type字段中选择要在网站上销售的虚拟货币套餐。

设置商品卡片布局。
完成所有必要更改并准备发布网站后：
1. 在建站器右上角，点击Publish。
2. 勾选要发布的页面。
3. 点击Publish。

如果无法发布网站，请确保满足以下条件：

网站中没有空白部分（以红色指示标记）。
已与艾克索拉签署许可协议。
已发布主页或已选择主页进行发布。在主页之前不能发布子页面。

网站发布后，将出现包含虚拟货币套餐的区段。如果未显示套餐，请检查其状态是否设置为 Available，且是否未启用基于时间的显示限制。

通过API获取虚拟货币信息

要在客户端检索虚拟货币和虚拟货币套餐的目录，请使用虚拟物品和货币组中Catalog子部分的API调用。

任务	API调用
通过SKU获取虚拟货币。	在通过SKU获取虚拟货币API调用中传递`virtual_currency_sku`参数。
获取虚拟货币列表。	获取虚拟货币列表。
通过SKU获取虚拟货币套餐。	在通过SKU获取虚拟货币套餐API调用中传递`virtual_currency_package_sku`参数。
获取虚拟货币套餐列表。	获取虚拟货币套餐列表。

向用户发放虚拟货币

根据商品类型和集成设置，虚拟货币将通过以下方式之一发放给用户：

如果已集成PlayFab，虚拟货币和商品会自动发放到用户的PlayFab物品库中。
如果使用自定义交付系统，所有虚拟物品和货币均由你方发放。建议设置Webhook 处理程序以在后端接收订单数据。必要的数据包含在订单支付成功Webhook中。

有关此方法及其他获取购买数据的方法的详细信息，请参见设置订单状态跟踪部分。

感谢您的反馈！

我们会查看您的留言并运用它改进用户体验。

上次更新时间: 2026年5月15日

发现了错别字或其他内容错误？请选择文本，然后按Ctrl+Enter。

工作原理
设置方法
在发布商帐户中设置
在您的帐户中设置
通过API设置
在目录中显示虚拟货币
通过建站器显示
通过API获取虚拟货币信息
向用户发放虚拟货币