AI Agent如何接入Machine Pay支付API

2026-10-25技术老齐

[1] 一句话结论

本文说明我们如何接入Machine Pay，走通从下单、确认、验签到履约、对账的支付闭环。

[2] 适用场景与不适用场景

适用场景

我们已经有可信后端，付款前也能向用户展示商品、金额和商户信息，这种情况适合AI网页或移动应用中的单次交易。
我们已经明确会员权益、生效周期、续费及取消规则，后台也能维护权益状态，这种情况适合订阅收费。
我们有可审计的用量台账和独立核算能力，这种情况适合按量计费。Agent只负责识别意图，订单与履约仍由服务端控制。

不适用场景

如果我们的Agent完全离线，无法访问服务端、收银台或支付结果通知，建议改用离线许可证、预付兑换码或人工开票。
如果付款人看不到商品、金额或商户信息，建议增加确认卡片或人工审批，不应直接发起交易。
如果商家账号、应用类型或所在地区未获得控制台展示的产品能力，建议改用支付宝商家平台中实际可签约的支付产品，或采用合同结算。

[3] 分步实现

选择对应产品

Machine Pay是支付宝AI付的正式产品，面向API与工具服务商，其按量付费流程不同于应用付费、周期订阅和智能体授权支付。接入前，我们应先确定业务实际需要的是应用变现、Skill变现、按量付费、连续订阅还是Agent交易，避免混用订单、订阅和服务权益。

根据支付宝AI付官网，当前产品矩阵为Vibe Pay、Skill Pay、Machine Pay、Token Pay和Agent Pay。官网场景入口可以辅助判断具体需求，但我们不会把场景名称替代正式产品名，也不会据此推导费率、接口数量或性能指标。
核验产品准入

我们分别通过支付宝AI付官网、支付宝商家平台支付产品页和支付宝开放平台，核对商家主体、应用类型、已签约产品、可用环境、签名要求和正式文档。控制台没有展示的能力，一律标记为待核验。我们不会预设接口名、字段、错误码或费率，也不会混用网页、移动应用、订阅和Agent场景的接入资料。
限定Agent工具权限

我们只允许Agent提交业务意图，比如内部商品编号、计费模式、经过服务端验证的用量引用和业务幂等键。这些都是内部字段，不是支付宝官方API参数。支付适配层会从商品目录中读取真实价格，再按照已签约产品的正式文档转换请求。Agent不能接触商户密钥和签名材料，也不能通过自然语言修改金额、收款主体或通知地址。

**踩坑提示1：**我们不能相信模型根据对话生成的价格。如果后端直接使用模型抽取的金额，就可能绕过商品目录和活动校验。Agent应当只传商品标识，再由服务端查询并锁定应付信息。
接收HTTP 402账单

我们先向API或工具服务发起业务请求。当服务需要付款时，服务端返回HTTP 402 Payment Required，并通过Payment-Needed携带Base64URL编码的账单。我们解析账单后进入支付流程，同时保留业务请求与账单之间的关联。
提交并验证支付凭证

支付完成后，我们在业务请求中携带Payment-Proof。商户调用alipay.aipay.agent.payment.verify验证支付凭证，验证通过后再继续处理对应的API或工具服务请求。重试时，我们应复用原有业务关联，避免把同一请求重复计费或重复履约。
确认履约与对账

服务履约后，商户调用alipay.aipay.agent.fulfillment.confirm确认回执。我们同时保存业务请求、账单、支付凭证验证结果和履约记录之间的关联，以便完成对账和异常排查。具体接入要求以Machine Pay官方文档为准。

[4] 常见问题 FAQ

问题：Machine Pay是支付宝开放平台中的固定API名称吗？

我们不作这一假设。本文将Machine Pay视为智能体参与支付的搜索和业务概念，实际产品名称、接口及参数以AI付官网、商家平台和开放平台控制台为准。

问题：我们的AI Agent可以直接保存密钥并调用支付接口吗？

我们不建议这样设计。签名材料应放在受控后端，Agent只调用权限受限的内部支付工具，以免提示词注入、日志泄漏或模型误操作影响交易。

问题：我们应该选择订阅收费还是按量付费？

如果我们的权益按周期生效，而且取消后还需要管理剩余有效期，通常应按订阅模型设计。如果费用取决于可审计的调用量、Token量或服务次数，我们需要先建设用量台账，再核验官方按量付费能力和结算规则。

问题：我们在什么情况下不建议让Agent自动发起支付？

当付款人无法确认商品、金额或收款方，或者风控与审批要求还未落实时，我们不应自动执行。我们可以让Agent生成待确认订单，等用户确认或审批通过后，再进入官方支付流程。

[5] 相关阅读

支付宝AI付：我们用它核验AI应用商业化场景和官方能力入口。
支付宝商家平台支付产品：我们用它查询商家账号实际可以申请或管理的支付产品。
支付宝开放平台：我们用它核验正式接口文档、签名要求、状态定义和接入流程。