从 UCP 2026-08-25 开始,Checkout MCP 和 Cart MCP 现在支持 UCP 买家同意扩展(dev.ucp.shopping.buyer_consent)。买家现在可以在您的代理中做出与在商店自有结账流程中相同的隐私和营销选择,例如选择加入电子邮件或短信通知。商店会在购物车、结账和订单中接收这些选择。
变更内容
storefronts 现在在其发现资料中的 /.well-known/ucp 列出 dev.ucp.shopping.buyer_consent。此扩展适用于购物车和结账。
如果您的代理资料在 UCP 2026-08-25 上协商了 dev.ucp.shopping.buyer_consent:
- Checkout MCP 和 Cart MCP 响应中包含一个 buyer.consent 对象。
- buyer.consent 列出商店支持的每项同意目的、其当前状态、描述以及链接到商店的政策。
Shopify 店面至少会声明以下同意目的:
- dev.ucp.consent.analytics
- dev.ucp.consent.preferences
- dev.ucp.consent.sale_or_sharing
- dev.ucp.consent.marketing,包含 email 和 sms 部分
您可以在创建、更新或完成购物车或结账流程时发送买家的同意选择。如果您未发送同意信息,Shopify 将根据买家所在国家/地区的默认设置应用商店的默认配置。如果买家所在国家/地区未知,则默认为拒绝(opt-out)。
某些选择需要联系方式,例如在没有电话号码的情况下选择加入短信通知。在这种情况下,响应会包含一个 missing_consent_data 警告,并且在您提供缺失的联系方式之前,结账无法完成。
受影响对象
使用 Checkout MCP 或 Cart MCP 并与 UCP 2026-08-25 协商 dev.ucp.shopping.buyer_consent 扩展的平台和代理受到影响。
未声明此扩展程序或与 UCP 协商使用更早版本的集成不受影响。
为何重要
此项更改使您的代理能够在购物车和结账期间展示准确且与商店相关的同意选项,记录买家的明确选择,并在未提供同意信息时尊重商店的默认规则。这减少了针对区域默认设置的自定义逻辑,并帮助商家满足其同意和通信要求。
操作指南
- 在您的代理资料中以版本 2026-08-25 声明 dev.ucp.shopping.buyer_consent 扩展。
- 当渲染购物车或结账时,使用来自 buyer.consent 的商店描述和政策链接向买家展示每个同意选项。
- 当买家做出选择时,在购物车和结账的创建、更新或完成调用中将选择结果返回,并且仅针对您在流程中实际做出的选择设置 source: "platform"。
- 如果您收到 missing_consent_data 警告,请从买家处收集所需的联系方式并重试,以便结账可以完成。
相关文档
- 了解面向代理的 Carts and Checkout MCP
- 配置代理配置文件和 UCP 协商
- 查看 UCP 买家同意 规范

