商品购买数量限制

运行机制

您可以为每位用户设置购买数量限制,并配置这些限制的定期重置。

配置数量限制适用于以下场景:

  • 游戏内商品的销售 — 虚拟物品、虚拟货币套餐和捆绑包
  • 通过游戏密钥销售游戏和DLC

启用周期性数量限制重置可以:

  • 便于重复购买
  • 在多发布平台销售商品时与您的系统同步数据
要正确显示用户可购买的数量,必须配置身份认证。 未认证用户只能看到可购买商品的最大数量。若要显示应用限制后用户的剩余可购商品数量,请在以下请求中包含用户授权数据:
注:

艾克索拉会执行限制条件并阻止用户购买超过设定限制数的物品。

  • 当支付UI打开且商品已付款后,所有包含该商品的未支付订单将自动失效。
  1. 示例:用户可能在完成购买前,通过多个浏览器标签页或不同浏览器打开了限量商品的支付表单,这会为同一商品创建多个订单。一旦在某个标签页完成购买,艾克索拉会自动取消该商品的所有未支付订单。
  1. 示例:用户购买有购买数量限制的商品并在游戏中使用后,可能会申请退款。若数量限制自动重置,用户就能再次购买该商品并使用,如此循环往复,实际上绕过了原本设定的数量限制。为防止这种情况,当发生退款或订单取消时,系统不会自动重置数量限制。
如需配置促销活动使用次数限制,请参阅相关说明

配置和更新限制数

在发布商帐户中配置和更新

注:
  • 以下配置流程以虚拟物品为例。
  • 配置虚拟物品前,建议先创建分组。分组有助于构建多级目录并管理商品在商店中的显示方式。
  • 在发布商帐户中,您可以为所有用户更新指定商品的数量限制。更高级的配置选项可通过API调用实现。
要创建购买次数有限的商品:
  1. 在发布商帐户中打开您的项目,前往商品目录 > 全部商品 > 虚拟物品部分。
  2. 单击添加并选择虚拟物品
  1. 指定以下参数:
    • 图片
    • SKU
    • 物品所属的一个或多个组
    • 名称
    • 描述
    • 价格
注:
不能创建未指定真实货币或虚拟货币价格的物品。不能创建价格为0的物品。如有需要,可配置区域价格
  1. 要限制用户可购买物品的次数,将限制单个用户可购买此物品的次数开关设为并设定限制数。
  2. 要设置限制刷新频率:
    1. 从下拉菜单选择周期:
      • 每天
      • 每周
      • 每月
      • 自定义间隔。间隔计算从商品在商店的显示期开始日期起算。
      • 不刷新
    1. 设置与周期对应的参数来确定更新刷新安排。
  1. 要为商品目录中的商品设置显示期限,请选择限时,指定时区、开始日期和结束日期。若要使商品无限期可购,选择无结束日期
  2. 单击创建物品

要配置或更新现有商品的数量限制:

  1. 在发布商帐户中打开您的项目,前往商品目录 > 全部商品 > 虚拟物品部分。
  2. 打开包含该商品的组。
  3. 在商品所在行,单击•••并从下拉列表中选择编辑
  4. 单个用户的限制部分,设置限制数量和/或选择限制重置频率,然后指定时间和时区。
  5. 单击保存更改
注:
您可以在商品目录 > 全部商品 > 游戏密钥部分设置每位用户可获取的游戏密钥数量限制。 要配置游戏密钥的限制重置频率,请使用相应的API调用

通过API调用设置和更新

要设置每日、每周或每月数量限制,请在以下API调用中传递recurrent_schedule数组:

要更新和管理限制,请使用限制部分的API调用:
功能API调用
刷新指定商品对全部或指定用户的数量限制。刷新购买限制
清除指定用户的所有商品数量限制。刷新指定用户的所有购买限制
更改指定用户对指定商品的购买数量限制。设置指定用户可购的商品数量
获取为指定用户配置的指定商品的数量限制信息。获取指定用户可购的商品数量
增加指定用户可购买的商品数量。增加指定用户可购的商品数量
减少指定用户可购买的商品数量。减少指定用户可购的商品数量

在商品目录中显示限制数

商品销售数量限制在目录中的显示方式取决于实现方式,即通过建站器还是通过API实现。

通过建站器显示

使用建站器时,限制会自动显示 — 商品卡片上会显示用户可购的商品数量计数。

promo-limits-sb
注:
为更好地吸引用户注意促销商品,推荐使用精选商品卡片样式

通过API获取数量限制信息

如果目录是通过API实现的,数量限制信息会在以下与目录相关的API调用中的items.limits数组中返回:

用户已达购买数量限制的商品会返回can_be_bought = false。 您可以随时根据需要调整这些数量限制。 这些数据可用于在目录中展示限制数,例如,显示用户可购买的最大商品数。
本文对您的有帮助吗?
谢谢!
我们还有其他可改进之处吗? 留言
非常抱歉
请说明为何本文没有帮助到您。 留言
感谢您的反馈!
我们会查看您的留言并运用它改进用户体验。
上次更新时间: 2026年2月13日

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

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