> ## Documentation Index
> Fetch the complete documentation index at: https://learn.orbexa.io/llms.txt
> Use this file to discover all available pages before exploring further.

# UCP 通用商务协议

> UCP通用商务协议完整技术指南，由Google、Shopify、Etsy、Wayfair等六大行业巨头联合发起的Apache 2.0开源标准协议，定义AI代理与商家之间的标准化交互语言，涵盖商品发现、结账管理、身份关联、订单追踪与支付令牌交换的完整商务生命周期，助力构建下一代AI驱动的智能电商生态系统

# UCP — 通用商务协议

> "The common language for platforms, agents and businesses."

## 什么是UCP

UCP（Universal Commerce Protocol，通用商务协议）是由 **Google、Shopify、Etsy、Wayfair、Target、Walmart** 六家行业巨头联合开发的开放协议。它定义了AI代理与商家之间的标准化交互语言，涵盖商品发现、结账管理、身份关联、订单追踪和支付令牌交换的完整商务生命周期。

**官方规范**: [ucp.dev](https://ucp.dev) | **GitHub**: [Universal-Commerce-Protocol/ucp](https://github.com/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代理发现你的能力 |

## 章节目录

1. [UCP核心概念](/zh/book-3/ch1-core-concepts) — 协议架构、命名空间、能力协商算法、UCP Profile
2. [结账API](/zh/book-3/ch2-checkout) — 6个状态、5种操作、嵌入式UI、ISO 4217金额处理
3. [身份关联](/zh/book-3/ch3-identity) — OAuth 2.0 Authorization Code、令牌撤销、scope管理
4. [订单管理](/zh/book-3/ch4-orders) — 行项目状态、履约事件、调整操作、Webhook签名
5. [商品数据与传输](/zh/book-3/ch5-product-data) — MCP工具、REST/A2A/Embedded四种传输、数据格式
6. [安全与认证](/zh/book-3/ch6-security) — RFC 9421签名、JWK密钥、mTLS、Content-Digest
7. [商家集成指南](/zh/book-3/ch7-merchant-integration) — `/.well-known/ucp` Profile部署、能力声明
8. [平台集成指南](/zh/book-3/ch8-platform-integration) — 能力协商算法、扩展机制、多平台方案
9. [测试与验证](/zh/book-3/ch9-testing) — Profile验证、结账流程测试、安全合规检查
10. [实战案例与扩展](/zh/book-3/ch10-case-studies) — Buyer Consent、AP2 Mandate扩展、集成路径

### AI提示词：UCP接入规划

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

```text theme={null}
请帮我了解和规划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. 预估工作量
```

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