UCP — 通用商务协议

“The common language for platforms, agents and businesses.”

什么是UCP

UCP（Universal Commerce Protocol，通用商务协议）是由 Google、Shopify、Etsy、Wayfair、Target、Walmart 六家行业巨头联合开发的开放协议。它定义了AI代理与商家之间的标准化交互语言，涵盖商品发现、结账管理、身份关联、订单追踪和支付令牌交换的完整商务生命周期。 官方规范: ucp.dev | GitHub: Universal-Commerce-Protocol/ucp (2.6k stars) | 许可证: Apache 2.0 最新规范版本: 2026-04-08（基于日期的版本号策略）

生态系统

UCP拥有 30+生态合作伙伴，覆盖支付、金融、零售全产业链：

领域	合作伙伴
支付处理	Adyen, Block (Square), PayPal, Stripe
先买后付	Affirm, Klarna
卡组织/金融	American Express, Visa, Ant International
零售商	Best Buy, Target, Walmart
电商平台	Shopify, Etsy, Wayfair

UCP的设计原则

原则	含义
商家中心	商家保持对业务规则的完整控制权，商家始终是记录商户(Merchant of Record)
界面无关	支持对话（chat）、视觉（visual）、语音（voice）等多种交互方式
开放互操作	兼容OAuth 2.0、AP2支付协议、A2A代理间通信、MCP工具协议等现有标准
命名空间治理	反向域名命名（`dev.ucp.` 由UCP官方管理，`com.vendor.` 由供应商管理）

UCP的四大能力（Capabilities）

UCP定义了四大核心能力，每个能力使用反向域名命名空间标识：

1. 结账管理 (Checkout)

命名空间: dev.ucp.shopping.checkout AI代理可以创建结账会话，管理购物车、配送方式、支付信息。结账会话有6个标准状态（incomplete, requires_escalation, ready_for_complete, complete_in_progress, completed, canceled），支持5种操作（Create/Get/Update/Complete/Cancel）。所有金额使用ISO 4217最小货币单位。

2. 身份关联 (Identity Linking)

命名空间: dev.ucp.common.identity_linking 基于OAuth 2.0 Authorization Code流程，通过 /.well-known/oauth-authorization-server 发现授权服务器。支持令牌撤销（RFC 7009）。

3. 订单管理 (Order Management)

命名空间: dev.ucp.shopping.order 追踪行项目状态（processing/partial/fulfilled/removed）、履约事件（processing/shipped/in_transit/delivered等）。支持退款、退货、信用等调整操作。Webhook使用RFC 9421签名确保安全。

4. 支付令牌交换 (Payment Token Exchange)

三步生命周期：协商（Negotiation）、获取（Acquisition）、完成（Completion）。支付处理器使用反向DNS命名，凭证流向为单向：平台到商家。

传输机制

UCP支持四种传输方式，适应不同集成场景：

传输方式	Schema格式	适用场景
REST	OpenAPI 3.x	服务端到服务端集成
MCP	OpenRPC (JSON-RPC 2.0)	AI工具连接（提供 `search_catalog`、`lookup_catalog`、`get_product` 等工具）
A2A	Agent Card Specification	AI代理间协作
Embedded	OpenRPC schema	嵌入式UI场景

UCP与其他协议的关系

协议	作用	与UCP的关系
ACP (OpenAI/Stripe)	AI代理下单支付	UCP覆盖更广（发现+结账+订单+支付令牌），ACP侧重ChatGPT生态
MCP (Anthropic)	AI连接外部工具	UCP可以通过MCP传输方式暴露商务能力（OpenRPC schema）
OAuth 2.0	身份认证	UCP使用OAuth 2.0 Authorization Code作为身份关联标准
A2A (Google)	代理间通信	UCP通过A2A传输实现多代理协作
RFC 9421	HTTP消息签名	UCP的Webhook和认证使用此标准

谁需要关注UCP

角色	为什么关注
Shopify商家	Shopify是UCP的共同发起者，预计将原生支持
平台开发者	接入UCP可以让你的平台对接所有UCP兼容的AI代理
AI应用开发者	实现UCP客户端可以对接所有UCP商家，MCP传输方式可直接对接
支付服务商	支付令牌交换能力定义了标准化的代理支付流程
独立站商家	部署 `/.well-known/ucp` Profile即可让AI代理发现你的能力

章节目录

UCP核心概念 — 协议架构、命名空间、能力协商算法、UCP Profile
结账API — 6个状态、5种操作、嵌入式UI、ISO 4217金额处理
身份关联 — OAuth 2.0 Authorization Code、令牌撤销、scope管理
订单管理 — 行项目状态、履约事件、调整操作、Webhook签名
商品数据与传输 — MCP工具、REST/A2A/Embedded四种传输、数据格式
安全与认证 — RFC 9421签名、JWK密钥、mTLS、Content-Digest
商家集成指南 — /.well-known/ucp Profile部署、能力声明
平台集成指南 — 能力协商算法、扩展机制、多平台方案
测试与验证 — Profile验证、结账流程测试、安全合规检查
实战案例与扩展 — Buyer Consent、AP2 Mandate扩展、集成路径

AI提示词：UCP接入规划

如果你想让AI助手帮你制定UCP接入计划：

请帮我了解和规划UCP（Universal Commerce Protocol）接入。

准备工作：
1. 请阅读UCP官方文档：https://ucp.dev
2. 查看UCP的GitHub仓库：Universal-Commerce-Protocol/ucp

我的情况：
- 平台：【Shopify/WooCommerce/自建站】
- 技术栈：【你的技术栈】
- 商品数量：【数量】
- 需要的能力：【商品发现/结账/身份关联/订单管理/支付令牌】

请输出：
1. UCP的核心概念总结（用通俗语言）
2. /.well-known/ucp Profile的配置方案
3. 需要实现的能力端点清单
4. 分阶段的接入计划
5. 安全要求（签名密钥、认证方式）
6. 预估工作量

UCP是一个快速发展的协议，最新规范版本为2026-04-08。本章内容基于该版本的官方文档。请始终以 ucp.dev 的最新版本为准。GitHub仓库: Universal-Commerce-Protocol/ucp

OTR协议完整技术参考手册 UCP协议架构与核心概念详解

开始

学习路径

AI代理商务入门

OTR 开放信任协议