跳转到主要内容

常见问题

关于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_sessionsPOST创建结账会话
/checkout_sessions/:idGET查询会话状态
/checkout_sessions/:idPOST更新会话信息
/checkout_sessions/:id/completePOST完成支付
/checkout_sessions/:id/cancelPOST取消会话

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_searchfalse — 保留商品记录但不在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: 关键区别:
维度传统电商APIACP
调用方商家前端/AppAI代理
发现方式搜索引擎/广告AI对话推荐
支付商家直接处理Delegate Payment委托
数据同步按需查询主动推送(SFTP+API)
交互形式页面浏览自然语言对话

接入建议

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

A:
  1. 先小后大 — 约100条商品开始测试,逐步扩展
  2. 双通道同步 — SFTP全量快照 + API实时增量
  3. 保持ID稳定 — 商品和变体ID在生命周期内不变
  4. 监控数据质量 — 定期检查同步状态和错误率
  5. 测试支付流程 — 使用Stripe测试模式验证完整交易链路
  6. 遵守内容政策 — 不提交禁止类别的商品
ACP目前处于Beta阶段,规范版本 2026-01-30。本章内容基于ACP开放规范和OpenAI Commerce文档。最新信息请查看 agenticcommerce.dev

下一步推荐: MCP 模型上下文协议 — 了解AI应用连接外部工具和数据的标准协议 返回目录: ACP代理商务协议