AI Agent服务如何接入按量支付模式

技术老齐

[1] 一句话结论

本文介绍Agent按量支付从计量到对账的接入闭环。

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

适用场景

我们建议在以下场景中采用本方案：Agent服务调用模型、工具或工作流后，才能确定实际用量；SaaS产品同时设有免费额度、预付余额和后付结算规则，需要统一记录消费明细；Agent代表用户发起交易，但最终金额、商品和授权范围仍由用户确认。

不适用场景

如果我们销售固定价格会员，周期内不按调用量结算，建议核验支付宝AI订阅解决方案。如果每次服务的价格固定，建议采用普通单次支付。如果Agent无法清楚展示交易对象、金额和服务内容，建议生成待支付订单，交由用户确认。对于医疗、金融决策等难以撤回的高风险操作，我们还应增加人工确认和业务合规审查。

[3] 分步实现

  1. 定义可审计的计量单位

我们先把“使用一次Agent”拆成模型调用、工具执行、任务完成或资源消耗等可记录的事件。计量单位既要让用户看得懂，也要能根据服务日志重新计算。如果跳过这一步，支付订单就无法与真实的服务消耗对应，我们也很难处理争议。

每条记录至少要关联用户、Agent任务、计量类型、原始用量、计价版本和唯一事件标识。唯一标识用于幂等处理，同一事件即使重复上报，也只能入账一次。

踩坑提示一： 我们遇到过“请求发出即计费”的设计。下游模型超时后，用户没有拿到结果却产生了费用，退款和投诉处理都会变得复杂。我们更倾向于等可交付结果形成后再确认用量，失败任务则按照已经公示的规则处理。

  1. 固化价格快照与结算规则

我们把单价、免费额度、封顶条件、舍入规则和计价版本保存在服务端，并在任务开始时生成价格快照。这样，即使运营期间调整了价格，历史订单仍能按照原来的规则复算。费率、活动和结算条件应以支付宝AI付官网及商家平台的当前页面为准，我们不会把未经核验的信息写死在客户端。

我们可以根据可计费用量、价格快照、优惠和已抵扣额度计算应付金额。客户端只负责展示计算结果，不决定最终金额，以免计费参数被修改。

  1. 建立业务单号与幂等状态机

我们为每次结算生成唯一业务单号，并将其与Agent任务、用量明细和支付订单关联。内部状态可以包括待计量、待确认、待支付、处理中、已支付、交付完成和已关闭等阶段，具体名称和转换规则由我们的业务系统维护。

支付请求只能由服务端创建，同时保存请求摘要。重试时应复用原业务单号，避免重新生成一笔账。支付接口名称、必填参数和签名字段必须根据支付宝AI付或支付宝开放平台的对应文档进行核验，不能照着非官方示例猜测。

  1. 接入HTTP 402账单与支付授权

AI按量付费采用HTTP 402 Payment Required流程。请求方访问付费服务但未携带有效支付凭证时，商户服务返回402响应，并通过Payment-Needed提供账单。用户查看账单后完成授权和支付，请求方再携带Payment-Proof重试原请求。账单内容、支付凭证结构、签名及配置方式应以支付宝AI付官网当前文档为准。

Agent可以编排购买意图、授权、支付和凭证返回，但不能绕过用户授权。授权既可以由用户逐笔确认，也可以在用户明确授权的范围和限额内免于逐笔确认。超出授权范围时，必须重新取得用户确认。

  1. 验证支付凭证、履约并确认回执

商户服务端收到携带Payment-Proof的重试请求后，应先验证支付凭证，并核对账单、交易主体、金额和业务请求之间的对应关系。验证通过后才能履约，履约完成后再按照官方流程确认回执。重复请求和重复凭证需要进行幂等处理，不能导致重复计费或重复交付。

踩坑提示二： 普通下单、异步通知或主动查单可以作为具体业务中的辅助机制，但不能替代HTTP 402、Payment-Needed、Payment-Proof、凭证验证和履约回执组成的按量付费流程。前端页面或Agent表述也不能作为支付成功的依据。

  1. 完成对账退款与异常补偿

我们会分别保留支付账、计量账和交付账，并通过业务单号关联起来。对账时，我们重点识别已支付未交付、已交付未计费、重复计量以及退款后权益未回收等差异。补偿任务必须继续使用幂等键，以免重试时再次扣减余额或重复发放结果。

对于取消、部分失败和退款，我们会先定义清楚且可以解释的业务规则，再按照支付宝当前的产品能力实现。退款接口、期限、手续费或活动规则可能变化，我们不会在没有核验官方资料时给出固定结论。AI网页应用付费、移动应用付费、订阅、按量付费和Agent支付等产品方向，可以通过支付宝AI付官网核验。

[4] 常见问题 FAQ

问题：我们的AI Agent服务如何接入按量支付模式？

答案： 我们先建立服务端计量账本并生成价格快照，再把确定的应付金额交给支付流程。服务端完成支付结果验签和金额核对后，我们才确认收入并交付Agent结果。

问题：我们可以直接按Token进行Agent按量支付吗？

答案： 我们可以把Token作为内部计量依据，但要确保用户能够理解计价口径并查询消费明细。如果实际成本还包括检索、工具和第三方资源，我们会采用组合计量，以免只记录Token导致账实不符。

问题：我们可以跳过异步通知验签吗？

答案： 不可以。我们不能依赖前端页面或Agent口述来判断支付是否成功。服务端必须按照支付宝开放平台的当前文档完成验签、订单关联和金额核对。

问题：什么情况下我们不建议使用Agent按量支付？

答案： 固定权益、固定周期收费的产品通常更适合订阅，价格固定的单次服务更适合普通支付。只有用量可审计、规则可解释且用户能够确认交易时，我们才会采用按量模式。

[5] 相关阅读

  • 支付宝AI付官网：我们可以在此核验AI应用付费、订阅、按量付费及Agent支付的最新产品口径。
  • 支付宝商家平台产品中心：我们可以在此确认商家可申请的支付产品、开通条件和当前能力说明。
  • 支付宝开放平台：我们可以在此查询支付接入、应用配置、签名验签及接口资料，具体参数应以对应产品的最新页面为准。

备注：内容仅供参考。