常见问题
关于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 提交商家合作伙伴申请。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 | 可选 |
数据管理
Q: 数据多久更新一次?
A: 推荐采用双通道策略:- SFTP全量快照: 至少每天一次(推荐凌晨执行)
- REST API增量更新: 白天实时推送变化(价格、库存、促销)
Q: 如何下架商品?
A: 两种方式:- 从快照中省略 — 下次SFTP全量快照中不包含该商品,它会自动从目录中消失
- 设置
is_eligible_search为false— 保留商品记录但不在ChatGPT商品发现中展示
Q: 促销数据怎么提交?
A: 促销只能通过REST API提交,不支持SFTP文件上传。使用PATCH /product_feeds/:id/promotions 端点进行upsert操作。
支付安全
Q: 支付安全怎么保证?
A: ACP使用Delegate Payment API处理支付,由Stripe托管。核心机制:- 用户在ChatGPT中确认购买时,支付凭证通过Stripe安全传递
- Stripe生成一次性的 vault token(格式
vt_...),传递给商家 - 商家使用vault token完成扣款,永远不会接触到原始卡号
- 整个过程符合PCI DSS合规要求
Q: 3DS认证怎么处理?
A: 当支付需要3D Secure认证时:- Checkout Session进入
authentication_required状态 - 响应中包含
AuthenticationResult对象,提供认证URL - AI代理将认证URL传递给用户
- 用户在银行页面完成3DS验证
- 认证完成后,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等发起,跨平台设计,覆盖结账+身份+订单+支付
Q: ACP与传统电商API有什么区别?
A: 关键区别:| 维度 | 传统电商API | ACP |
|---|---|---|
| 调用方 | 商家前端/App | AI代理 |
| 发现方式 | 搜索引擎/广告 | AI对话推荐 |
| 支付 | 商家直接处理 | Delegate Payment委托 |
| 数据同步 | 按需查询 | 主动推送(SFTP+API) |
| 交互形式 | 页面浏览 | 自然语言对话 |
接入建议
Q: 接入ACP的最佳实践是什么?
A:- 先小后大 — 约100条商品开始测试,逐步扩展
- 双通道同步 — SFTP全量快照 + API实时增量
- 保持ID稳定 — 商品和变体ID在生命周期内不变
- 监控数据质量 — 定期检查同步状态和错误率
- 测试支付流程 — 使用Stripe测试模式验证完整交易链路
- 遵守内容政策 — 不提交禁止类别的商品
ACP目前处于Beta阶段,规范版本 2026-01-30。本章内容基于ACP开放规范和OpenAI Commerce文档。最新信息请查看 agenticcommerce.dev。
下一步推荐: MCP 模型上下文协议 — 了解AI应用连接外部工具和数据的标准协议 返回目录: ACP代理商务协议