自 UCP 2026-08-25 版本起，Shopify 店面在新增的 /buy 路由上现已支持 UCP dev.ucp.shopping.permalink 功能。您可以使用单个 /buy 链接将商品加入购物车、预填结账详情并引导买家进入结账页面，且在任何支持 UCP 的商店中均可使用相同的链接格式。您无需更改现有集成即可保持其正常运行。
变更内容
商店现在会在其位于 /.well-known/ucp 的 UCP 发现配置文件中列出 dev.ucp.shopping.permalink 功能，且其 config.endpoint 指向该商店的 /buy 路由。
/buy 链接将路径中的商品编码为 token:quantity 对，并使用以其 UCP 字段路径命名的查询参数设置其他购物车和结账字段，例如 buyer/email 或 discounts/codes/0。
使用 /buy 链接，您可以：
- 按变体 ID 添加一个或多个商品
- 预填买家详细信息，例如电子邮件地址
- 设置买家的国家和语言
- 应用折扣码
- 指定对 Shop Pay 的偏好
- 通过 continue_to 参数将买家引导至商店的特定页面。
如果链接无法应用，当存在 continue_to 目的地时，Shopify 会将买家重定向至该目的地，否则重定向至商店的店面，而不是显示错误页面。
现有的 /cart 永久链接仍可正常工作，尽管它们现在是旧版格式。Shopify 将继续支持这些链接，但新功能仅适用于 /buy。/buy 目前尚不支持销售计划、行项目属性、购物车备注或购物车属性，因此如果您需要这些功能，请继续使用 /cart。
操作步骤
请使用 /buy 创建新链接，并在可能的情况下将现有的 /cart 链接迁移至 /buy。新功能仅适用于 /buy，且相同的链接格式适用于任何支持 UCP 的业务。您的 /cart 链接仍可正常工作，因此您可以按自己的时间表进行迁移。如果您依赖销售计划、行项目属性、购物车备注或购物车属性，请暂时继续使用 /cart。
永久链接不使用能力协商，因此您无需在代理配置文件中声明 dev.ucp.shopping.permalink。要构建链接，请从商店的发现配置文件中读取 config.endpoint，而不是自行构造 /buy URL。
切勿在链接中放入支付凭证或访问令牌，并避免在广泛分享的链接中包含买家个人详细信息。
相关文档
- 购物车和结账永久链接
- UCP 永久链接 规范