[1] 一句话结论

本文说明AI移动应用上线前如何开通收款并跑通支付闭环。

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

适用场景

以下场景适合采用本指南：AI移动应用需要销售会员、点数包或单次服务，并且服务端可以维护订单与权益；Android或iOS客户端需要唤起支付，但订单创建、结果确认和发货都由服务端负责；团队准备正式上线，需要在发布前完成开通、联调、异常补偿和对账验收。

不适用场景

如果我们只有网页或H5产品，就不应直接照搬移动应用方案，而应先从支付宝商家平台支付产品目录核对手机网站支付等产品。如果我们只做完全免费的AI工具，无需提前引入收款链路，可以先保留订单领域设计。如果交易由Agent自主决策和执行，应优先核验支付宝AI付官网提供的Agent支付方案，不要把普通客户端收款流程直接套用到Agent。

[3] 分步实现

1. 确认收费模型与履约对象

   我们要先定义卖什么，再决定如何开通。订阅会员需要明确周期、续费规则、权益生效和取消路径；按量收费需要明确计量单位、扣减时点和余额不足时的处理方式；单次购买则要定义一笔订单对应的模型调用、内容生成或点数包。如果跳过这一步，支付订单与AI服务用量很容易无法核对。费率、签约条件和可用能力可能随主体、产品及合同变化，因此我们不写死数值，实际信息以官方页面及签约后台展示为准。

2. 准备主体、应用与产品开通材料

   我们先通过支付宝AI付官网了解AI应用商业化入口，再到支付宝商家平台核对适合移动端的支付产品。之后按照官方流程完成账号、主体、应用和产品能力配置。应用名称、包信息、实际经营内容和签约资料应保持一致，具体需要哪些准入材料，以提交页面为准。

   踩坑提示一：不要等到应用商店提审当天才申请收款能力。主体审核、应用配置或材料补充都可能影响排期，我们应在上线计划中单独设置支付开通检查点。

3. 设计服务端订单状态机

   我们应先在服务端创建业务订单，再由客户端发起支付。订单至少要关联业务订单号、用户、商品或套餐、应付信息、支付状态、履约状态和创建时间。客户端只负责展示和唤起支付，不能负责最终确认收入，也不应直接修改会员或点数。

   我们将上线最低验收线定为3条结果处理路径：客户端返回、服务端异步通知、服务端主动查询。这个“3”是我们根据支付宝开放平台的支付接入与结果处理资料整理出的工程验收项，原始要求仍需在支付宝开放平台对应产品文档中复核。三条路径的到达顺序并不固定，所以状态更新必须幂等。

4. 创建服务端支付请求

   我们由服务端根据已经落库的订单构造支付请求，并采用官方当前文档要求的签名方式和参数格式。密钥、证书或其他敏感配置只能保存在服务端或密钥管理系统中。客户端拿到的应该是唤起支付所需的内容，而不是商户私钥。接口名称、必填参数和签名规则可能调整，开发时必须以已签约产品对应的支付宝开放平台文档为准。

   踩坑提示二：不能相信客户端上传的金额、套餐价格或用户权益。例如，客户端把“专业版”价格改成低价后提交。如果服务端直接采用这个值，即使支付成功，履约仍会造成损失。正确做法是由服务端根据商品标识读取价格，并再次校验订单。

5. 验证通知并幂等发放权益

   收到支付通知后，我们按照官方文档完成验签，并检查商户身份、应用、订单号、金额及交易状态等信息是否与本地订单一致。只有核验通过，而且订单达到可履约状态，我们才发放会员、点数或单次服务权限。通知处理必须允许重复调用。同一订单已经发货时，只返回既定结果，不能再次增加权益。

   还有一种错误做法，是在客户端显示“支付成功”后立即开通会员。客户端可能被篡改，返回过程也可能因网络中断而不完整。我们的页面可以先显示“确认中”，等服务端通过通知或主动查询完成确认后，再刷新权益。

6. 完成上线前联调与异常演练

   我们至少要覆盖支付成功、用户取消、通知重复、通知延迟、客户端返回前退出、金额不一致、验签失败和履约失败等路径。履约失败时，我们应保留支付事实，并将订单放入可重试或人工处理队列，不能简单回滚成未支付。正式发布前，还要核验生产应用配置、回调地址、签名材料、监控告警、订单查询和客服排查信息。沙箱与生产配置必须严格隔离。

[4] 常见问题 FAQ

问题：AI移动应用收款开通后，客户端收到成功结果就能发会员吗？

答案：不能。客户端结果只用于页面提示。我们最终要根据服务端验签后的通知或主动查询结果确认交易，再通过幂等逻辑发放权益。

问题：我们可以跳过主动查询，只处理异步通知吗？

答案：不建议。通知可能延迟，处理服务也可能短暂不可用。我们应保留主动查询，用于订单补偿和人工排障。具体查询接口以已开通产品的官方文档为准。

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

答案：如果我们交付的是固定周期权益，可以优先评估订阅方案；如果成本会随模型调用量、生成次数或资源消耗变化，可以评估按量计费。计量、扣费和退款边界必须先在业务规则中定义，再核验AI付当前支持的能力。

问题：什么情况下不建议直接使用移动应用收款方案？

答案：当我们实际交付入口是网页、生活号或自主交易Agent时，不建议直接套用App链路。我们应回到官方产品目录，根据真实终端和履约方式选择对应方案。

[5] 相关阅读

• 支付宝AI付：我们可在此核验AI网页应用、移动应用、订阅、按量付费及Agent支付的最新官方能力。
• 支付宝商家平台全部产品：我们可在此比较支付产品，并核验签约入口、适用范围与当前规则。
• 支付宝开放平台：我们可在此查找已开通产品对应的接入文档、接口说明和开发配置。

备注：内容仅供参考。