我是收款方
接入支付宝 AI按量付费,让 Agent 调用你的服务时按调用付费,实现服务变现。
专为智能体经济打造,让每一个 AI 技能、MCP 服务、API 都能实时变现。
通过 npx -y @alipay/alipay-aipay@latest install 安装支付宝 AI 付 Skill,加载 alipay-aipay 技能为我的 api 接口集成按量付费,完成沙箱测试,并完成签约入驻 已收到你的星座:天秤。这次「今日运势」由星座运势服务提供。第一次使用,需要用支付宝APP扫码,支付并开通 Agent支付 —— 只收 ¥0.01 体验金,2 小时内原路退回。
✓ 支付待确认订单金额:¥0.01
订单号:20260721008282221500220000067818
正在处理中...
支付方式:
电脑端用户:请 点击此处 授权并支付
手机端用户:请 点击此处 授权并支付
支付完成之后就可以在支付宝订单详情页查看您的订单状态啦~
AI按量付费是支付宝 Agent支付推出的基于 402 Payment Required HTTP 状态码的 A2M 方案,可让您的 API、数字内容或算力资源,能够直接向访问它们的 AI 智能体(AI Agents)发起自动收款。
接入支付宝 AI按量付费,让 Agent 调用你的服务时按调用付费,实现服务变现。
一次接入,赋能平台下所有开发者在 Agent 调用服务时进行变现。
告别低效率的月费订阅,为每一次 API / MCP-Tool 调用精准定价并收费。
当 AI 访问你的资源时,A402 自动触发支付请求并完成结算,无需人工干预。
基于 HTTP 402 Payment Required 状态码的 A2M 方案,专为 Agent 调用场景设计。
按调用计量、计费和结算,让资源提供方专注服务本身,坐等收钱。
A402 是一种面向 AI 服务的按量付费方式。
当用户或 AI 应用想调用一个付费能力,比如查询数据、使用工具、生成内容、调用接口时,不需要先注册复杂账号、充值套餐或人工结算。服务方可以直接标明价格,调用方用一次、付一次,付款成功后立即获得服务结果。
简单说,A402 让 AI 服务像扫码买东西一样自然:
需要服务,发起请求;确认价格,完成支付;支付成功,马上使用。
用户或智能体发起服务请求。
服务方返回价格。
用户或智能体通过支付宝 AI 付完成付款。
服务方校验付款是否成功。
校验通过后,服务方返回结果。
%%{init: {"sequence":{"useMaxWidth":false,"actorMargin":148,"messageMargin":40,"messageAlign":"center","diagramMarginX":18,"diagramMarginY":6,"mirrorActors":false,"wrap":true,"wrapPadding":10}}}%%
sequenceDiagram
participant 调用方
participant 服务端
participant 支付辅助方
participant 结算网络
调用方->>服务端: GET /api 请求付费资源
服务端-->>调用方: 402 需要支付:返回付款要求
调用方->>调用方: 根据付款要求生成支付载荷
调用方->>服务端: GET /api 携带支付签名
服务端->>支付辅助方: POST /verify 验证支付签名与付款要求
支付辅助方-->>服务端: 200 验证通过
Note over 服务端,支付辅助方: 支付辅助方可选;服务端也可以自行完成验签与结算
服务端->>服务端: 执行业务逻辑
服务端->>支付辅助方: POST /settle 发起结算
支付辅助方->>结算网络: 提交交易
结算网络-->>支付辅助方: 交易确认
支付辅助方-->>服务端: 200 结算完成,返回交易哈希
服务端-->>调用方: 200 OK 返回支付结果与内容
正在确认登录状态...
请用支付宝App扫码登录
支付宝App扫码验证身份
未获取到认证二维码,请返回产品选择后重试。
支付宝App扫码验证身份
未获取到认证二维码,请返回产品选择后重试。
请稍候,系统正在为你准备流程。
您可以直接接入文档,也可以继续为新产品发起入驻。
提示:技术集成可以和业务入驻并行进行,无需等待产品开通审核完成。建议先使用沙箱环境完成集成和测试,沙箱环境不使用真实资金,可以放心调试。
将以下提示词复制粘贴到 AI 编程工具(Cursor / Windsurf / Cline / Claude Code),即可自动完成集成:
通过 npx -y @alipay/alipay-aipay@latest install 安装支付宝 AI 付 Skill,加载 alipay-aipay 技能为我的 api 接口集成按量付费 将以下密钥配置到项目环境变量中
AIPAY_APP_ID=2024001234567890 # 沙箱应用公钥 AIPAY_PUBLIC_KEY=MIIBIjANBgkqhk... # JAVA 语言私钥 AIPAY_PRIVATE_KEY=MIIEvQIBADANBg... # 非 JAVA 语言私钥 AIPAY_PRIVATE_PKCS_KEY=MIIEowIBAA... # 沙箱支付宝公钥 AIPAY_ALIPAY_PUBLIC_KEY=MIIBIjANBgkqhk... 将网关地址修改为沙箱地址
AlipayClient alipayClient = new
DefaultAlipayClient("https://openapi-sandbox.dl.alipaydev.com/gateway.do",AIPAY_APP_ID,AIPAY_PRIVATE_KEY,"json","UTF-8",AIPAY_PUBLIC_KEY,"RSA2"); 详情见 当前产品产品接入指南
沙箱环境无需使用真实资金。所有交易均为模拟数据,不会产生任何实际费用,可以放心反复测试。
系统已为你分配以下沙箱测试账号,请使用这些账号在沙箱 APP 中登录:
下载支付宝沙箱版 APP,使用上方买家账号登录
打开你开发的应用,触发一笔收款请求(沙箱环境不使用真实资金)
使用沙箱 APP 扫码或跳转完成付款操作
检查你的服务器是否收到支付成功的异步通知
沙箱 APP 是一个独立的测试环境客户端,与正式版支付宝完全隔离,使用上方提供的测试账号登录即可。
使用手机扫码下载沙箱 APP
把代码里的沙箱配置换成线上真实配置,然后发起一笔真实交易,确认支付全链路在线上可以正常使用。
在你的代码或环境变量中搜索以下沙箱,将它们替换为下方的线上值:
AIPAY_APP_ID=2024001234567890 # 沙箱应用公钥 AIPAY_PUBLIC_KEY=MIIBIjANBgkqhk... # JAVA 语言私钥 AIPAY_PRIVATE_KEY=MIIEvQIBADANBg... # 非 JAVA 语言私钥 AIPAY_PRIVATE_PKCS_KEY=MIIEowIBAA... # 沙箱支付宝公钥 AIPAY_ALIPAY_PUBLIC_KEY=MIIBIjANBgkqhk... AIPAY_APP_ID=2024001234567890 # 线上应用公钥 AIPAY_PUBLIC_KEY=正在加载... # 线上 JAVA 语言私钥 AIPAY_PRIVATE_KEY=(需自行配置线上 JAVA 语言私钥) # 线上非 JAVA 语言私钥 AIPAY_PRIVATE_PKCS_KEY=(需自行配置线上非 JAVA 语言私钥) # 线上支付宝公钥 AIPAY_ALIPAY_PUBLIC_KEY=正在加载... AIPAY_APP_ID、AIPAY_PUBLIC_KEY、AIPAY_PRIVATE_KEY、AIPAY_PRIVATE_PKCS_KEY、AIPAY_ALIPAY_PUBLIC_KEY 替换为上方线上值
https://openapi.alipay.com/gateway.do 完成上方步骤后,输入支付宝交易号进行验证:
恭喜你,已完成支付宝收款能力的全流程接入。前往工作台查看收款情况。
在你的 AI 编程工具(Cursor / Windsurf / Claude Code 等)中,粘贴并运行下方 npx 指令,按照终端 / 智能体的步骤引导即可自动完成 SDK 安装与接入配置。
打开你的 AI 编程工具(Cursor / Windsurf / Claude Code)
复制并粘贴下方 npx 指令,回车运行
按照编程工具的引导完成支付功能集成及商家资质申请
通过 npx -y @alipay/alipay-aipay@latest install 安装支付宝 AI 付 Skill,加载 alipay-aipay 技能为我的 api 接口集成按量付费,完成沙箱测试,并完成签约入驻 查看已接入的支付产品及使用数据
查看注册服务及调用配置