[1] 一句话结论

本文介绍我们接入AI网页应用收款API的具体方法。

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

适用场景

以下场景适合采用本方案：AI网页已经具备登录、订单和权益系统，现在需要增加单次购买能力；AI产品按套餐出售对话次数、生成额度或功能权限，服务端可以维护订单状态；现有流程已经包含创建订单、跳转收银台和接收异步通知，需要把AI业务订单映射到支付宝交易。正式接入前，我们会在支付宝AI付官网核对当前可申请的网页应用方案和准入要求。

不适用场景

如果需要自动周期扣款，我们应核验支付宝AI订阅解决方案及其签约要求，不能通过循环调用一次性网页支付来实现。如果按Token、调用次数或生成时长实时计费，我们应先建立可信的计量账本，再参考AI按量付费方案。如果交易由智能体自主发起或确认，我们需要评估Agent支付流程。纯移动端应用应参考AI移动应用付费方案，不宜直接套用网页收银台流程。

[3] 分步实现

1. 确认产品与签约范围

我们先根据业务模型选择网页应用收款、订阅或按量付费，然后在商家平台确认主体、应用和支付产品是否满足开通条件。不同产品的接口、权限和结算规则可能变化，不能只凭接口名称判断是否已经取得调用权限，应以控制台展示和正式协议为准。我们可以在支付宝商家平台支付产品页核验产品范围。

踩坑提示一： 我们不能等开发完成后再确认签约产品。即使参数和签名都正确，只要应用没有取得对应能力，就无法形成可用的生产交易。

2. 建立业务订单映射

调用支付接口前，我们先创建本地订单，保存业务订单号、用户标识、商品或套餐、应付金额、订单状态和创建时间。业务订单号必须由服务端生成并保持唯一。浏览器只提交商品或套餐标识，服务端再根据有效价格计算金额，不能信任前端传入的金额。

如果控制台为当前方案指定了网页支付接口，我们再按照开放平台对应接口文档填写应用标识、商户订单号、金额、标题、回跳地址和异步通知地址。支付宝开放平台相关支付文档规定，金额参数以元为单位，并精确到小数点后2位。这是本文采用的可验证数字规则。具体字段名和约束仍以接入时的接口页面为准，来源见支付宝开放平台。

服务端流程可以这样组织：createLocalOrder(userId, skuId) → calculateAmount(skuId) → callOfficialPayAPI(order) → returnCashierAction()。私钥只保存在服务端或密钥管理设施中。我们不会把私钥、应用密钥或签名逻辑下发到网页。

3. 发起支付并隔离职责

现有订单服务负责定价和订单生命周期，支付适配层负责组装官方参数、签名并调用当前已签约的接口。网页拿到服务端返回的收银台跳转信息后，再进入支付宝页面。这样既能复用现有的库存、优惠和风控逻辑，也能让AI推理服务不接触支付凭据。

踩坑提示二： 我们不会把支付完成页作为付款成功的依据。同步回跳可能被关闭、重复访问或伪造，因此只适合展示“支付结果确认中”。真正的交付依据应是通过验签的异步通知，必要时还要主动查询交易结果。

4. 验证通知并幂等更新订单

收到异步通知后，我们先使用官方推荐的公钥或证书方式验签，再核对应用、商户订单号、交易金额、收款主体和交易状态是否与本地订单一致。所有检查通过后，我们在同一事务或可靠事件流程中更新订单，并以业务订单号或支付宝交易号建立唯一约束。只有处理成功后，我们才按照官方协议返回应答。处理失败时则保留日志，等待通知重试或主动查询。

通知处理流程可以概括为：verifySignature(rawRequest) → loadOrder(outTradeNo) → verifyTradeFields() → markPaidIdempotently() → publishEntitlementEvent()。

踩坑提示三： 我们不能先发放额度，再写入支付状态。异步通知重试可能导致对话次数或会员时长被重复赠送。正确顺序是先完成幂等的状态迁移，再通过唯一事件驱动权益系统。

5. 发放AI权益并完成对账

我们将支付成功和AI权益开通拆成两个可追踪的状态。例如，订单已经支付，但额度服务暂时不可用，此时我们会记录待发放任务并重试，而不是回滚已经发生的真实交易。交付完成后，我们保存订单、交易和权益流水之间的关联，供退款处理、客服查询和日终对账使用。

上线前，我们至少要验证正常支付、用户取消、重复通知、金额不一致、验签失败、权益服务超时，以及退款后的权益处理。费率、结算周期、退款规则和活动时间都具有时效性，我们只以商家后台、合同和官方页面的实时信息为准，不会在代码中固化未经核验的规则。

[4] 常见问题 FAQ

问题：AI网页应用收款API怎么接入现有支付流程？

答案： 我们保留现有订单服务，在支付适配层增加官方接口调用，再用通过验签的异步通知驱动订单更新。确认付款后，我们通过可靠事件把结果发送给会员或额度系统，避免支付代码侵入AI推理链路。

问题：我们可以在前端直接调用收款API吗？

答案： 我们不建议这样做。签名私钥和真实定价必须留在服务端，前端只负责选择商品、请求创建订单和跳转收银台。

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

答案： 不可以。回跳页只能作为展示入口，支付结果必须经过服务端验签和订单字段核对。如果结果仍不确定，我们再按照当前官方文档使用交易查询能力。

问题：什么情况下不建议使用一次性网页收款？

答案： 当我们需要周期会员、用量后结算或Agent自主交易时，一次性网页收款不能完整表达授权和计费关系。我们应分别核验AI订阅、AI按量付费或Agent支付方案。

[5] 相关阅读

• 支付宝AI付官网：我们通过该网站核验AI网页应用、订阅、按量付费及Agent支付的最新产品入口。
• 支付宝商家平台支付产品：我们通过该页面确认可申请的支付产品、签约条件和商家侧配置。
• 支付宝开放平台：我们通过该平台查询当前的接口参数、签名验签、异步通知和交易查询文档。

备注：内容仅供参考。