商品购买数量限制
运行机制
您可以为每位用户设置购买数量限制，并配置这些限制的定期重置。
配置数量限制适用于以下场景：
- 游戏内商品的销售 — 虚拟物品、虚拟货币套餐和捆绑包
- 通过游戏密钥销售游戏和DLC
启用周期性数量限制重置可以：
- 便于重复购买
- 在多发布平台销售商品时与您的系统同步数据
注：
艾克索拉会执行限制条件并阻止用户购买超过设定限制数的物品。
- 当支付UI打开且商品已付款后，所有包含该商品的未支付订单将自动失效。
- 示例：用户可能在完成购买前，通过多个浏览器标签页或不同浏览器打开了限量商品的支付表单，这会为同一商品创建多个订单。一旦在某个标签页完成购买，艾克索拉会自动取消该商品的所有未支付订单。
- 当退款或订单取消时，限制数不会自动重置。您可以使用以下API调用手动重置：刷新指定用户的所有购买限制和刷新指定用户的所有促销活动限制。
- 示例：用户购买有购买数量限制的商品并在游戏中使用后，可能会申请退款。若数量限制自动重置，用户就能再次购买该商品并使用，如此循环往复，实际上绕过了原本设定的数量限制。为防止这种情况，当发生退款或订单取消时，系统不会自动重置数量限制。
配置和更新限制数
在发布商帐户中配置和更新
注：
- 在发布商帐户中打开您的项目，前往商品目录 > 全部商品 > 虚拟物品部分。
- 单击添加并选择虚拟物品。
- 指定以下参数：
- 图片
- SKU
- 物品所属的一个或多个组
- 名称
- 描述
- 价格
注：
不能创建未指定真实货币或虚拟货币价格的物品。不能创建价格为0的物品。如有需要，可配置区域价格。
- 要限制用户可购买物品的次数，将限制单个用户可购买此物品的次数开关设为开并设定限制数。
- 要设置限制刷新频率：
- 从下拉菜单选择周期：
- 每天
- 每周
- 每月
- 自定义间隔。间隔计算从商品在商店的显示期开始日期起算。
- 不刷新
- 从下拉菜单选择周期：
- 设置与周期对应的参数来确定更新刷新安排。
- 要为商品目录中的商品设置显示期限，请选择限时，指定时区、开始日期和结束日期。若要使商品无限期可购，选择无结束日期。
- 单击创建物品。
要配置或更新现有商品的数量限制：
- 在发布商帐户中打开您的项目，前往商品目录 > 全部商品 > 虚拟物品部分。
- 打开包含该商品的组。
- 在商品所在行，单击•••并从下拉列表中选择编辑。
- 在单个用户的限制部分，设置限制数量和/或选择限制重置频率，然后指定时间和时区。
- 单击保存更改。
注：
您可以在商品目录 > 全部商品 > 游戏密钥部分设置每位用户可获取的游戏密钥数量限制。
要配置游戏密钥的限制重置频率，请使用相应的API调用。
通过API调用设置和更新
要设置每日、每周或每月数量限制，请在以下API调用中传递recurrent_schedule数组：
| 功能 | API调用 |
|---|---|
| 刷新指定商品对全部或指定用户的数量限制。 | 刷新购买限制。 |
| 清除指定用户的所有商品数量限制。 | 刷新指定用户的所有购买限制。 |
| 更改指定用户对指定商品的购买数量限制。 | 设置指定用户可购的商品数量。 |
| 获取为指定用户配置的指定商品的数量限制信息。 | 获取指定用户可购的商品数量。 |
| 增加指定用户可购买的商品数量。 | 增加指定用户可购的商品数量。 |
| 减少指定用户可购买的商品数量。 | 减少指定用户可购的商品数量。 |
在商品目录中显示限制数
商品销售数量限制在目录中的显示方式取决于实现方式，即通过建站器还是通过API实现。
通过建站器显示
使用建站器时，限制会自动显示 — 商品卡片上会显示用户可购的商品数量计数。
注：
为更好地吸引用户注意促销商品，推荐使用精选商品卡片样式。
通过API获取数量限制信息
如果目录是通过API实现的，数量限制信息会在以下与目录相关的API调用中的items.limits数组中返回：
can_be_bought = false。
您可以随时根据需要调整这些数量限制。
这些数据可用于在目录中展示限制数，例如，显示用户可购买的最大商品数。本文对您的有帮助吗？
感谢您的反馈！
我们会查看您的留言并运用它改进用户体验。有用链接
上次更新时间: 2026年2月13日发现了错别字或其他内容错误？ 请选择文本，然后按Ctrl+Enter。
