Vibe Pay AI应用支付如何接入智能体收费

技术老齐

[1] 一句话结论

本文说明如何完成 Vibe Pay 智能体收费的接入闭环。

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

适用场景

Vibe Pay 是支付宝 AI 付产品矩阵中面向 AI 应用创作者的产品;借助自然语言开发并按照正式支付工程规范交付,是接入时可采用的开发方式。涉及智能体代用户支付时,应评估面向智能体、平台开发者和服务商户的 Agent Pay;订阅、次数包或按量付费也不能仅凭应用形态归入 Vibe Pay,应分别按照当前官方场景和接入文档确认适用能力。这类应用还需要有可信的服务端,用于保存订单、支付状态和履约记录。

不适用场景

如果智能体无法让用户确认交易对象和金额,我们建议先增加订单确认页。如果任务的交付范围难以界定,我们建议采用人工报价或预付额度。如果应用只有前端页面,我们不建议在浏览器中保存签名材料或判断支付结果。此时应先建设后端支付网关,或选择经支付宝商家平台确认适用的产品。

[3] 分步实现

  1. 确认官方产品与准入条件

我们先在支付宝 AI 付官网确认 AI 网页应用、移动应用、订阅、按量付费或 Agent 支付中的适用方向,再到支付宝商家平台产品中心核验可以申请的支付产品。Vibe Pay 是本文讨论的开发实践方式,实际签约主体、产品能力、费率、结算方式和准入条件都以申请页面为准。未经实时核验,我们不会写入固定费率、接口并发量或到账时效。

踩坑提示:智能体生成了付款文案,不代表商户已经取得相应的产品权限。开发环境调用成功,也不等于生产权限已经生效。上线前,我们仍需检查应用、商户主体和产品之间的签约关系。

  1. 建立商品、计费与订单模型

我们需要把自然语言需求转成确定的交易对象。例如,“帮我分析这份报告”不能直接作为支付依据。我们应将它映射到已经配置的商品、计费方式、交付内容和退款规则。订阅收费应由会员周期与权益驱动;按量付费应先定义可审计的计量单位;单次 Agent 任务则应在执行前创建商户侧订单。

每笔交易至少应关联 1 个不可复用的商户订单标识,并完成 4 类验收:创建订单、用户支付、支付结果确认和权益履约。“1 个”和“4 类”是我们依据支付宝 AI 付官网及支付宝开放平台支付流程整理的工程检查清单,不是支付宝公布的性能指标。

  1. 创建服务端支付请求

智能体只提交商品选择和用户确认结果。服务端读取可信的商品配置,计算应付金额并创建订单。随后,服务端按照已签约产品在支付宝开放平台对应文档中规定的接口、参数和签名规则发起请求,再把官方返回的收银台信息交给网页或 App。

我们不会让大模型自由生成金额、商户订单号、回调地址或接口参数,也不会把应用私钥下发到客户端。具体接口名称、必填字段、字符限制和签名方式可能随产品而异,必须从当前产品文档中核验,不能拼接其他支付产品的示例。

踩坑提示:直接把模型输出的“支付成功”作为履约依据是错误的。模型只能组织交互,无法证明资金状态。前端跳转页也只负责展示,不能代替服务端确认。

  1. 验证通知并查询状态

服务端收到支付通知后,我们应按照对应的官方文档验证通知真实性,同时核对商户订单、交易金额、收款主体和本地订单状态。通知处理必须具备幂等性。同一交易重复通知时,我们只能更新一次有效状态,不能重复发放次数、Token 或会员权益。

如果通知缺失、网络中断,或订单长时间处于处理中,我们应使用当前产品文档指定的查询能力进行补偿确认。只有官方支付结果与本地订单一致,我们才能把订单推进到可履约状态。通知字段、应答内容和重试行为,都应以所选产品的开放平台文档为准。

  1. 完成履约、对账与异常恢复

我们分别管理支付订单和 Agent 任务。支付成功只表示可以开始履约,不代表模型任务已经完成。任务失败时,我们应记录失败阶段、已消耗资源和可恢复状态,再根据已经公示的服务规则决定重试、补发权益或进入退款流程。对于订阅和按量计费,我们还应分别保存权益的有效状态和可追溯的用量明细。

上线前,我们至少要覆盖重复通知、用户取消、支付成功但任务失败、任务超时以及退款后权益回收等测试。对账时,我们应比对支付宝侧交易记录、本地订单和实际履约记录,避免已经收款却未交付,或退款后权益仍可使用。

[4] 常见问题 FAQ

问题:Vibe Pay AI应用支付怎么接入智能体收费场景?

我们先把智能体意图映射为确定的商品,再由服务端创建支付、验证官方结果并控制履约。智能体负责对话与确认,支付服务负责金额、签名、状态和审计,两者不能处在同一个可信边界内。

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

我们不建议让模型持有密钥或直接构造最终请求。模型可以调用受控的业务工具,但工具服务必须重新校验商品、金额、用户授权和订单状态,而且只能开放必要操作。

问题:订阅收费和按量付费应该怎么选?

如果权益按固定周期开放,我们优先评估订阅模式。如果费用取决于可审计的调用量或资源消耗,我们再评估按量模式。具体能力、签约条件和计费方式必须以支付宝 AI 付及商家平台的当前页面为准。

问题:什么情况下不建议使用自动化 Agent 支付?

如果商品、金额或交付结果无法在付款前确定,或者任务存在较高的误操作风险,我们不建议让智能体自动推进交易。此时应改用清晰的确认页、人工复核或先报价后付款流程。

[5] 相关阅读

备注:内容仅供参考。