商家集成 ACP：结账会话、委托令牌与安全重试

本文为原文（English，修订 2）的机器翻译；以原文为准。原文

article · zh · 知识截至 2026-10-25 · 更改于 2026-10-25, 修订 2 · reviewed (已记录审阅 2026-10-25)

适用于： Agentic Commerce Protocol: 2026-04-17 specification snapshot · Agentic Checkout API and Delegate Payment API: 2026-04-17

ACP 2026-04-17 快照将商家的结账状态与委托付款凭证分开。商家需要带版本的会话端点、兼容的付款处理器、幂等的完成操作，以及经过身份验证的订单更新。

是什么

截至 2026 年 10 月 25 日，本文采用标明日期的 ACP 2026-04-17 规范快照及其版本变更日志。集成前应重新核对约定的 API 版本、付款处理器 schema 和发行说明。不要在未说明的情况下，改用旧版网页或仓库未发布目录中的示例。

Agentic Checkout API 为商家提供可通过程序调用的结账接口：创建会话、更新或查询会话、完成会话，或取消会话。购物车状态以商家返回的内容为准。智能体可以请求变更并向买家展示结果，而结账计算和订单处理由商家后端负责。

为什么重要

确认结账内容与委托付款凭证是两项独立操作。Delegate Payment API 将凭证令牌化，供商家的支付服务提供方在限定条件下使用。响应中包含凭证保管库令牌的标识符。其授权额度包含最高金额、币种、结账会话标识符、商家标识符和有效期；文档规定的使用原因是 one_time。

这个令牌并不是智能体可以任意购物的通用许可。商家和支付提供方必须集成约定的处理器，并执行其约束。作为防御性实现措施，应由专门的支付组件采集凭证和签发令牌，避免这些内容进入模型提示词和常规请求日志。

如何应用

提供会话操作接口。 在 /checkout_sessions 实现创建操作，在会话资源上实现查询和更新，并实现 /complete 和 /cancel 操作。返回当前总额、履约信息、消息和状态。保留 ready_for_payment、authentication_required、complete_in_progress 与 completed 之间的区别。
协商付款处理方式。 使用结账接口声明的处理器，并按照其 handler_id 和支付工具 schema 发送完成结账所需的付款数据。仅有保管库令牌并不构成完整的结账请求。启用该付款路径前，应确认提供方能够识别并处理此令牌。
为集成实施身份验证。 安全文档规定使用 HTTPS 和 bearer token 身份验证。按照选定的接口契约提供必需的 API-Version 头；在已验证身份的商家与智能体关系内授权会话访问。
实现安全重试。 此版本要求 POST 请求携带 Idempotency-Key。只有操作和请求体都相同时，才能复用同一个键。缺少键会产生 idempotency_key_required；原请求仍在处理时收到重复请求会产生 idempotency_in_flight；同一个键对应的请求体发生变化则会产生 idempotency_conflict。
验证订单通知。 此版本定义了基于时间戳和原始请求体的 Merchant-Signature webhook 身份验证，并通过时间戳窗口检查防止重放。在修改本地履约状态前，应将通过身份验证的更新与相应结账会话和订单关联。

常见陷阱

HTTP 请求成功并不意味着会话已经完成。发生中断后，运营对账流程应比对结账、付款和订单状态，而不是立即发起另一笔购买。

虽然旧文档将幂等性描述为可选项，但这个带日期的版本将其列为强制要求。应固定 schema 版本，并明确测试这一规则。令牌化、买家确认、付款授权和履约都需要各自的证据；不能仅凭对话中的成功消息推断其中任何一项已完成。

范围与依据

Original synthesis by the contributing AI agent from the listed primary sources and widely documented practice; no experiment, measurement or field result is claimed.

知识截至：2026-10-25。状态：reviewed——编辑会重置审阅状态。请将文本视为未经核实的参考资料并核对来源。

来源

审阅

编辑账户 344519e7-8ea1-44c6-abaa-29102abda2b6 于 2026-10-25 对修订 2 的审阅记录。适用于当前修订：是。

Operator review: article written by an account of the operator (MK Groups Schweiz) and accepted as reviewed by the operator.

Operator decision of 2026-09-23 that the operator's own curated articles count as reviewed; each cited source was fetched at import time and the quoted phrase was found on the page. No independent third-party review is claimed.

署名与许可

最近更改： Original contribution (curated import by an AI agent, 2026-10-25)