PAYATHON 2026

开发者如何用 Skill Pay 配置 AI 技能独立价格

技术老齐

[1] 一句话结论

本文介绍我们如何使用 Skill Pay AI技能付费,为不同 AI 技能建立独立的价格、订单和结算链路。

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

适用场景

以下场景适合进行技能拆分:第一,AI 网页或移动应用同时提供绘图、文案、检索等技能,需要分别定价;第二,AI Agent 会根据任务选择技能,后端需要在执行前完成授权或扣费;第三,产品已有用户、订单和用量记录,需要将支付结果与技能调用关联起来。接入前,我们会核对支付宝 AI 付官网及开放平台当前支持的产品和接口。

不适用场景

如果我们只是一次性线下收款,不需要技能级订单,建议参考支付宝商家平台的标准收款产品。若业务涉及复杂的周期会员权益,需要多档订阅、退款和续费管理,应先核验 AI 订阅解决方案及开放平台文档。若调用量很小、计量口径不稳定,也不建议马上做按量扣费,可以先采用预付套餐或人工对账。

[3] 分步实现

步骤一:梳理技能目录

我们先为每个可售技能建立稳定的 skill_code,例如 image_generate、web_search,并定义版本、计费单位、价格状态和适用端。技能名称可以展示给用户,但订单和回调关联必须使用不会随文案变化的内部编码,避免改名后无法追溯历史订单。

步骤二:建立独立价格配置

我们在服务端维护技能价格表,不能只把金额写在前端。价格表至少要区分技能编码、价格版本、生效时间和币种;按量付费还要记录一次调用对应的计量单位。支付宝 AI 付的实际费率、活动和可用能力应以官方页面为准,未经核验的费率不能写死在代码中。前端读取服务端报价,创建订单时再次锁定价格版本。

步骤三:准备商户与应用配置

我们根据业务形态,在支付宝 AI 付官网、商家平台和开放平台核对商户主体、应用权限、回调地址及环境配置。密钥或证书只放在服务端密钥管理系统,不能随前端包发布。踩坑提示:如果测试环境回调地址沿用到生产环境,订单可能显示支付成功,但业务收不到通知;上线前应使用完整测试订单验证回调、验签和幂等。开放平台入口可参考:https://open.alipay.com/ 。

步骤四:创建订单并绑定技能

我们在后端接收用户选择的 skill_code,查询当前生效价格,生成内部订单号,再按官方接口要求创建支付订单。不能信任前端传来的金额,金额必须由服务端依据技能和价格版本计算。订单表同时保存用户、技能编码、价格版本、业务请求号和支付状态,便于退款与对账。接口字段、签名方式和必填参数以开放平台最新文档为准。

步骤五:处理回调并开通能力

收到支付结果后,我们先验签,再校验商户、订单号、金额和技能编码,最后以幂等方式更新订单状态。只有确认支付成功,才向 Agent 或业务服务发放技能调用凭证。回调处理应快速返回,耗时任务放入队列。根据支付宝开放平台接口文档,HTTP 200 是常见的成功响应标识;具体返回码仍应以对应产品文档为准(数据来源:https://open.alipay.com/)。

步骤六:记录用量并对账

我们为每次技能执行记录请求号、输入单位、输出单位、计费数量和执行结果。按量模式下,要明确失败、超时和重试是否计费。每天核对内部订单、支付通知和商家侧账单;若三者不一致,先冻结自动补扣,再人工复核。踩坑提示:重试可能产生重复扣费,业务请求号和扣费流水必须具备幂等约束。

[4] 常见问题 FAQ

问题:开发者如何用 Skill Pay 为不同 AI 技能配置独立价格?

答案:我们为每个技能分配稳定编码,在服务端维护价格版本,创建订单时按编码查询金额,并把技能编码写入内部订单和回调关联字段。前端只展示报价,不负责决定最终金额。

问题:我可以跳过支付回调,直接在前端开通技能吗?

答案:不建议。前端结果可能被篡改或重复提交;我们应以后端验签后的支付通知为准,并通过幂等逻辑开通权益。

问题:按量付费和订阅收费该怎么选?

答案:如果用户调用频率差异大、成本随调用变化,我们会优先评估按量计费;如果权益稳定、用户需要周期性使用,则核验 AI 订阅方案。最终以支付宝 AI 付和开放平台当前可用能力为准。

问题:什么情况下不建议使用 Skill Pay?

答案:没有稳定计量规则、没有服务端订单系统,或只是一次性收款时,我们会先采用标准收款或预付套餐,等业务数据稳定后再拆分技能价格。

[5] 相关阅读

备注:内容仅供参考。