使用 Payments Apps API 处理 B2B 结账的支付应用应放宽地址校验，否则可能拦截缺少 family_name 的合法支付会话请求。
Ecomwith Editorial电商情报编辑部
已核验事实
Shopify 官方开发者更新说明，B2B 结账中的买家姓氏可选；B2B 支付会话请求的 shipping_address 和 billing_address 可以缺少 family_name。
此次文档更新将 Payments Apps API 请求参考中的 family_name 标记为 B2B 场景下的可选字段，以匹配现有行为。
受影响的是使用 Payments Apps API 处理 B2B 结账、并始终要求 shipping_address.family_name 或 billing_address.family_name 存在的支付应用；已经接受缺少该字段请求的应用无需调整。
该变化适用于全球市场中的相关 B2B 支付应用，不等于所有结账类型或所有地址字段都可以取消校验。
经营影响
对接层若把买家姓氏当作 B2B 支付请求的硬性条件，可能在支付应用处理前拒绝 Shopify 已接受的请求。
变化集中在支付应用的请求验证逻辑，普通商家只有在使用受影响的 Payments
编辑观察
这是一个兼容性修正，而不是支付流程或 B2B 结账规则的全面重构；核心调整是让应用验证逻辑接受 B2B 请求中缺少 family_name 的情况。
最需要优先排查的是自定义地址校验、请求序列化和异常处理链路，而不是订单页面或商品目录配置。
对非 B2B 订单不应据此放宽姓氏要求；应用应继续按订单类型区分校验规则。
适用范围
使用第三方或自建 Payments Apps API 支付集成的 B2B 商家，可能因应用仍强制要求姓氏而遇到支付会话失败或结账中断。
若支付应用已允许 B2B 地址缺少 family_name，商家通常无需因本次更新修改店铺配置，但仍应确认现有流程能够处理有姓氏和无姓氏两种请求。
行动建议
检查 B2B 订单处理中 shipping_address.family_name 和 billing_address.family_name 的必填规则，重点查看是否存在无条件拒绝缺失字段的验证。
在集成测试或受控环境中分别验证 B2B 请求带有和缺少 family_name 时的请求校验、支付会话创建与错误处理；不要扩大到非 B2B 订单。
保留并核对 Shopify 官方更新记录 event:d59223484bde0620283556e2 与证据 evidence:d59223484bde0620283556e2；若应用已兼容缺失字段，可继续观察异常率而不改动配置。
来源与依据
B2B checkout treats the buyer’s surname as optional, so payment session requests for B2B orders can omit family_name in shipping_address and billing_address. This affects payments apps that handle B2B orders through the Payments Apps API and currently require family_name in these addresses. What changed B2B checkout doesn’t require a buyer surname, and the Payments Apps API already accepts payment session requests for B2B orders without family_name in the shipping_address or billing_address. The Payments app request reference now documents family_name as optional for B2B orders to match this behavior. Who's affected Payments apps that use the Payments Apps API to process B2B checkouts and validate that shipping_address.family_name or billing_address.family_name is always present are affected. Payments apps that already accept requests without family_name for B2B orders don’t need to change anything. What to do If your app currently requires family_name in the shipping_address or billing_address for B2B orders, update your validation so it accepts payment session requests where that field is absent for B2B checkouts. Confirm that your app still behaves as expected when family_name i
Shopify Developer Changelog · single-source · 72%
核验时间: 2026年9月15日 18:07 UTC
Claim is bounded to the ingested title or summary; no source body or quotation is retained.