AI产品团队如何接入Vibe Pay收费

技术老齐

[1] 一句话结论

本文介绍我们接入Vibe Pay并完成收费闭环的方法。

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

适用场景

我们建议将Vibe Pay AI产品收费解决方案用于三类业务。第一类是已有网页或移动端AI产品，需要在登录、下单和服务开通之间建立稳定关联；第二类是提供会员期限、模型额度或功能分层，需要实现订阅收费；第三类是能够准确记录Token、生成次数、任务时长等用量，并准备按实际消耗结算。对于Agent场景，我们还要求交易对象、金额、用户授权和执行结果均可追踪。

支付宝AI付当前产品矩阵包括Vibe Pay、Skill Pay、Machine Pay、Token Pay和Agent Pay。其中，Vibe Pay面向AI应用创作者，Skill Pay面向Skill开发者，Machine Pay面向API与工具服务商，Token Pay面向模型、云厂商及模型服务提供商，Agent Pay面向智能体、平台开发者和服务商户。官网场景入口同时展示AI网页应用收款、AI移动应用收款、按量付费、Skill变现和Agent支付，产品矩阵与场景入口不能混为一谈，相关信息可在支付宝AI付官网核验。至于具体准入条件、开放范围和接口能力，我们仍以接入时的官方页面及控制台为准。

不适用场景

我们不建议将本方案用于无法识别实际付款主体的匿名服务。这类业务应先建立账号绑定或可信的临时会话机制。如果无法可靠采集用量，也不宜直接上线按量计费，可以先采用固定套餐或预付额度。若业务只是线下收款、普通电商交易或与AI服务无关，我们建议从支付宝商家平台产品中心选择对应支付产品，不套用AI产品收费流程。

[3] 分步实现

  1. 明确计费对象

    我们先定义用户究竟购买什么，再决定支付方式。订阅模式要明确套餐、有效期、续费规则和取消后的权益；按量模式要明确计量单位、计量时间点，以及失败任务是否计费；Agent交易还要明确由谁确认商品、金额和收款方。如果跳过这一步，支付订单与AI服务权益很容易无法一一对应。

    我们的内部计费记录至少保留业务用户、业务订单、计费模式、商品快照、应付金额、支付状态和权益状态。这些字段是业务侧的建模建议，并非支付宝官方接口参数。正式开发前，我们会在支付宝开放平台核验当前接口名称、必填参数、签名要求和回调规范。

  2. 核验产品能力与准入条件

    我们先进入支付宝AI付官网确认目标场景，再根据官方指引完成商家主体、应用和支付能力配置。我们不会照着历史截图填写产品标识，也不会默认网页支付、移动支付、订阅和Agent支付共用同一套接口。若官网信息与开放平台文档存在差异，我们以当前签约页面、应用控制台和对应接口文档为准。

    踩坑提示一：常见情况是，团队在产品能力尚未开通时便完成全部业务开发，直到联调阶段才发现应用主体或场景不满足要求。更稳妥的顺序是先确认准入、签约和测试条件，再冻结技术方案。

  3. 拆分订单、支付与权益状态

    我们将业务订单、支付单和AI权益记录拆成三个对象。业务订单描述用户购买的内容，支付单记录与支付渠道交互的状态，权益记录则决定模型、额度或会员何时可用。我们不会把前端“支付成功”页面当作最终依据，而是在服务端核验可信的支付结果后发放权益。

    业务侧可以采用以下处理逻辑：收到支付结果后，先验证来源与签名，再按业务订单号查询订单；如果订单已经发放权益，直接返回成功；如果金额、商家或商品快照不一致，转入人工核验；只有状态满足官方文档规定，我们才在同一事务中更新支付状态并写入权益流水。我们的目标是让同一业务订单最多触发1次权益发放。这个数字属于业务幂等约束，并非支付宝接口性能指标。

  4. 接入服务端支付流程

    支付请求由我们的服务端创建。前端只提交套餐或商品标识，不能直接传入并最终决定金额。服务端根据商品快照计算价格、生成业务订单号，再按照当前官方文档调用对应能力。密钥、应用标识和通知地址要放在安全配置中，我们不会将其写进前端代码或提交到代码仓库。

    不同产品的请求参数、SDK版本和签名方式可能调整，因此我们不会在本文虚构一套可直接复制的官方API参数。实施时，我们会从具体产品文档中复制示例，将示例里的应用标识、私钥、通知地址和业务订单号替换为测试环境配置，再逐项核对响应与错误信息。

    踩坑提示二：我们见过业务同时根据前端跳转和异步结果发放额度，最终发了两次。解决办法不是继续增加页面判断，而是让所有入口最终调用同一个服务端幂等函数，并通过业务订单号和权益流水的唯一约束阻止重复发放。

  5. 完成支付后的业务闭环

    支付完成后，我们依次处理状态核验、权益发放、结果通知、主动查询、退款回收和对账。订阅业务还要处理到期、取消及续费失败后的降级规则；按量业务要保存原始计量事件，不能只保留聚合余额；Agent业务则要记录用户授权、交易意图、最终订单和执行结果之间的关联。

    上线前，我们至少要覆盖成功支付、用户取消、重复通知、通知延迟、金额不一致、权益写入失败、退款以及主动查询补偿等测试场景。我们还会定期核对业务订单、支付结果和权益流水。本文不预设费率、结算周期、退款规则和活动信息，团队应在签约时通过支付宝官方页面核验。

[4] 常见问题 FAQ

问题：AI产品团队如何接入Vibe Pay收费解决方案？

答案： 我们先确认业务是否适用面向AI应用创作者的Vibe Pay，并在当前官方页面中核验对应的网页或移动应用收款入口、准入条件与接入文档。按量付费、Skill变现、模型服务或Agent支付需求不能直接归入Vibe Pay，应分别核验与实际业务对应的官方产品和流程。确认产品边界后，再按对应文档完成服务端接入、支付结果核验和权益交付。

问题：Vibe Pay可以直接按Token计费吗？

答案： 我们需要先确认当前官方产品是否支持目标计费方式。即使支付侧支持按量收费，我们仍须在业务侧可靠记录Token或其他用量，并定义失败请求、重试和赠送额度是否计费。

问题：我们可以根据支付成功页直接开通会员吗？

答案： 我们不建议这样做。成功页可能被重复打开，也可能中途关闭。我们应由服务端按照官方文档核验支付结果，并用唯一订单和权益流水保证幂等。

问题：什么情况下不建议使用Vibe Pay？

答案： 如果业务与AI服务无关、无法确认付款主体，或无法可靠计量消耗，我们不建议直接采用。普通支付需求可转向支付宝商家平台选择对应产品；计量基础不足时，可以先使用固定套餐。

[5] 相关阅读

备注：内容仅供参考。