AP2 代理支付协议：包含 60 多个合作伙伴的开发者指南

Google 与 Mastercard、Visa 等 60 多个合作伙伴一起推出代理支付协议 (AP2) （通过 Worldpay）、American Express、PayPal、Coinbase、Salesforce、ServiceNow、Adyen 和 JCB。 该规范回答了一个问题：当人工智能代理代表你支付某项费用时，谁签署了 什么以及卡网络如何解决三周后的退款问题？

Stripe Checkout 和 Apple Pay 假设人点击了按钮。 代理商务打破了这一点 假设。 如果你的购物代理在凌晨 3 点你睡觉时预订了一家酒店，而房间里有臭虫， 争议程序必须重建您是否授权 那 购买或给予 代理人空白支票。 AP2 以签署的授权做出回应：绑定一个小的、结构化的对象 通过加密证明来代理用户意图。

以下是开发人员将 AP2 连接到代理所需的六部分细分，以及加密路径 通过已经投入生产的 A2A x402 扩展。

第 1 部分：任务是原子单位

授权是一个 JSON 对象，当用户授权一个类时，用户的身份提供者会签名 购买量。 每笔下游付款均通过 ID 引用授权； 商家核实 签名、检查约束并结算。 这是电线上的样子：

四个领域具有分量。 intent 是用户要求的简单英语内容。 constraints 是机器可读的信封：最大金额、货币、品牌许可名单、 类别。 valid_until 限制代理人可以按照授权行事的时间。 signature 是 Ed25519 或 ECDSA 证明，表明发行者（Google Pay、Auth0 代理（银行的身份服务）实际上对有效负载进行了签名。

约束是产品工作发生的地方。 一项授权 max_amount: 10000 没有哪个品牌许可名单是一张代理人形的空白支票。 一项授权 与 max_amount: 200, brand_allowlist: [...], category: "footwear" 是一个有范围的 商家可以推理的授权。 像对待任务约束设计一样对待 OAuth 范围设计：产品允许的最严格的设置。

第 2 部分：AP2 作为 A2A 扩展运行

AP2 并没有重新发明传输。 它依赖于 Agent2Agent，开放的 JSON-RPC 协议 Google 于 2025 年发布，用于代理间通信。 具有付款意图的 A2A 任务包含 授权范围内 extensions.ap2 信封字段：

接收代理（此处为商家的购物代理）读取 A2A 任务，看到 ap2 扩展，通过其 PSP 验证授权，并接受任务或 返回签名拒绝。 对于已经使用 A2A 的开发人员来说，添加 AP2 是一个扩展密钥 在任务信封中加上验证电话； 它不是并行堆栈。

第 3 部分：x402 如今处理加密支付

Card Rails 仍在就退款责任进行谈判。 加密货币发展得更快。 A2A x402 扩展（与 Coinbase、以太坊基金会和 MetaMask 共同设计）是 生产就绪并重用 HTTP 402 付款 需要协商解决：

流程分为四个步骤：请求、402 支付要求、签名转账绑定随机数 到授权书，请使用收据重试。 商户在释放前验证链上转账 资源。 今日结算为 USDC，基础或乐观； 稳定币轨道保持用户体验接近 信用卡购买在签名和确认之间没有浮动货币漂移。

第 4 部分：向 Python 请求授权

以下是使用参考 AP2 SDK 在 Python 中代理端的样子。 代理人询问 授权的用户身份提供者，接收签名对象，并将其通过 A2A 线程化 给商家的任务：

有两个细节很重要。 签名密钥位于 KMS 中（Google Cloud KMS、AWS KMS、HashiCorp Vault） 因此，渗出的代理二进制文件无法伪造身份。 授权可在商户之间重复使用 期间 valid_until; 用户授权一次，代理店多处。 那 重用是 AP2 存在的全部 UX 原因； 如果没有它，每个商家都会重新提示用户和 代理体验崩溃。

第 5 部分：从商家后端验证授权

商家方面是大部分欺诈面所在的地方。 验证必须涵盖四个 事物：签名有效性、发行者信任、约束匹配和到期。 在任何一个方面偷工减料 他们和你运送一个洞：

值得效仿的三种模式。 保留一个 issuerAllowlist; 不接受来自以下机构的授权 任何出现的发行人。 执行 clockSkewSeconds; 片状网络上的代理发送 通常将时间戳设置为未来 15 秒。 将任务 ID、代理 ID 和用户 ID 存储在 您的 PSP 元数据，以便三周后的退款争议可以重播该链，而无需 支持工程师深入研究日志。

第 6 部分：围绕授权构建多货币购物车

代理买家不断交叉货币。 东京的用户向代理提供了美元授权； 的 代理在欧洲商家找到以欧元定价的交易。 商家需要知道美元上限是多少 在接受委托之前转换为欧元。 货币转换调用保留数学 诚实：

在任务的生命周期内缓存速率。 如果速率变化超过配置的范围 （典型：2%），要求用户重新签名。 代理商如何应对过时的价格 支持门票。

AP2 对您的堆栈有何变化

要点

• 授权书取代了不记名凭证。 代理人带有签署的意图，而不是 卡号； 商家在收费之前会验证范围。
• AP2 在 A2A 上运行。 JSON-RPC 信封中的一个扩展密钥，而不是新的 运输； 如果您的代理已经会说 A2A，您只需打一个电话即可进行验证。
• x402 是当今生产中的加密路径。 HTTP 402 加上 Base 上的 USDC 或 乐观情绪，Coinbase 和 MetaMask 已经开始运送客户。
• 约束设计就是范围设计。 对待 max_amount, 允许名单，以及 valid_until 作为代理付款的 OAuth 范围。
• 将 Mandate 链存储在 PSP 元数据中。 三周后退款 不能对您未记录的内容提出异议。

Botoi 提供 AP2 商户流程所依赖的支持端点：货币兑换、 国家/地区查找、IP 和 VPN 检测、地址验证以及卡元数据的 BIN 查找。 一 API 密钥，免费套餐上每分钟 5 个请求。 浏览 交互式文档 或接线 MCP服务器 进入 您的代理，以便 Claude 或 Cursor 可以从编辑器内部调用相同的端点。