> ## 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代理商务协议接入常见问题解答，涵盖商家合作伙伴申请流程与审核周期、Checkout API端点技术要求与环境配置、Delegate Payment支付安全与PCI合规机制、SFTP与API双通道数据同步方案、ACP与UCP协议兼容性对比及商品运维故障排查

# 常见问题

## 关于ACP协议

### Q: ACP是谁创建的？

**A**: ACP（Agentic Commerce Protocol）由**Stripe**创建，是一套开放标准，定义了AI代理与商家之间的程序化商务交互协议。**OpenAI ChatGPT是ACP的首个实现者**，但ACP被设计为可被任何AI平台采用。

### Q: ACP目前处于什么状态？

**A**: ACP目前处于**Beta阶段**，采用合作伙伴审批制。当前规范版本为 **2026-01-30**（版本历史：2025-09-29 → 2025-12-12 → 2026-01-16 → 2026-01-30）。Beta期间功能和规范可能会调整。

### Q: 如何申请接入ACP？

**A**: 访问 [chatgpt.com/merchants](https://chatgpt.com/merchants) 提交商家合作伙伴申请。Stripe和OpenAI会审核商家资质，审批通过后会提供SFTP凭证和API密钥。

## 技术要求

### Q: 需要实现哪些API端点？

**A**: 商家需要在自己的服务器上实现**5个Checkout Session端点**：

| 端点                                | 方法   | 用途     |
| --------------------------------- | ---- | ------ |
| `/checkout_sessions`              | POST | 创建结账会话 |
| `/checkout_sessions/:id`          | GET  | 查询会话状态 |
| `/checkout_sessions/:id`          | POST | 更新会话信息 |
| `/checkout_sessions/:id/complete` | POST | 完成支付   |
| `/checkout_sessions/:id/cancel`   | POST | 取消会话   |

### Q: 价格格式是什么？

**A**: 使用**ISO 4217 minor units**（最小货币单位）。例如，99.99 USD 表示为 `amount: 9999`（单位：cent）。日元等无小数的货币直接使用整数金额。

### Q: 支持哪些文件格式？

**A**: SFTP文件上传支持以下格式：

| 格式              | 推荐度 |
| --------------- | --- |
| Parquet（zstd压缩） | 推荐  |
| jsonl.gz        | 可选  |
| csv.gz          | 可选  |
| tsv.gz          | 可选  |

所有文件必须使用UTF-8编码。Parquet配合zstd压缩效率最高。

## 数据管理

### Q: 数据多久更新一次？

**A**: 推荐采用**双通道策略**：

* **SFTP全量快照**: 至少每天一次（推荐凌晨执行）
* **REST API增量更新**: 白天实时推送变化（价格、库存、促销）

全量快照提供数据一致性基线，API增量保证时效性。

### Q: 如何下架商品？

**A**: 两种方式：

1. **从快照中省略** — 下次SFTP全量快照中不包含该商品，它会自动从目录中消失
2. **设置 `is_eligible_search` 为 `false`** — 保留商品记录但不在ChatGPT商品发现中展示

方式2适用于临时下架（如季节性商品、暂时缺货）的场景。

### Q: 促销数据怎么提交？

**A**: 促销**只能通过REST API提交**，不支持SFTP文件上传。使用 `PATCH /product_feeds/:id/promotions` 端点进行upsert操作。

## 支付安全

### Q: 支付安全怎么保证？

**A**: ACP使用**Delegate Payment API**处理支付，由Stripe托管。核心机制：

1. 用户在ChatGPT中确认购买时，支付凭证通过Stripe安全传递
2. Stripe生成一次性的 **vault token**（格式 `vt_...`），传递给商家
3. 商家使用vault token完成扣款，**永远不会接触到原始卡号**
4. 整个过程符合PCI DSS合规要求

### Q: 3DS认证怎么处理？

**A**: 当支付需要3D Secure认证时：

1. Checkout Session进入 `authentication_required` 状态
2. 响应中包含 `AuthenticationResult` 对象，提供认证URL
3. AI代理将认证URL传递给用户
4. 用户在银行页面完成3DS验证
5. 认证完成后，Session继续进入支付流程

### Q: Checkout Session有哪些状态？

**A**: Checkout Session是一个包含**11个状态**的状态机：

| 状态                        | 说明        |
| ------------------------- | --------- |
| `open`                    | 新创建，可编辑   |
| `stale`                   | 数据已过时，需刷新 |
| `requires_payment`        | 等待支付信息    |
| `requires_confirmation`   | 等待用户确认    |
| `processing`              | 支付处理中     |
| `authentication_required` | 需要3DS认证   |
| `complete`                | 交易完成      |
| `expired`                 | 会话已过期     |
| `canceled`                | 已取消       |
| `failed`                  | 交易失败      |
| `requires_action`         | 需要额外操作    |

## 兼容性

### Q: ACP和UCP可以同时接入吗？

**A**: **可以**。ACP和UCP是两套独立的协议，互不冲突：

* **ACP**: 由Stripe创建，首先在ChatGPT生态实现，侧重商品发现+结账+支付
* **UCP**: 由Google联合Shopify等发起，跨平台设计，覆盖结账+身份+订单+支付

商家可以同时实现两套协议，覆盖更多AI平台的用户。数据格式和端点各自独立，不会产生冲突。

### Q: ACP与传统电商API有什么区别？

**A**: 关键区别：

| 维度       | 传统电商API  | ACP                |
| -------- | -------- | ------------------ |
| **调用方**  | 商家前端/App | AI代理               |
| **发现方式** | 搜索引擎/广告  | AI对话推荐             |
| **支付**   | 商家直接处理   | Delegate Payment委托 |
| **数据同步** | 按需查询     | 主动推送（SFTP+API）     |
| **交互形式** | 页面浏览     | 自然语言对话             |

## 接入建议

### Q: 接入ACP的最佳实践是什么？

**A**:

1. **先小后大** — 约100条商品开始测试，逐步扩展
2. **双通道同步** — SFTP全量快照 + API实时增量
3. **保持ID稳定** — 商品和变体ID在生命周期内不变
4. **监控数据质量** — 定期检查同步状态和错误率
5. **测试支付流程** — 使用Stripe测试模式验证完整交易链路
6. **遵守内容政策** — 不提交禁止类别的商品

<Note>
  ACP目前处于Beta阶段，规范版本 2026-01-30。本章内容基于ACP开放规范和OpenAI Commerce文档。最新信息请查看 [agenticcommerce.dev](https://agenticcommerce.dev)。
</Note>

***

**下一步推荐**: [MCP 模型上下文协议](/zh/book-5/index) — 了解AI应用连接外部工具和数据的标准协议

**返回目录**: [ACP代理商务协议](/zh/book-4/index)