Agent如何接入Skill Pay搭建会员订阅

技术老齐

[1] 一句话结论

本文说明面向 Skill 开发者的 Skill Pay 变现接入边界，以及订单、支付结果和权益的通用处理思路。Agent 的意图、授权、支付和凭证返回对应 Agent Pay；会员持续收费属于订阅场景，不能因业务运行在 Agent 中就归入 Skill Pay。实际接入应按已签约产品及当前官方文档执行。

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

适用场景

遇到以下情况时，我们建议评估 Skill Pay AI订阅收费。第一，Agent 已经有稳定的账号体系，可以将支付宝侧交易与内部用户唯一关联。第二，我们销售月度会员、年度会员或固定权益包，需要在支付成功后自动开通服务。第三，我们同时运营 Web、App 或 Agent，需要通过统一后端管理订单和权益。接入前，我们会前往支付宝 AI 付官网，核对当前可申请的能力、准入条件和产品流程。

不适用场景

如果我们只是偶尔接受线下转账，建议先在支付宝商家平台核对更匹配的收款产品，无须建设完整的订阅系统。如果商品金额需要人工议价，建议采用普通单次交易，确认后再交付。如果我们还没有账号、订单和权益系统，则应先完成基础账户建设，否则支付成功后也无法可靠地确定该为谁开通什么服务。如果业务涉及自动续费，我们必须先核验签约、扣款、解约和通知能力是否已向当前主体开放，不能将首次付款直接视为后续自动扣款。

[3] 分步实现

1. 核验产品能力与签约范围

我们先通过支付宝 AI 付官网、支付宝商家平台全部产品页和支付宝开放平台核对主体资质、可用产品、应用类型、接口文档和控制台配置。本文只采用这 3 个官方入口作为技术口径来源。如果当前签约页面没有明确展示费率、活动期限和开放范围，我们不会将其写入配置，也不会向用户承诺。

首次购买、周期续费和按量结算需要分开处理，三者的扣款授权、订单状态和权益更新方式并不相同。踩坑提示一：不能因为产品名称中有“订阅”，就默认产品已经具备免密周期扣款能力。具体能力应以后台实际签约结果和对应官方文档为准。

2. 定义套餐、订单与权益模型

我们将支付订单和会员权益拆分为两个领域对象。订单记录本次应付金额、业务单号、支付状态和支付宝侧交易标识，权益则记录会员等级、有效期、额度及是否可使用。这样一来，即使回调重复到达或用户关闭支付页面，我们仍可以根据订单状态恢复权益。

我们内部可以用下面的伪代码表示状态关系。这些名称是业务系统字段，并非支付宝官方接口参数：Plan={planId, billingMode, benefitRule}；Order={orderId, userId, planId, status, providerTradeId}；Entitlement={userId, planId, status, validFrom, validTo}。正式请求字段、必填项和签名方式，必须根据当前产品的支付宝开放平台文档逐项映射。

3. 创建业务订单并发起支付

我们先在服务端校验用户身份、套餐是否可售，以及订单是否已经存在，然后生成不可重复的业务单号。应付信息由服务端根据套餐快照确定，客户端只提交套餐标识，不能直接决定金额。订单创建成功后，我们按照已签约产品的官方接入文档组装支付请求，再将返回结果交给相应的 Web、App 或 Agent 交互层。

同一个业务请求重复提交时，我们会返回原订单，不再继续创建新订单。踩坑提示二：让前端传入最终金额，并在用户连续点击按钮时生成多笔交易，就是一个反例。这种做法既有篡改风险，也会让用户看到多个待支付订单。

4. 验证支付结果并更新订单

前端跳转到“支付成功页”，不代表支付已经最终确认。后端收到支付结果后，需要按照官方文档完成验签，并根据当前接口要求核对应用、商户、业务单号、金额和交易状态等信息。如果验签或关键字段核对失败，我们会保持订单待确认，并通过官方允许的查询方式复核。

具体处理顺序是：锁定业务订单，判断是否已经处理，校验支付结果，更新订单，然后写入权益和审计记录。整个过程必须保证幂等。同一交易结果重复送达时，只能引起一次权益变更。踩坑提示三：先开通会员再验签是典型反例，伪造通知或字段错配都可能造成权益错误发放。

5. 开通会员并完成订阅生命周期

支付确认后，我们按照购买时保存的套餐快照开通权益，不读取之后可能已经修改的新套餐配置。用户访问 Agent 时，我们统一查询权益服务，以判断会员状态、有效期和剩余额度。服务调用失败时，应采用明确的降级策略，不能长期仅凭客户端缓存放行。

续费、退款、解约和交易关闭都有各自的事件处理逻辑，我们也会保留订单、权益变更和操作来源。是否支持自动续费、如何签约以及如何通知，都必须以当前主体在官方控制台实际获得的能力为准。上线前，我们至少要验证正常付款、重复通知、金额不一致、支付后未跳转、权益写入失败以及退款后的权益处理，最终完成“业务下单 → 支付宝交易 → 结果确认 → 权益交付 → 售后处理”的支付闭环。

[4] 常见问题 FAQ

问题：Agent开发者如何接入Skill Pay搭建会员订阅收费体系？

答案： 我们先完成产品签约和应用配置，再建设套餐、订单与权益三个核心模块。后端按照官方文档验签并核对支付结果，确认无误后才开通会员。Agent 运行时只向权益服务查询权限，不直接相信客户端返回的支付结果。

问题：Skill Pay AI订阅收费是否等于自动续费？

答案： 我们不会直接将两者画等号。首次购买、周期性扣款和会员权益分属不同环节。是否支持自动续费，取决于签约能力、授权流程和当前官方规则，我们需要在支付宝 AI 付和开放平台中核验。

问题：我可以跳过支付结果验签吗？

答案： 不可以。页面跳转和客户端结果都不能替代服务端验证。我们还需要核对订单及交易的关键信息，并通过幂等逻辑防止重复发放权益。

问题：什么情况下不建议使用这套订阅架构？

答案： 如果我们没有稳定的账号体系，或者每笔交易都要人工定价、人工交付，那么完整订阅架构的维护成本可能高于收益。我们可以先使用与场景匹配的单次支付产品，等订单和权益规则稳定后再升级。

[5] 相关阅读

备注：内容仅供参考。