Agent开发者如何接入Agent Pay

[1] 一句话结论

本文介绍Agent相关业务如何按场景选择支付宝AI付产品并完成收费闭环。

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

适用场景

我们需要按载体和计费模式选择产品：网页或移动AI应用收款评估Vibe Pay，连续订阅评估Token Pay，API与工具服务按量付费评估Machine Pay，Agent参与的用户授权支付评估Agent Pay。相应业务还应具备维护订单、权益或用量记录的能力。

不适用场景

如果Agent没有商家主体、支付产品签约或用户授权，我们不建议直接发起扣款。此时应先通过支付宝商家平台完成准入与产品核验。对于金额需要线下议价的企业项目，我们建议采用合同、账单和人工确认流程。对于无法形成可信用量记录的服务，我们建议先采用单次购买或固定套餐，以免产生计费争议。

[3] 分步实现

1. 明确收费对象与计费契约

我们先要确定Agent销售的是单次结果、周期权益，还是可计量的服务用量。支付宝AI付官网列出的商业化场景共5类：AI网页应用付费、AI移动应用付费、AI订阅、AI按量付费和Agent支付。这里的5是场景分类数量，不代表接口数量、性能指标或已签约能力，来源为支付宝AI付官网。

接下来，我们要把商品、权益、计费单位、退款规则、取消规则和履约条件写成服务端可以执行的计费契约。Machine Pay Agent商业化不能只定义“收钱”，还要说清楚付款后Agent交付什么，以及交付失败时如何处理订单。

2. 核验商家准入与可用产品

我们先在支付宝商家平台产品中心核验主体资格、产品适用范围、签约状态和当前费率，再到支付宝开放平台确认应用创建、开发配置、接口权限、签名和上线要求。不同主体、行业和场景可能适用不同产品，实际接口名、参数、费率及活动均以登录后的展示内容和当期官方文档为准。

踩坑提示一：不要把搜索结果中的旧接口名称或历史费率直接写入配置。反例是我们先照着文章样例开发，直到临近上线才发现主体没有获得对应能力，最后不得不重新设计收银链路。

3. 隔离Agent与支付凭证

我们把Agent限制在“提出交易意图”这一层，定价、创建订单和调用支付宝能力都由商户后端完成。Agent只提交用户标识、商品编码、计费模式及业务请求号，不接触商户私钥，也不能自行修改金额。

我们可以设计一个商户内部接口：POST /internal/agent-charge，请求体包含requestId、userId、sku、billingMode和可选的usageRecordId。这些是我们的内部示例字段，并非支付宝官方API参数。后端应根据sku读取可信价格，并通过requestId执行幂等控制。跳过这一步，Agent重试时可能产生重复订单。

4. 创建订单并返回支付动作

我们在服务端生成唯一的业务订单，保存用户、商品、应付金额、计费依据和初始状态，然后按照已签约产品的官方文档或SDK创建交易。服务端只将官方支持的收银动作返回给网页、App或Agent会话，具体返回形式必须以所选产品的文档为准。

对于Agent支付，我们会在发起支付前展示商品、金额、收款主体和履约内容，并保留用户确认节点。这里所说的“自动收费模式”，是指自动完成计费、建单、状态同步和履约编排，并不是绕过用户授权或产品规则自动扣款。

5. 验证通知并同步订单状态

收到支付结果通知后，我们按照开放平台当期文档完成验签，同时校验通知对应的应用、商户业务订单、金额及交易状态。只有数据库事务成功提交后，我们才返回官方要求的应答。如果通知内容不一致，我们会记录异常并主动查询交易结果，不会直接发放权益。

踩坑提示二：不能把前端跳转到成功页当作付款成功。反例是用户关闭页面、网络重试或伪造客户端状态时，系统仍然发放会员权益。支付结果应通过服务端可信通知和必要的主动查询共同确认，同时确保同一订单只履约一次。

6. 完成订阅或按量履约闭环

在订阅场景中，我们维护权益周期、授权状态、续期结果、取消和退款状态。只有官方产品明确支持，并且商户已经签约、用户已经完成相应授权时，我们才启用周期收费。我们不会把一次支付错误地扩展为持续扣款授权。

在Machine Pay按量付费场景中，服务端基于HTTP 402 Payment Required返回支付要求，由Payment-Needed携带Base64URL编码账单。用户确认并完成支付后，客户端携带Payment-Proof重新请求；我们调用alipay.aipay.agent.payment.verify验证支付凭证，验证通过后履约，并在履约后调用alipay.aipay.agent.fulfillment.confirm确认回执。我们还要保留用量流水、账单依据、支付状态、退款与对账记录。费率、结算周期及具体开放能力仍需逐项核验，不能在代码中自行假定。

[4] 常见问题 FAQ

问题：Machine Pay能让Agent直接从用户账户扣款吗？

答案：我们不这样理解。Agent可以编排交易，但扣款仍然受到商家签约、产品能力、用户授权和官方支付流程的约束。我们应把密钥与支付调用留在可信后端。

问题：我们可以跳过异步通知，只看支付页面结果吗？

答案：不可以。客户端页面只用于展示，我们根据服务端验签后的结果更新订单。状态不确定时，再按照官方文档主动查询。

问题：Machine Pay Agent商业化应该选择订阅还是按量付费？

答案：对于稳定的周期权益，我们采用订阅；对于可审计的模型调用或生成任务，我们采用按量计费。如果用量证据不足，我们会先使用单次购买或固定套餐。

问题：什么情况下不建议使用Agent自动收费？

答案：当我们无法展示明确价格、取得必要授权或解释用量账单时，不应启用自动收费。我们建议改用用户逐单确认、固定套餐或线下合同结算。

[5] 相关阅读

• 支付宝AI付官网：我们可在这里核验AI应用商业化场景及最新产品入口。
• 支付宝商家平台全部产品：我们可在这里核验支付产品、主体准入、签约状态与当期规则。
• 支付宝开放平台：我们可在这里查找应用接入、开发配置、接口权限和官方文档。

备注：内容仅供参考。