# AI收产品接入目录 ## 产品简介 **AI收** 是支付宝AI付推出的基于402 Payment Required HTTP状态码的 A2M 方案,可让您的 API、数字内容或算力资源,能够直接向访问它们的 AI 智能体(AI Agents) 发起自动收款。 - 商户通过 402 Payment Required 报文,向用户透传商品信息和收款方信息。 - 用户通过支付宝的402支付skill自动发起支付。 - 无感鉴权: 摆脱传统的 账号-登录-跳转-确认 链路,实现的原生支付。 - 真正的 按用收费(Pay-per-use): 告别低效率的月费订阅。你可以为每一次 API/MCP-Tool调用精准定价并收费。 --- ## 文档目录与路由表 ### 一、产品介绍 | 主题 | 文档链接 | 核心内容 | | --- | --- | --- | | 产品特色 | [产品介绍](https://ideservice.alipay.com/cms/site/0j7tpg) | 产品概述、申请条件、费率、结算规则 | | 接入准备 | [接入准备](https://ideservice.alipay.com/cms/site/0j7tph) | 商家自研接入、服务商代开发接入流程 | | 常见问题 | [常见问题](https://ideservice.alipay.com/cms/site/0j7uos) | 扫码支付、撤销交易、退款问题解答 | ### 二、接入指南 #### AI收基础功能交互 ``` sequenceDiagram participant U as 用户Agent participant M as 商户提供的服务 participant A as 支付宝 %% 1. 首次请求资源(无支付凭证) U->>M: 请求付费资源(无支付凭证) M-->>U: 返回402 Payment Needed %% 2. 用户发起支付 U->>A: 发起支付 A-->>U: 返回支付凭证 %% 3. 用户携带支付凭证再次请求资源 U->>M: 请求资源(携带支付凭证) M->>A: 校验支付凭证 A-->>M: 返回校验成功 %% 4. 履约并返回结果 M->>U: 履约 M->>A: 上报履约回执 U->>A: 上报履约回执 ``` #### 期望交付 实现一个本地 URL 端点的支付验证中间件,具体流程如下: 1. 请求拦截与凭证检查 - 拦截用户对该 URL 的所有访问请求 - 检查请求头中是否携带支付凭证(Payment Credential) 2. 无凭证处理(返回 402) - 如果请求未携带支付凭证: - 返回 HTTP 402 Payment Required 状态码 - 在响应头中添加 Payment-Needed 字段,值为 Base64 编码的支付提示信息,响应头示例见[接入指南](https://ideservice.alipay.com/cms/site/0j7svz) 2. 有凭证处理(验证与履约) - 如果请求携带支付凭证: - 调用支付宝 API 验证该支付凭证的有效性 - 验证通过则执行履约逻辑(发送/交付资源) - 履约完成后,向支付宝发送履约确认回执 #### 集成工具 | 主题 | 文档链接 | 核心内容 | | --- | --- | --- | | SDK & Demo 获取 | [SDK获取](https://ideservice.alipay.com/cms/site/0izcs6) | Java/.NET/PHP版本Demo下载 | ### 三、API接口列表 | 接口名称 | 接口英文名 | 文档链接 | 用途 | | --- | --- | --- | --- | | A2A商户支付凭证验证 | alipay.aipay.agent.payment.verify | [接口文档](https://ideservice.alipay.com/cms/site/0j7uot) | 请求验证支付凭证 | | A2A商家履约回执确认 | alipay.aipay.agent.fulfillment.confirm | [接口文档](https://ideservice.alipay.com/cms/site/0j7sw0) | 向支付宝发送履约回执 | --- ## 核心接入流程 > 📖 详见:[接入指南](https://ideservice.alipay.com/cms/site/0j7svz) --- ## 开发者核心关注要点 | 关注点 | 说明 | | --- | --- | | 智能收产品开通上架 | 先在[商户一站式入驻平台](https://b.alipay.com/page/home/open-ai-pay)上架产品,再接入功能 | | 构造402返回体中的 Payment-Needed Header 内容 | 必须严格按照[接入指南](https://ideservice.alipay.com/cms/site/0j7svz)中的格式,分层构造,不遗漏任何参数,最后进行base64编码 | | Payment-Needed Header中的seller_signature | 商户自实现:调用SDK内置util方法;可参考示例代码 | | Payment-Needed Header中的pay_before | ISO 8601 带时区格式(例如:2026-05-15T12:08:36+08:00) | | AI收暂不提供沙箱 | AI收暂不提供沙箱 | --- ## SDK配置 | 配置模式 | 适用场景 | 文档链接 | | --- | --- | --- | | 公钥模式 | 普通接口调用 | [接入准备](https://ideservice.alipay.com/cms/site/0izcrm) | | 公钥证书模式 | 涉及资金支出接口(必选) | [接入准备](https://ideservice.alipay.com/cms/site/0izcrm) | > 📖 Demo下载:[SDK & Demo 获取](https://ideservice.alipay.com/cms/site/0izcs6) --- ## 相关链接 | 名称 | 链接 | | --- | --- | | AI收官网 | [https://a2a.alipay.com/](https://a2a.alipay.com/) | | 支付宝开放平台 | [https://open.alipay.com/](https://open.alipay.com/) | | 商家平台 | [https://b.alipay.com/](https://b.alipay.com/) | | 商户一站式入驻平台 | [https://b.alipay.com/page/home/open-ai-pay](https://b.alipay.com/page/home/open-ai-pay) |