Shopify 结账验证是应用安装到你店铺的一个 Shopify Function,来自 Cart and Checkout Validation API。 每当购物车或结账发生变化,Shopify 就会在自己的服务器上运行它。如果 Function 返回错误,结账页面会显示该消息,买家在解决问题前无法完成下单。只要来自公开应用,它在任何 Shopify 套餐上都能运行,覆盖普通结账、Shop Pay 和 Apple Pay 等快捷按钮、headless 结账以及草稿订单。它不在 POS、订阅续订、订单编辑或通过 API 创建的订单上运行。它可以拦截订单,但不能修改购物车,也不能预留库存。
最后核实:2026 年 10 月 8 日,依据 Shopify 开发者文档和帮助中心。来源列在文末。
声明:OrderRules 是一款结账验证应用。本指南先讲解 Shopify 平台本身,再说明我们如何使用它。

什么是验证 Function
Shopify Functions 允许应用把自己的逻辑加入 Shopify 后端。每个 Function API 负责一件事:折扣、配送选项、付款方式等等。验证就是决定一个购物车能否结账的那一个。
它的工作方式如下:
- 由应用提供 Function。 它被编译为 WebAssembly,随应用一起部署。你只需安装应用,不用碰代码。
- 由 Shopify 运行,而不是你的主题。 Function 在 Shopify 的基础设施内运行,而不是在购物者的浏览器里。关闭 JavaScript 或修改页面都无法跳过它。
- 读取输入,返回错误。 Shopify 传入购物车及相关数据。Function 返回一个错误列表,每个错误包含一条消息和一个目标(整个购物车,或某个特定字段)。
- 结账显示消息。 列表为空:结账继续。有任何错误:Shopify 显示消息,并在买家做出修改前阻止完成订单。
Shopify 会在买家旅程的多个节点运行该 Function:购物车交互、结账交互和结账完成时。Function 可以判断当前处于哪一步,并选择只在结账时拦截,这样加入购物车就永远不会失败。
Shopify 要求 Functions 小而快。每次运行对指令数和输入大小都有严格限制,所以逻辑必须简单,数据必须精简。
下面是当前目标 cart.validations.generate.run 的一个简化 JavaScript 示例。仅作说明,并非 OrderRules 的代码:
// Simplified example, not production code.
// Input comes from a GraphQL input query (cart lines, buyer identity, metafields).
export function cartValidationsGenerateRun(input) {
const limits = input.shop.limits?.jsonValue ?? {}; // written by the app ahead of time
const errors = [];
for (const line of input.cart.lines) {
const productId = line.merchandise.product?.id;
const remaining = limits[productId];
if (remaining !== undefined && line.quantity > remaining) {
errors.push({
message: `Only ${remaining} left for today. Lower the quantity to continue.`,
target: "$.cart",
});
}
}
return { operations: [{ validationAdd: { errors } }] };
}
注意缺了什么:没有数据库查询,没有 API 调用,没有“统计今天的订单”。Function 只能看到输入中的内容。下文的一切都由此决定。
在哪里运行,在哪里不运行
Shopify 在文档中说明了哪些场景会运行验证 Function。下表依据 Cart and Checkout Validation API 参考文档整理。
| 场景 | 是否运行验证? | 说明 |
|---|---|---|
| 在线商店购物车和结账 | 是 | 购物车和结账分别列出;两者都支持 |
| Shop Pay、Apple Pay、Google Pay、PayPal 快捷支付、Buy it now | 是 | 列为 Storefront Accelerated Checkout |
| Headless 店面(Storefront API) | 是 | 包括 Hydrogen 和自定义前端 |
| B2B 结账 | 是 | 公司买家接受同样的验证 |
| 草稿订单(后台和发票结账) | 是 | 列为 Draft Order (Admin and Checkout) 和 Shopify Admin |
| Shopify POS | 否 | 门店销售不经过验证 |
| 订阅续订订单 | 否 | 只有首次订阅结账会被验证 |
| 订单编辑 | 否 | 购买后编辑订单会跳过验证 |
| Create Order API | 否 | 由其他应用或集成创建的订单 |
| 预售和先试后买 | 否 | 不支持延迟购买选项 |
所以“无法绕过”的说法并不准确。购物者无法从在线商店或快捷按钮跳过验证。但来自 POS、续订、编辑或 API 的订单根本不会经过它。如果你依赖某项限制,请确认你的店铺用到了哪些渠道。
Function 能看到什么
Function 声明一个用 GraphQL 编写的 输入查询,Shopify 在每次运行时填充它。常用字段包括:
- 购物车行: 数量、变体、商品、重量、行属性。
- 买家身份: 买家是否已登录;对于客户,还有订单数和消费金额等字段。
- 元字段: 店铺、商品、变体和客户上的元字段。
- 购物车属性: 例如在购物车页面选择的配送日期。
- 买家旅程所处步骤: 购物车交互、结账交互或结账完成。
在公开应用中它不能做的事:访问网络。它无法在结账时询问应用的服务器“今天有多少订单?”。取而代之的是,应用在别处完成计数。它监听 Shopify 的订单通知,更新总数,并写入元字段。Function 在下一次运行时读取这些元字段。
这就是为什么 Function 中的计数是 快照。它们的新鲜程度取决于最后一次元字段写入,而不是实时数据。
它能做什么,不能做什么
它可以用一条消息拦截。 这就是它全部的输出。消息可以针对整个购物车或某个特定的结账字段,应用也可以让你自己撰写措辞。
它不能修改数量。 验证 Function 无法降低数量、移除某一行或修改价格。旧的 Shopify Scripts 可以悄悄修改购物车;验证不行。买家阅读消息后自己调整购物车。其他 Function API(如 Cart Transform 或折扣)负责修改购物车,但它们不会阻止结账。
它不能预留库存或名额。 Function 读取一份快照,然后回答是或否。它不会锁定任何东西。如果两位买家几乎同时为最后一件商品、或某个配送时间段的最后一个名额结账,两人都可能读到“剩余 1”,并且都能通过。验证能让限制在正常流量下可靠生效,但不能保证你永远不会超出。
每个店铺最多 25 个验证 Function。 Shopify 限制了可同时启用的验证 Function 数量。多个应用可以各自添加一个,它们都会运行;其中任意一个返回错误,就会阻止结账。
套餐
- 带 Functions 的 App Store 公开应用在所有 Shopify 套餐上都能用。 安装验证应用不需要 Plus。
- 带 Functions 的自定义应用需要 Shopify Plus。 这适用于自建私有 Function 的店铺。
- Shopify Scripts 已经退出。 Scripts 于 2026 年 6 月 30 日停止运行。很多数量限制过去写在行项目脚本里。如果你的也是,请参见 用 Functions 替代 Shopify Scripts 实现数量和结账规则。
主题 JavaScript 与验证对比
许多限制工具运行在主题中:隐藏按钮、限制数量输入框,或在购物车页面显示警告。这对提前展示限制很有用,但它不是强制执行。
| 主题或购物车页面 JavaScript | 验证 Function | |
|---|---|---|
| 普通在线商店结账 | 仅当买家经过购物车页面且开启了 JavaScript | 是 |
| 商品页面上的 Shop Pay、Apple Pay、Google Pay 按钮 | 否,它们会跳过购物车页面 | 是 |
| 直接结账链接 | 否 | 是 |
| Headless 店面 | 否,没有主题 | 是 |
| 草稿订单 | 否 | 是 |
| POS | 否 | 否 |
| 订阅续订、订单编辑、API 订单 | 否 | 否 |
| 能在结账前展示限制 | 是 | 否,只在检查购物车时显示消息 |
| 关闭 JavaScript 即可跳过 | 是 | 否 |
两者都覆盖不了 POS 或续订。最好的方案是两者并用:用店面提示让购物者提前看到限制,用验证 Function 在结账时做最后的硬性拦截。
配送日期也是同样的道理。日期选择器会在浏览器中把已满或休息的日期置灰,但快捷按钮和直接结账链接会跳过日历所在的页面。只有验证 Function 会在结账时重新检查所选日期。参见 Shopify 配送日期选择器应用的结账验证对比。
OrderRules 如何使用它
OrderRules 会安装一个验证 Function。你在应用中设置规则;应用负责计数并写入元字段;Function 在结账时读取它们,拦截违反规则的订单。它检查:
- 营业时间和节假日: 在营业时间之外关闭结账。
- 订单上限: 全店每日上限,付费套餐还有每周和每月上限。
- 商品、变体和商品系列上限: 所有购物者共享的总量。
- 最小起订量和步进数量: 按商品或变体、按订单计算。
- 按客户限制: 针对已登录客户,按周期限制订单数、件数、消费金额或重量。
- 配送日期和自提时间段(Advanced 套餐):截单时间、不可选日期以及每个时间段的上限。
每种规则类型的提示消息都可以在设置中编辑。在上表中所有运行验证的场景,规则都会被检查。POS 订单和续订不会被拦截,但仍会计入你的限制。计数是快照,所以两个几乎同时争夺最后一个名额的结账可能都会通过。
结账强制执行包含在所有套餐中,包括免费的 Starter 套餐。完整说明:OrderRules 规则在哪里检查:兼容性与限制。
延伸阅读
- 如何在 Shopify 上设置订单限制
- 防止超卖:产能受限店铺的应对策略
- 按客户订单限制指南
- 动态店面提示
- 最佳 Shopify 配送日期选择器应用:结账验证对比
- Shopify 配送日期校验:检查项目与顾客看到的提示
- Shopify 原生订单限制 vs 应用(2026)
- OrderRules 规则在哪里检查:兼容性与限制
- 用 Functions 替代 Shopify Scripts 实现数量和结账规则
来源
- Shopify.dev:Cart and Checkout Validation Function API(目标、支持与不支持的场景、每店上限)
- Shopify.dev:构建购物车和结账验证 Function
- Shopify.dev:Shopify Functions(公开应用与自定义应用的套餐可用性)
- Shopify.dev 更新日志:Shopify Scripts 将于 2026 年 6 月 30 日弃用
- Shopify 帮助中心:从 Scripts 过渡到 Functions
在你的店铺试用
从 Shopify App Store 安装 OrderRules。所有套餐都包含结账验证,付费套餐提供 14 天免费试用。