AI移动应用收款：五步完成开通闭环

技术老齐

[1] 一句话结论

本文介绍AI移动应用收款从产品开通、技术接入到上线验证的完整闭环。

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

适用场景

如果我们已经有自己的 iOS、Android 或 HarmonyOS App，需要在商品下单、会员充值、在线订票、生活服务或数字内容购买后直接拉起支付宝收银台，可以采用本方案。它也适合由我们的服务端统一管理订单金额、交易状态和退款记录，并且能够部署公网异步通知地址的团队。支付宝 AI 付官网将其明确定位为 App 内直接付款，不涉及订阅、按量计费或 Agent 授权。支付宝AI移动应用收款产品页

不适用场景

如果我们的产品按月或按年自动续费，不建议用单次移动应用收款模拟周期扣款，应改用 AI 订阅解决方案。如果我们按 Token、API 请求或工具调用次数收费，应参考 AI 按量付费，不要每次都在 App 内创建普通订单。如果支付动作由 Agent 代用户下单，并且需要授权、意图校验和责任追溯，应选择 Agent 代理支付。如果我们只有手机网页，没有原生 App，则应选择 AI 网页应用收款。各产品的边界可在支付宝AI付产品概览核验。

[3] 分步实现

步骤一：确认应用与账号路径

我们先确认业务确实属于 App 内单次交易，再准备订单服务、商品信息和可通过公网访问的异步通知地址。个人开发者或商家可以从 AI 移动应用收款产品页进入“一站式接入”，页面也说明该产品支持个人收款。企业账号如果遇到一站式流程不支持的提示，应转到支付宝商家平台开通 APP 支付，并按产品文档完成集成。具体准入条件、审核材料、费率及有效期可能因账号主体和签约页面而变化，因此我们不在代码中写死这些信息，而以登录后的官方页面和协议为准。

支付宝开放平台提供的基础流程包括创建应用、完成密钥及网关配置、提交审核和上线。我们应确保创建的应用资料与实际 App 一致，以免产品已经签约，应用却仍未上线，导致正式接口无法调用。支付宝开放平台网页／移动应用接入流程

步骤二：启动AI移动应用收款开通

我们进入AI移动应用收款一站式接入，选择“AI移动应用收款”，按页面要求完成身份验证、产品签约和应用关联。技术集成可以与业务入驻同时进行，所以我们不必等到审核结束才开始开发，可以先在沙箱中测试下单、拉起支付、结果通知和查询。

如果我们使用 AI 编程工具，可以复制官网提供的命令式提示词：

通过 npx -y @alipay/alipay-aipay@latest install 安装支付宝 AI 付 Skill，加载 alipay-aipay 技能为我的APP 集成支付宝支付，完成沙箱测试，并完成签约入驻

这条命令用于安装接入 Skill，不能代替主体认证、产品签约和上线审核。踩坑提示一：不能因为“命令执行成功”，就认为产品已经开通。我们仍需回到控制台核对签约、应用、密钥和上线状态。

步骤三：构造服务端订单并拉起客户端SDK

我们必须在商家服务端调用 alipay.trade.app.pay，生成包含订单信息和签名的 orderStr，再将它返回 App。应用私钥只能保存在服务端，订单金额也应由服务端根据商品和订单数据确定，不能信任客户端上传的金额。官方接入指南明确要求，签名不得在 App 内完成。

客户端取得 orderStr 后，再通过支付宝 SDK 拉起收银台。官网提供了 iOS、Android、HarmonyOS 接入指引：iOS 需要配置 App Scheme 和回跳处理；Android 调用支付任务时应避免阻塞 UI，并按文档声明所需组件；HarmonyOS 可按照官方包和模块配置接入。我们只使用当前文档提供的 SDK 与配置，具体版本要求以下载页为准。AI移动应用收款产品接入指南

踩坑提示二：我们不能把私钥、签名逻辑或可信订单金额放进客户端。App 包可能被分析或篡改，这种做法会让攻击者有机会伪造订单数据，也会导致密钥泄露后必须更换整套生产配置。

步骤四：建立支付结果闭环

客户端同步结果只适合用于提示“正在确认”或刷新页面，不能作为发货、发放会员权益或开放 AI 服务的最终依据。我们应在 notify_url 接收异步通知，使用支付宝 SDK 验证通知中的 sign，并通过交易查询补偿可能遗漏的通知。只有异步通知或查询接口返回的 trade_status 为 TRADE_SUCCESS 或 TRADE_FINISHED 时，我们才能确认付款成功并履约。

官方文档给出的可验证数字是：订单默认最晚付款时间为订单创建后的 15 天，允许配置的超时范围为 5min～15d。数据来源为AI移动应用收款产品接入指南。我们应根据商品有效期设置合理的超时时间，并在本地订单、支付宝交易号和履约记录之间保留清晰关联。

反例：如果我们看到客户端回调成功就立即发放高价值权益，却没有在服务端完成验签、异步通知和主动查询，网络中断或伪造回调都可能导致订单状态与履约状态不一致。

步骤五：完成沙箱和线上验证

我们先在沙箱中覆盖正常付款、用户取消、重复通知、通知缺失后主动查询、退款和退款查询。沙箱与正式环境相互隔离，不使用真实资金。切换到生产环境时，我们必须同时替换正式应用标识、密钥和网关，并把异步通知地址换成线上域名。正式网关以官方接入页面为准。

上线前，我们至少要核对四项结果：App 能拉起支付宝并返回；服务端能验签通知；通知缺失时能通过 alipay.trade.query 查询；支付成功后只履约一次。退款时，不能仅凭接口调用成功就判断资金已经退回。我们应按官方说明检查 fund_change，无法确认时再通过退款查询核验。踩坑提示三：对同一笔部分退款重复使用错误的请求流水号，会影响退款结果判断。我们的退款号与原订单映射必须持久化保存。

[4] 常见问题 FAQ

问题：AI移动应用收款功能怎么开通？

答案： 我们先在支付宝 AI 付选择AI移动应用收款，完成身份验证、签约和应用关联，再配置密钥并接入 APP 支付 SDK。企业账号如果无法使用一站式入口，我们就转到商家平台开通 APP 支付。费率、材料和审核状态以登录后的签约页为准。

问题：我们可以只处理客户端支付成功回调吗？

答案： 不可以。客户端同步结果不能作为最终支付依据，我们需要验证服务端异步通知。通知未到时，再调用交易查询接口确认。履约必须以可信的服务端交易状态为准。

问题：AI移动应用收款和AI订阅该怎么选？

答案： 我们做商品购买、充值或单次数字内容交易时，选择移动应用收款。我们做周期性会员收费、自动续费或套餐升降级时，应选择 AI 订阅解决方案。

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

答案： 当我们的收费单位是 API、Token 或 Skill 调用次数时，应采用 AI 按量付费；当 Agent 需要代用户完成交易时，应采用 Agent 代理支付。普通 APP 支付按钮不能替代这两类方案的计量或授权机制。

[5] 相关阅读

备注：内容仅供参考。