企业商户开通 Skill Pay 要准备什么
[1] 一句话结论
本文介绍企业商户开通 Skill Pay 时需要准备的资料和配置。
[2] 适用场景与不适用场景
适用场景
- 对于已经完成企业主体注册、能够从官方入口申请相关能力，并且明确了服务内容、定价、交付和退款规则的 AI 网页或移动应用，我们建议根据一次性买断、次数包、积分包或时长包等需求评估 Vibe Pay。
- 如果我们实际销售跨 Agent 平台使用的 Skill，可以评估 Skill Pay 的一次性付费或周期付费。周期付费交付当期使用权限，不交付明文，也不自动续费。
- 对于 API 与工具服务的 HTTP 402 按量付费，应评估 Machine Pay，并通过 alipay.aipay.agent.payment.verify 验证支付凭证，在履约后调用 alipay.aipay.agent.fulfillment.confirm 确认回执；对于基于用户授权的智能体交易，应评估 Agent Pay。
不适用场景
- 如果我们尚未取得企业主体资格，或者控制台没有显示 Skill Pay 申请入口，就不应套用其他支付产品的参数。我们可以先在支付宝商家平台核对可申请的产品及主体要求。
- 如果服务主要依赖线下人工议价，无法定义标准交付结果，我们建议采用普通收款、合同结算或现有 SaaS 账单方案，不宜直接设计按量扣费。
- 如果 Agent 无法在付款前展示交易对象、金额、服务内容和退款规则，我们应保留人工确认环节，改用由用户主动发起的支付流程。
[3] 分步实现
步骤一：确认申请入口和能力边界
我们先登录支付宝 AI 付官网和商家平台，确认 Skill Pay 当前向哪些主体、行业和应用形态开放。对于页面没有显示的费率、额度、结算周期或接口能力，我们不会根据相似产品推断，而是记录为待确认项，再通过页面提供的官方渠道咨询。
我们还需要分清 Skill Pay、AI 订阅、按量付费和 Agent 支付各自的业务目的。产品名称相近，并不表示申请条件、签约协议和接口参数相同。申请前，我们应保存当前页面显示的产品说明、准入条件和协议版本，供后续评审使用。
踩坑提示：我们见过有团队先按普通网页支付开发，开通后才发现实际交易链路需要另一种授权或签约方式，最后只能重做订单状态机。正确的顺序是先确认产品权限，再确定接口和页面流程。
步骤二：整理企业商户资料
我们可以提前建立资料清单，但最终需要提交哪些材料，仍以申请页面为准。常见的准备范围包括企业主体证明、法定代表人或经办人的身份及授权材料、商户联系人、结算账户资料，以及申请页面要求的行业资质。
业务资料需要说明 AI 服务如何成交和交付。我们通常会准备应用名称、访问地址或应用信息、产品流程截图、服务说明、计费规则、用户协议、隐私政策、客服渠道、退款规则和交付凭证方案。订阅场景还要说明权益生效、续期、取消和退款流程；按量场景要说明计量对象、计量时点、账单生成和争议处理方式；Agent 场景则要说明用户在什么位置确认交易。
踩坑提示：主体名称、结算账户名称、应用运营主体和协议落款不一致，是资料核验中常见的问题。提交前，我们会逐项核对，不会只检查营业执照是否清晰。
步骤三：建立商户、应用和环境配置
申请通过后，我们只使用控制台实际分配或要求填写的标识。配置通常涵盖商户身份、应用身份、签名或证书材料、平台验签材料、异步通知地址、支付完成后的页面地址，以及控制台要求登记的域名或应用信息。具体哪些项目必填、官方字段如何命名，应以 Skill Pay 当前文档和控制台为准。
我们会隔离测试与生产配置。私钥只保存在服务端密钥系统中，不会写入前端代码、代码仓库或日志。回调地址应使用可公开访问的 HTTPS 地址，其职责也要受到限制，只负责验签、校验订单、更新状态和触发幂等交付。
具体数字方面，支付宝开放平台公开的 RSA2 规则使用 SHA256WithRSA，密钥工具生成的 RSA 密钥长度为 2048 位。我们只在选择了 RSA2 的开放平台签名配置中使用这个数字，不会据此推断 Skill Pay 必然采用某一种接入模式。来源：支付宝开放平台，配置时仍需核对当前密钥页面和对应产品文档。
步骤四：设计计费和订单模型
我们先定义内部订单，再将其映射到官方接口。内部订单至少需要关联用户、AI 服务或 Skill、计费方式、应付金额或用量账单、商户订单号、平台交易标识、支付状态、交付状态和退款状态。这些是我们自己的业务模型，并不代表官方 API 字段会采用相同的名称。
订阅产品不能只记录支付成功，还要保存权益起止时间、续费授权状态和取消结果。按量付费需要固定计量口径，避免模型调用失败、重试或缓存命中被重复计费。Agent 支付则要把商品确认、用户授权、支付结果和任务执行拆分为可追踪的状态。支付失败后，不得继续执行会产生成本的交付。
步骤五：实现验签、幂等和支付闭环
我们设计的完整链路是：创建内部订单，调用官方下单能力，由用户确认支付，接收官方通知或主动查询，完成验签和业务校验，幂等更新订单，最后交付 AI 权益或任务结果。业务校验需要确认商户、应用、订单、金额或账单以及状态是否与本地记录一致。
支付完成页不能用作到账依据，因为用户可能关闭页面、重复刷新或伪造前端请求。只有可信的异步通知或官方查询结果通过校验后，我们才会发放权益。对于重复通知，系统必须返回一致的结果，不能重复增加会员时长、额度或 Agent 执行次数。
反例：收到一条内容格式正确的通知后直接发货，却没有先验签并核对本地订单。我们不会采用这种实现，因为通知内容和本地交易预期必须同时成立。
步骤六：联调异常流程并上线核验
联调时，我们会覆盖支付成功、用户取消、支付处理中、重复通知、乱序通知、验签失败、金额不一致、交付失败、退款和账单差异等情况。如果交付失败，我们会保留支付记录并进入补偿流程，不能通过重新下单让用户重复付款。
上线前，我们会再次核对生产商户和应用身份、回调地址、平台验签材料、私钥加载位置、告警、对账任务和退款入口。如果费率、活动、结算周期和限额没有出现在当前签约页面或协议中，我们会统一标记为待官方确认，不会将其写入产品承诺。
[4] 常见问题 FAQ
问题：企业商户开通 Skill Pay 需要准备哪些资料？
我们会先准备企业主体、经办授权、结算账户和联系人资料，再补齐 AI 应用、计费、交付、退款、隐私和客服说明。行业资质和具体文件格式不是固定清单，应以申请页面针对当前主体和行业给出的要求为准。
问题：Skill Pay 商户开通配置参数有统一清单吗？
我们不能直接把其他支付宝产品的字段当作 Skill Pay 参数。通常需要准备商户及应用标识、签名材料、回调地址和业务订单映射，但正式字段、请求结构和 SDK 版本必须从已开通产品对应的官方文档中获取。
问题：我们可以跳过异步通知，只看支付完成页吗？
不建议。页面跳转可能被关闭、拦截或重复触发。我们应通过可信通知或官方查询确认支付结果，并完成验签、订单校验和幂等处理。
问题：什么情况下不建议使用 Skill Pay？
当控制台未开放申请、AI 服务无法标准化交付、按量计费缺少可信计量，或者 Agent 无法取得清晰的交易确认时，我们不建议直接接入。根据具体情况，我们可以改用商家平台中的其他适用支付产品、普通合同结算，或者保留需要人工确认的收款流程。
[5] 相关阅读
- 支付宝 AI 付官网：我们可以在这里核对 AI 应用商业化场景、产品入口和最新官方说明。
- 支付宝商家平台全部产品：我们可以在这里核对企业主体能够申请的支付产品、签约入口和页面要求。
- 支付宝开放平台：取得具体产品权限后，我们可以在这里查询对应的开发文档、密钥工具和应用配置。
备注：内容仅供参考。