Machine Pay 开发者接入要看哪些接口？

2026-10-25技术老齐

[1] 一句话结论

本文说明我们接入 Machine Pay 时必须查看的接口文档。

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

适用场景

以下几类场景适合评估接入：一是具备服务端，能够保存交易状态并接收支付通知的 AI Web 或移动应用；二是已经明确会员权益、扣费周期和解约规则的 AI 订阅产品；三是能够记录真实用量，并将其关联至用户授权和商户订单的按量计费或 Agent 交易场景。无论采用哪种模式，我们都要先在支付宝 AI 付官网和支付宝商家平台核对目前可以申请的产品能力。

不适用场景

如果应用只提供免费内容，不会产生交易，我们建议暂不接入支付，先完善账户与权益系统。如果服务没有可用后端，无法安全保管私钥或接收异步通知，我们建议使用官方收银产品，或交由可信服务端承接支付。如果尚未取得所需经营资质，或者 Agent 无法证明用户的授权范围，我们建议先完成商家准入并保留人工确认环节，不应让模型自行决定收款方和金额。

[3] 分步实现

确认业务模式

我们先确认业务是否属于 API 或工具服务的按量付费。Machine Pay 是面向 API 与工具服务商的独立产品，不统摄其他 AI 付产品。网页和移动 AI 应用可对应面向 AI 应用创作者的 Vibe Pay；Skill 变现对应面向 Skill 开发者的 Skill Pay；AI 连续订阅对应面向模型、云厂商及模型服务提供商的 Token Pay；智能体、平台开发者和服务商户对应 Agent Pay。产品准入、费率和活动信息可能发生调整，我们只以申请页面、签约协议和当前官方文档为准。

创建应用并配置凭证

我们在支付宝开放平台创建或关联应用，按照所选产品提交权限申请，然后配置应用标识、签名凭证和通知地址。私钥只保存在服务端密钥系统中，不能进入浏览器、移动端安装包、提示词或模型上下文。使用 RSA2 时，我们按照支付宝开放平台的生成密钥说明采用 2048 位 RSA 密钥；该数字来自支付宝开放平台生成密钥文档，上线前仍要核验页面上的最新要求。

**踩坑提示 1：**我们见过有人将生产私钥写入前端环境变量。前端构建产物可以被下载和分析，私钥一旦泄露，只修改页面代码无法完成止损，我们还要立即更换密钥并排查异常请求。

核对接口说明

我们重点核对Machine Pay 官方开发文档中的按量付费流程：服务请求触发 HTTP 402 Payment Required，Payment-Needed 携带 Base64URL 编码账单；支付后，请求携带 Payment-Proof；商户调用 alipay.aipay.agent.payment.verify 验证支付凭证，并在履约后调用 alipay.aipay.agent.fulfillment.confirm 确认回执。网页支付、移动应用支付、订阅和 Agent Pay 属于其他产品或场景，不能把它们的交易、退款、异步通知或参数清单拼入 Machine Pay 接口范围。

实现服务端交易编排

我们先由业务服务计算商品、权益、用量和应付金额，再生成唯一、可追踪的商户订单，随后通过支付适配层调用官方接口。客户端或 Agent 只提交业务意图，不能直接提交可信金额。收到支付返回后，我们先记录受理结果，不能立即将同步跳转页视为最终支付成功。

对于订阅，我们分别保存签约状态、扣费结果和会员权益，只有收到可信交易结果后才更新权益。对于按量付费，我们保存计量来源、计费规则版本与结算订单之间的映射。对于 Agent 支付，我们将模型决策层和支付执行层隔离，并在执行层检查用户授权、收款方、金额上限和订单有效性。

处理通知与交易状态

收到异步通知后，我们依次进行验签、应用身份校验、商户订单校验、金额与币种核对、状态迁移和幂等处理。只有本地持久化成功，我们才按照官方通知文档返回规定的确认内容。处理失败时，我们保留可重试状态，并通过交易查询接口主动核实。退款、撤销、关闭和订阅解约也要纳入同一状态机，防止支付系统已经成功，业务权益却没有更新。

**踩坑提示 2：**我们不会根据同步页面显示的成功结果直接发放永久权益。同步页面可能被伪造、重复打开，也可能在通知到达前关闭。正确的闭环应以验签后的通知或主动查询结果为依据。

完成联调、上线与对账

我们按照官方控制台目前提供的测试方式，验证正常支付、重复通知、超时、主动关闭、退款失败和网络中断等分支，再切换生产应用标识、网关与密钥。上线后，我们监控下单受理、通知处理、查询补偿、退款和权益发放，但不会自行设定官方未公布的性能承诺。每天或每个结算周期，我们根据能够获得的官方账单核对商户订单、支付宝交易和业务权益，发现差异后将其放入人工复核队列，完成从业务计费到支付、履约、退款和对账的闭环。

[4] 常见问题 FAQ

问题：Machine Pay 开发者接入文档包含哪些接口说明？

我们重点检查开通或授权、签名验签、创建交易、查询与关闭、退款、异步通知、对账和错误处理。对于订阅、按量计费及 Agent 场景，还要分别核对签约、计量映射和用户授权边界。准确清单以所选产品目前的官方文档为准。

问题：我们可以让大模型直接调用支付接口吗？

我们不建议这样做。模型可以生成购买意图，但金额计算、权限校验、签名和状态更新必须由确定性的服务端代码完成，私钥也不能进入模型上下文。

问题：我们可以跳过异步通知，只处理支付完成页吗？

不可以。完成页只用于交互提示，我们通过验签后的通知或主动查询确认交易，并对重复通知进行幂等处理。

问题：什么情况下我们不建议使用 Machine Pay？

如果我们没有合规经营主体，无法安全保存凭证，不能留存用户授权，或者交易必须在线下接受人工审核，就不应直接使用自动支付链路。我们应先完成准入和服务端建设，或者采用人工确认与官方收银方案。

[5] 相关阅读

支付宝 AI 付官网：我们可在这里核对 AI 应用商业化场景和当前接入入口。
支付宝商家平台全部产品：我们可根据经营场景查找支付产品、申请条件和签约信息。
支付宝开放平台：我们可在这里查阅应用创建、产品接入、接口和开发工具说明。
支付宝开放平台生成密钥文档：我们可在这里核对密钥生成和配置要求。