跳至主要内容
技术

Shopify 结账验证的工作原理(以及应用如何用它拦截订单)

Jahangir Alam2026年5月3日2026年10月8日 更新事实核查于 2026年10月8日14 min read
CheckoutShop PayApple PayBuy it nowone checkserver-side

Shopify 结账验证是应用安装到你店铺的一个 Shopify Function,来自 Cart and Checkout Validation API。 每当购物车或结账发生变化,Shopify 就会在自己的服务器上运行它。如果 Function 返回错误,结账页面会显示该消息,买家在解决问题前无法完成下单。只要来自公开应用,它在任何 Shopify 套餐上都能运行,覆盖普通结账、Shop Pay 和 Apple Pay 等快捷按钮、headless 结账以及草稿订单。它不在 POS、订阅续订、订单编辑或通过 API 创建的订单上运行。它可以拦截订单,但不能修改购物车,也不能预留库存。

最后核实:2026 年 10 月 8 日,依据 Shopify 开发者文档和帮助中心。来源列在文末。

声明:OrderRules 是一款结账验证应用。本指南先讲解 Shopify 平台本身,再说明我们如何使用它。

结账验证与购物车脚本类应用在标准结账、Shop Pay、Apple Pay、Google Pay、直接结账链接和 headless 店面上的对比

什么是验证 Function

Shopify Functions 允许应用把自己的逻辑加入 Shopify 后端。每个 Function API 负责一件事:折扣、配送选项、付款方式等等。验证就是决定一个购物车能否结账的那一个。

它的工作方式如下:

  1. 由应用提供 Function。 它被编译为 WebAssembly,随应用一起部署。你只需安装应用,不用碰代码。
  2. 由 Shopify 运行,而不是你的主题。 Function 在 Shopify 的基础设施内运行,而不是在购物者的浏览器里。关闭 JavaScript 或修改页面都无法跳过它。
  3. 读取输入,返回错误。 Shopify 传入购物车及相关数据。Function 返回一个错误列表,每个错误包含一条消息和一个目标(整个购物车,或某个特定字段)。
  4. 结账显示消息。 列表为空:结账继续。有任何错误: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 App Store 安装 OrderRules。所有套餐都包含结账验证,付费套餐提供 14 天免费试用。

常见问题

它是 Shopify Functions 的一个 API,即 Cart and Checkout Validation API。应用会安装一个小型 Function,每当购物车或结账发生变化时,Shopify 就在自己的服务器上运行它。Function 返回一个错误列表。如果列表不为空,Shopify 会显示这些消息,买家在问题解决前无法完成结账。

不需要。任何套餐的店铺都可以使用包含验证 Function 的 App Store 公开应用。只有带 Functions 的自定义应用才需要 Shopify Plus。

会。Shopify 将加速结账列为支持的场景,因此同一个 Function 也会在 Shop Pay、Apple Pay、Google Pay 和 PayPal 快捷按钮上运行。它还会在 headless(Storefront API)结账、B2B 结账和草稿订单上运行。

Shopify 列出的不支持场景包括:POS、订阅续订订单、订单编辑、通过 Create Order API 创建的订单,以及预售或先试后买(try-before-you-buy)购买选项。来自这些渠道的订单不会被验证 Function 拦截。

不能。验证 Function 只能返回错误。它不能修改数量、移除商品或修改价格。买家看到消息后需要自己调整购物车。

单靠它不能。在公开应用中,Function 无法发起网络请求,所以应用通过元字段把计数传进去,Function 读取的是一份快照。它无法预留库存或名额,因此两个几乎同时争夺最后一个名额的结账可能都会通过。

正在挑选应用?

查看 OrderRules 与该类别中其他所有 Shopify 应用的对比。

准备好掌控你的订单了吗?

免费试用 OrderRules