> ## 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.

# ACP 代理商务协议

> ACP代理商务协议技术指南，由Stripe创建的AI代理商务开放标准。涵盖Product Feed商品数据同步、Agentic Checkout结账集成、Delegate Payment支付委托机制，帮助商家快速接入ChatGPT商务生态并完成合作伙伴申请与上线部署

# ACP — 代理商务协议

> "An open standard for programmatic commerce flows between buyers, AI agents, and businesses."

## 什么是ACP

ACP（Agentic Commerce Protocol，代理商务协议）是由**Stripe创建**的开放标准，定义了买家、AI代理和商家之间程序化商务交互的协议。**OpenAI ChatGPT是ACP的首个实现者**。

ACP不是一个单一API，而是**两套独立的系统**：

| 系统                   | 方向          | 托管方      | 用途       |
| -------------------- | ----------- | -------- | -------- |
| **Product Feed**     | 商家 → OpenAI | OpenAI平台 | 商品数据同步   |
| **Agentic Checkout** | AI代理 → 商家   | 商家自建     | 结账、支付、订单 |

**协议状态**: Beta（合作伙伴审批制）

**规范版本历史**:

* 2025-09-29（初始版本）
* 2025-12-12（履约能力）
* 2026-01-16（能力协商）
* 2026-01-30（扩展、折扣、支付处理器）— 当前最新

**官方资源**:

* 开放规范: [agenticcommerce.dev](https://agenticcommerce.dev)
* OpenAI商家文档: [developers.openai.com/commerce](https://developers.openai.com/commerce)
* GitHub: [github.com/agentic-commerce-protocol](https://github.com/agentic-commerce-protocol/agentic-commerce-protocol)
* 联系: [acp@stripe.com](mailto:acp@stripe.com)

## ACP的两套系统

### 系统1: Product Feed（商品数据同步）

商家将商品目录数据**推送到OpenAI平台**。有两种方式：

| 方式           | 格式                                         | 适用场景     |
| ------------ | ------------------------------------------ | -------- |
| **SFTP文件上传** | Parquet(zstd) / jsonl.gz / csv.gz / tsv.gz | 每日全量快照   |
| **REST API** | JSON                                       | 白天实时增量更新 |

**最佳实践**: 每天SFTP全量同步 + API实时推送变化（价格、库存、促销）。

### 系统2: Agentic Checkout（结账交易）

商家在自己的服务器上**实现5个API端点**，AI代理在用户确认购买时调用这些端点完成交易：

```
POST   /checkout_sessions            创建结账会话
GET    /checkout_sessions/:id        查询会话状态
POST   /checkout_sessions/:id        更新会话（收货地址、买家信息等）
POST   /checkout_sessions/:id/complete  完成支付
POST   /checkout_sessions/:id/cancel    取消会话
```

支付凭证通过**Delegate Payment API**（Stripe托管）安全传递，商家永远不会接触到原始卡号。

## ACP与UCP的对比

| 维度        | ACP                            | UCP                    |
| --------- | ------------------------------ | ---------------------- |
| **创建方**   | Stripe                         | Google联合Shopify等       |
| **首个实现者** | OpenAI ChatGPT                 | 多平台                    |
| **架构**    | 商家推数据 + 商家建端点                  | 商家建API端点               |
| **支付**    | Delegate Payment (vault token) | Payment Token Exchange |
| **当前状态**  | Beta（需申请）                      | 开放                     |
| **覆盖范围**  | 商品发现 + 结账 + 支付                 | 结账 + 身份 + 订单 + 支付      |
| **生态**    | ChatGPT生态                      | 跨平台/跨AI                |

## 商家接入流程

1. **申请合作伙伴资格** — 在 [chatgpt.com/merchants](https://chatgpt.com/merchants) 提交申请
2. **获得审批** — Stripe/OpenAI审核商家资质
3. **配置SFTP** — 设置文件上传通道
4. **准备商品数据** — 按Product对象规范格式化目录
5. **实现Checkout端点** — 在商家服务器上部署5个API端点
6. **集成Delegate Payment** — 接入Stripe的支付委托API
7. **测试和上线** — 小批量验证后全量发布

## 章节目录（8章）

### 第一部分：核心概念

1. [ACP核心概念](/zh/book-4/ch1-core-concepts) — 协议架构、四方模型、数据流
2. [商品数据格式](/zh/book-4/ch2-product-data) — Product/Variant对象、价格（minor units）、媒体、可用性

### 第二部分：数据同步

3. [文件上传集成](/zh/book-4/ch3-file-upload) — SFTP规格、分片策略、Feed Header
4. [REST API集成](/zh/book-4/ch4-api) — Feeds/Products/Promotions端点、认证、幂等性

### 第三部分：交易能力

5. [促销数据管理](/zh/book-4/ch5-promotions) — Promotion对象、折扣类型、生效周期

### 第四部分：质量与运维

6. [数据质量最佳实践](/zh/book-4/ch6-data-quality) — ID稳定性、URL编码、描述格式、禁止内容
7. [测试与验证](/zh/book-4/ch7-testing) — 小批量验证、数据合规检查
8. [常见问题](/zh/book-4/ch8-faq) — 接入过程的常见问题

<Note>
  ACP目前处于Beta阶段，需要申请合作伙伴资格。本章内容基于ACP规范版本2026-01-30和OpenAI Commerce文档。最新接入政策请查看 [agenticcommerce.dev](https://agenticcommerce.dev)。
</Note>