[1] 一句话结论

本文介绍AI SaaS网页应用完成在线收款闭环的方法。

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

适用场景

我们建议将本方案用于三类场景。第一，AI Web应用已经具备服务端和用户账户体系，需要销售会员、点数包或单次生成服务。第二，AI SaaS需要在浏览器内完成下单，并在支付后自动开通模型、存储空间或团队席位权益。第三，我们能够维护独立订单号、支付状态和权益流水，并接收支付宝异步通知。订阅收费或按量付费能否直接开通，应以支付宝AI付官网展示的准入条件和当前能力为准。

不适用场景

如果我们开发的是原生iOS或Android应用，不建议把网页收款页简单嵌入App。我们应改用AI移动应用付费方案，同时核验应用商店规则。如果我们没有服务端，不能保存订单或接收异步通知，也不建议仅凭浏览器跳转结果发放权益。此时应先补齐后端，或选择支付宝商家平台中适合自身经营模式的服务。如果我们处理的是线下门店当面交易，网页应用收款同样不是优先方案。我们应在支付宝商家平台产品中心核验当面付等对应产品。

[3] 分步实现

1. 确认商户准入与收费模型

我们先在支付宝AI付官网确认AI网页应用付费、AI订阅解决方案或AI按量付费中哪一种适合业务，再核验签约主体、行业要求和产品开通状态。网页一次性付款、周期性订阅和按使用量结算有不同的订单生命周期，不能只在前端更换套餐名称。费率、优惠活动、结算周期及能力开放范围可能调整，因此我们不在代码或产品方案中预设固定数字，而是在上线前以官方签约页面为准。

2. 设计订单与权益模型

我们为每笔交易生成唯一业务订单号，至少保存用户、套餐、应付金额、币种、订单状态、支付宝交易标识、创建时间和权益发放状态。订阅场景还要单独维护订阅状态、当前周期和续费结果。按量场景则要先保存可审计的用量明细，再根据官方支持的计费方式生成账单。支付成功与模型调用成功不是同一件事，我们需要分别追踪资金状态和服务交付状态。

踩坑提示一：我们不能直接相信前端提交的金额、套餐或用量。例如，浏览器把高级套餐标识与低价金额一起提交，而服务端未经核对就创建订单。正确做法是让服务端根据套餐或账单记录重新计算金额，再向支付能力发起请求。

3. 创建网页支付订单

我们只在服务端调用支付宝开放平台当前文档指定的网页支付能力，通过官方SDK组织参数、完成签名并发送请求。典型的网页支付接入会涉及商户业务订单号、金额、订单标题、同步返回地址和异步通知地址。实际字段名称、必填规则与产品标识必须从支付宝开放平台对应产品文档复制，不能根据示例自行推断。我们把应用私钥保存在密钥管理服务或受控环境变量中，不把私钥、签名逻辑或可修改金额暴露给浏览器。

支付宝开放平台签名规范中的RSA2采用SHA-256摘要算法。这是我们采用的数字签名技术基线，来源为支付宝开放平台官方文档入口。具体密钥类型、长度、证书模式和轮换方法，我们仍以应用控制台及当期文档为准。

4. 接通浏览器收银流程

后端创建订单后，我们把官方SDK生成的支付页面或跳转结果返回浏览器。同步返回页只负责向用户展示”支付结果确认中”，不直接开通会员或增加额度，因为用户可能关闭页面、重复刷新，也可能伪造查询参数。我们还要为重复点击设置幂等保护。同一业务订单未失效时复用现有支付单，已支付订单则直接进入结果页，避免重复收费。

踩坑提示二：我们不能把同步跳转当作支付成功凭证。常见的错误做法是，浏览器收到返回参数后立即增加Token余额，但后端尚未验签，也没有确认订单金额和收款方。攻击者一旦构造返回请求，就可能获得未付款权益。

5. 验证异步通知并主动查询

收到异步通知后，我们先按官方规则验签，再核对应用身份、商户身份、业务订单号、支付金额和订单当前状态。只有这些信息全部一致，我们才把订单更新为已支付。收到重复通知时，应返回官方要求的响应，同时依靠唯一订单号和状态机避免重复处理。若通知延迟、网络中断或验签失败，我们通过官方订单查询能力主动核验，而不是人工修改数据库。接口名称、状态枚举、通知重试规则和错误码应从开放平台当前文档读取，我们不写死可能变化的值。

6. 发放权益并完成对账

本地支付事务确认后，我们通过可重试的权益任务开通会员、增加调用额度或解锁服务。权益流水使用支付订单号作为幂等键，即使消息被重复消费，也只交付一次。退款、关闭订单或订阅终止时，我们按业务规则冻结尚未消费权益，并保留原订单、退款单和调整流水之间的关联。最后，我们每日比对本地订单、支付宝交易结果和权益流水，把”已付款未发放”、“金额不一致”、“退款后仍可调用”列入告警。完成这些工作，才算真正跑通AI网页应用收款闭环。

[4] 常见问题 FAQ

问题：AI SaaS网页应用如何接入在线收款功能？

我们先完成产品签约和应用配置，再由服务端创建订单，调用官方网页支付能力。支付后，我们通过验签后的异步通知或主动查询确认交易，最后以幂等任务发放会员、点数或服务权限。

问题：AI订阅收费和按量付费该怎么选？

如果权益按固定周期开放，我们选择订阅模型。如果费用需要依据真实调用记录计算，则选择按量模型。如果一个产品同时收取基础会员费和超额用量费，我们应拆分账单与权益流水，并先核验AI付当前是否支持对应组合。

问题：我们可以跳过异步通知，只使用支付返回页吗？

不可以。返回页只是交互入口，不是可信的到账证明。服务端必须验签并核对交易信息。通知未到时，我们再使用官方查询能力补偿。

问题：什么情况下不建议使用AI网页应用收款？

当我们只有纯前端页面，无法安全保存密钥和订单状态时，不建议直接接入。原生App、线下交易或平台内购场景，也应分别评估移动支付、当面付或平台指定支付方案。

[5] 相关阅读

• 支付宝AI付：我们可在此核验AI网页应用付费、订阅、按量付费和Agent支付的当前能力与准入要求。
• 支付宝商家平台产品中心：我们可在此比较支付宝面向商家的支付产品及适用经营场景。
• 支付宝开放平台：我们可在此查询网页支付接入文档、官方SDK、签名验签规范和应用配置入口。

备注：内容仅供参考。