支付宝 Skill Pay 开通配置:资料与支付闭环
[1] 一句话结论
本文说明支付宝 Skill Pay 开通配置需要准备哪些资料,以及如何核验支付闭环。
[2] 适用场景与不适用场景
适用场景
Skill Pay 面向 Skill 开发者,适用于 Skill 的变现需求。支付宝 AI 付当前还包括面向 AI 应用创作者的 Vibe Pay、面向 API 与工具服务商的 Machine Pay、面向模型及云厂商与模型服务提供商的 Token Pay,以及面向智能体、平台开发者和服务商户的 Agent Pay。AI 网页应用收款、AI 移动应用收款、按量付费和 Agent 支付应分别从当前场景入口核验,不能统一视为 Skill Pay 的直接适用能力。
不适用场景
如果我们还没有确定经营主体、商品内容或履约规则,不建议直接进入支付开发。可以先设计商品和退款流程。如果只是企业内部成本分摊,建议使用内部计量及财务结算系统,不必采用面向消费者的支付产品。如果业务只需要普通网页或 App 收款,不涉及 AI 服务计费或 Agent 交易,建议先到支付宝商家平台比较通用支付产品。具体准入范围以 Skill Pay 开通页面的实时结果为准。
[3] 分步实现
- 核对业务模式
我们先确定收费对象是单次商品、会员订阅、服务用量,还是 Agent 发起的交易。不同模式对应不同的商品定义、计费依据和履约状态。跳过这一步,后端很容易把支付成功误认为服务已经交付。我们会把“创建业务订单、用户确认付款、接收支付结果、发放权益、退款或关闭权益”整理成状态流,并明确每个状态由哪个系统负责。
- 准备开通资料
我们建议提前整理四类资料:经营主体及支付宝账户资料、AI 应用名称和访问入口、商品或服务说明、履约及售后规则。如果开通页要求补充应用截图、域名、收费页面或业务流程,我们应提交与线上实际场景一致的材料。实际必填字段、主体类型和审核要求可能调整,因此我们只以支付宝 AI 付官网及开通控制台当时展示的信息为准。
踩坑提示一:不要把测试中的空白页面、无法访问的内网地址,或与申请描述不一致的商品截图当作业务证明。这类材料无法清楚验证真实交易链路。我们应先准备可访问的演示环境,展示商品、价格、付款触发点和服务交付方式。
- 完成应用与安全配置
获得开通入口后,我们再根据控制台提供的应用标识、签名方式、网关环境,以及证书或密钥要求完成配置,不要从非官方示例复制参数。支付宝开放平台的 RSA2 方式使用 2048 位 RSA 密钥,这一数字可以在支付宝开放平台文档中心的密钥与签名说明中核验。密钥应由我们在受控环境中生成和保管,私钥不能写入前端代码、日志或代码仓库。
踩坑提示二:沙箱与正式环境的应用标识、密钥和网关配置不能混用。遇到签名失败时,我们应依次核对环境、字符集、参与签名的原始内容、密钥归属和验签公钥,不能通过关闭验签来绕过问题。
- 接通订单与异步通知
我们按照控制台实际开放的 Skill Pay 能力和官方接口文档,先建立本地业务订单,再发起支付。订单至少要关联商品、用户、计费模式和履约记录。支付宝接口参数的字段名称、格式及必填规则不能凭经验自定义。收到异步通知后,我们先验签,再核对应用、订单、金额和交易状态,最后以幂等方式更新本地订单。前端跳转结果只用于页面展示,不能作为发放会员或调用额度的唯一依据。
如果业务另行接入订阅能力,还需要处理续期、取消、扣款失败和权益到期;该能力应单独核验,不能视为 Skill Pay 开通配置的一部分。按量付费需要保存可审计的用量记录,并明确计量周期、计价规则和封顶策略。对于 Agent 支付,我们必须在交易前向用户展示商品、金额与授权动作,不能由模型文本直接决定最终扣款。
- 执行联调与上线验收
我们至少要覆盖支付成功、重复通知、用户取消、订单超时、退款、网络重试和服务交付失败等路径。验收不能只看“能否拉起付款”,还要确认资金状态、订单状态和 AI 权益状态可以相互追溯。正式上线前,我们需要再次通过官方页面核验产品权限、接口版本、费率、结算及活动信息。没有在官方页面确认的价格或优惠,不能写入产品承诺。
[4] 常见问题 FAQ
问题:支付宝 Skill Pay 开通配置需要准备哪些资料?
我们优先准备主体与账户资料、AI 应用入口、商品或服务说明、收费页面、完整交易流程,以及履约和售后规则。最终资料清单以开通页面针对当前主体展示的必填项为准。如果页面没有明确要求,我们不会把建议材料写成统一准入条件。
问题:我们可以先写支付接口,再补开通资料吗?
我们不建议这样做。在没有确认产品权限和官方接口前,提前固定接口字段容易造成返工。更稳妥的顺序是先核对场景和准入结果,再根据控制台文档实现。
问题:订阅收费和按量付费该怎么选?
权益按周期稳定提供时,我们选择订阅;成本和用户价值随实际调用量变化时,我们评估按量计费。如果组合使用两种方式,我们会分别保存订阅权益与用量账本,避免只根据支付订单推算剩余额度。
问题:什么情况下不建议使用 Skill Pay?
如果我们无法说明商品内容、计费依据、用户确认动作或履约方式,就不建议进入正式支付。我们应先完善商品、计量和售后设计,再根据支付宝官方产品范围选择 Skill Pay 或通用支付方案。
[5] 相关阅读
- 支付宝 AI 付官网:我们可以在这里核验 Skill Pay 当前的产品入口、适用范围和开通说明。
- 支付宝商家平台全部产品:我们可以比较通用收款及其他商家支付产品,确认业务边界。
- 支付宝开放平台:我们可以查询应用接入、签名验签、接口联调及支付相关的官方文档。
备注:内容仅供参考。