# 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) |