虚拟货币

运行机制

虚拟货币是用于购买及销售虚拟商品的电子货币。根据用途不同,虚拟货币可能影响游戏帐户余额或与应用的营收关联。

主要功能:

注:
如果要创建价格为0的虚拟货币或虚拟货币套餐,请联系您的客户成功经理或发送邮件至csm@xsolla.com
注意
在折扣促销活动、促销码或优惠券促销活动中,必须使用虚拟货币套餐。非固定数量的虚拟货币只能用在奖励促销活动中。

货币销售方案

虚拟货币有如下销售方案:

销售任意数量的虚拟货币

销售用户指定数量的虚拟货币。请实现在应用程序客户端输入要购买的虚拟货币数量的请求。

销售虚拟货币套餐

以预定义的固定数量为单位销售虚拟货币。此功能允许您以套餐形式销售游戏内货币,套餐的价格可以比单独购买相同数量的货币更低。

示例:您可以为套餐定义一个特殊价格,该价格不等于单独购买套餐内相同数量货币的价格。例如:1个虚拟币 = 1美元,500个虚拟币 = 450美元。

限制:

  • 只能在套餐中添加一种虚拟货币。
  • 可以在不指定真实或虚拟货币价格的情况下创建货币套餐。如此类商品在商店中显示,则对用户以免费形式提供。
  • 虚拟货币的数量只能指定为整数值。

货币交付

现有交付方式:
  • 直接交付至艾克索拉物品库(默认方式)。交付之前,虚拟货币套餐会解开,其中的货币将发放至玩家物品库。
  • 交付至PlayFab(如果配置了该集成)。
注:
如果游戏内商店逻辑在您自己的服务器上实现,则可配置购买Webhook

硬货币

硬货币是与购买平台关联的货币,只能使用真实货币购买。

限制:

  • 只能在初始设置中将货币的状态指定为货币。
  • 包含硬虚拟货币的虚拟货币套餐只能使用真实货币购买。

要单独在其他平台上存储硬货币:

  • 付费虚拟货币开关设置为

示例

Copy
Full screen
Small screen
1"platform": "playstation_network"

限制虚拟货币套餐可购买的数量

您可以限制虚拟货币套餐的购买次数。例如可以限制:

  • 单个用户可购的虚拟货币套餐数量
  • 仅可购买一次的新人虚拟货币套餐

如果用户已达到指定的数量限制,该虚拟货币套餐将不在目录中显示。

您可以显示套餐的最大可购数量以及该用户的剩余套餐可购数量。

要在发布商帐户中创建虚拟货币套餐时设置购买数量限制,请将限制单个用户可购买套餐的次数开关设置为,并指定套餐的可购次数。

您可以使用虚拟物品和货币方法组中的目录子部分下的方法获取虚拟货币套餐的信息。

在响应中,除虚拟货币套餐的信息之外,还将收到以下信息:

  • 单个用户虚拟货币套餐的最大可购数量
  • 该用户的剩余虚拟货币套餐可购数量

关于如何设置或更新限制的更多信息,请参阅用户限制说明。

注:

对于未授权用户,将始终显示其可购买的最大虚拟货币套餐数量。要显示用户剩余可购买的虚拟货币套餐数量(取决于当前限制),使用虚拟物品和货币方法组目录子部分下的方法请求虚拟货币套餐目录时,请传入用户授权数据。

要正确显示用户可购的虚拟货币套餐数量,需配置身份认证

包含用户属性的Webhook响应示例:
Copy
Full screen
Small screen
 1{
 2  "items": [
 3    {
 4      "sku": "vc_package_1",
 5      "name": "VC Name first package",
 6      "groups": [],
 7      "attributes": [],
 8      "type": "bundle",
 9      "description": "VC Short Package Description",
10      "image_url": "http://vc_package_image.png",
11      "is_free": false,
12      "price": {
13        "amount": "2.0000",
14        "amount_without_discount": "2.0000",
15        "currency": "USD"
16      },
17      "bundle_type": "virtual_currency_package",
18      "content": [
19        {
20          "description": "Big Rocket - short description",
21          "image_url": "https://popmedia.blob.core.windows.net/popyourself/male/outfit/male_armor_white_a-01.png",
22          "sku": "big_rocket",
23          "name": "Big Rocket",
24          "type": "virtual_currency",
25          "quantity": 100,
26          "inventory_options": {
27            "consumable": {
28              "usages_count": 1
29            },
30            "expiration_period": null
31          }
32        }
33      ],
34      "virtual_prices": [],
35      "limits": {
36        "per_user": {
37          "total": 5,
38          "available": 5
39          },
40        "per_item": null
41       },
42      "can_be_bought": true
43    },
44    {
45      "sku": "vc_package_3",
46      "name": "VC Name third package",
47      "groups": [],
48      "attributes": [],
49      "type": "bundle",
50      "description": "VC Short Package Description",
51      "image_url": "http://vc_package_image.png",
52      "is_free": false,
53      "price": {
54        "amount": "4.0000",
55        "amount_without_discount": "4.0000",
56        "currency": "USD"
57      },
58      "bundle_type": "virtual_currency_package",
59      "content": [
60        {
61          "description": "description",
62          "image_url": "http://image.png",
63          "sku": "shotgun_raider",
64          "name": "SHOTGUN FOR TRUE RAIDERS",
65          "type": "virtual_currency",
66          "quantity": 200,
67          "inventory_options": {
68            "consumable": {
69              "usages_count": 1
70            },
71            "expiration_period": null
72          }
73        }
74      ],
75      "virtual_prices": [],
76      "limits": {
77        "per_user": {
78          "total": 5,
79          "available": 5
80          },
81        "per_item": null
82       },
83      "can_be_bought": true
84    }
85  ]
86}
注:

艾克索拉会确保不超过购买限制数并阻止用户购买超过设定限制的虚拟货币套餐。

打开支付界面并支付某个套餐后,所有包含该套餐的未支付订单将失效。

示例:假设某个套餐有购买数量限制,在下单之前,用户可以在多个浏览器选项卡中打开该套餐的支付表单。这样会自动为同一个套餐创建多个订单。在某个选项卡中购买了该套餐后,艾克索拉将自动让该套餐的所有其他未付订单失效。

限制虚拟货币和虚拟货币套餐在商店中的显示时间

您可以设置虚拟货币和虚拟货币套餐在商店中的显示时间,以实现以下目的:

  • 保持目录与某段时间的相关性,例如节假日促销期间
  • 提前创建虚拟货币和虚拟货币套餐但不在目录中显示
  • 通过在商品旁边显示计时器,激励用户购买虚拟货币和虚拟货币套餐
注:
使用建站器创建目录界面时,会自动显示计时器。在自己的界面中创建目录时,需实现计时器的显示。

适用对象

适用于希望通过在游戏中添加虚拟货币并通过它销售虚拟物品以建立游戏经济或获得营收的合作伙伴。

如何获取

可通过以下方式之一设置虚拟货币:

在发布商帐户中设置虚拟货币

通过API调用设置虚拟货币

请使用虚拟物品和货币API端点管理子部分下的API调用。

本文对您的有帮助吗?
谢谢!
我们还有其他可改进之处吗? 留言
非常抱歉
请说明为何本文没有帮助到您。 留言
感谢您的反馈!
我们会查看您的留言并运用它改进用户体验。
上次更新时间: 2025年9月19日

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

报告问题
我们非常重视内容质量。您的反馈将帮助我们做得更好。
请留下邮箱以便我们后续跟进
感谢您的反馈!
无法发送您的反馈
请稍后重试或发送邮件至doc_feedback@xsolla.com与我们联系。