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