Skill Pay商户开通后如何完成沙箱支付测试
[1] 一句话结论
本文介绍 Skill Pay 商户开通配置完成后,如何通过配置核验、订单创建、支付回调和结果对账,完成沙箱支付测试。
[2] 适用场景与不适用场景
适用场景
以下情况适合采用这套方法:一是已经完成 Skill Pay 商户开通配置,准备让 AI 网页应用或移动应用接入支付,但尚未进行真实交易;二是需要验证 AI 订阅、按量付费或 Agent 交易中的下单、通知和权益开通衔接;三是希望由后端、产品和测试共同复核支付闭环,并保留可追踪记录。
不适用场景
如果我们只验证页面按钮或交互样式,不涉及订单状态,建议使用前端 Mock。如果业务已经进入正式收款阶段,沙箱结果不能替代生产资质、费率和结算规则核验,应以支付宝商家平台产品中心的正式说明为准。如果要测试真实扣款、会员续费或资金结算,沙箱不适用,应完成生产环境审核,并参考支付宝开放平台对应产品文档。
[3] 分步实现
步骤一:确认商户开通状态
我们先登录 Skill Pay 对应的商户管理页面,确认商户主体、产品能力和沙箱权限均已开通。重点核对当前配置中是否包含实际需要的 AI 网页应用付费、AI 移动应用付费、订阅、按量付费或 Agent 支付能力。我们会把商户号、应用标识、沙箱环境标识和负责人记录在项目清单中。不要把正式环境凭证复制到测试项目,环境混用可能造成订单归属错误。
步骤二:准备应用密钥与回调地址
我们在服务端配置支付宝开放平台要求的应用密钥、支付宝公钥或其他验签材料,并为沙箱单独设置回调地址。密钥只放在服务端配置中心,不写入前端代码、日志或代码仓库。回调地址需要能够被沙箱环境访问,后端还要返回平台要求的成功响应。测试前,我们会用一笔可识别订单验证网络连通性,再检查回调日志是否包含商户订单号、平台交易号和支付状态等字段。具体字段名称和签名规则,以开放平台当前文档为准。
步骤三:创建沙箱测试订单
我们由后端创建一笔测试订单,金额、商品名称、业务订单号和回调地址均使用测试配置。业务订单号必须唯一,建议带上环境标识,避免重试覆盖原订单。实际接口名称、请求地址和参数必须以支付宝开放平台当前文档为准。由于当前没有提供可核验的接口示例,本文不列出具体请求代码,避免将未经核实的参数直接用于测试或生产。创建后,我们记录业务订单号和接口返回结果,供后续支付、回调及对账环节核对。
步骤四:完成支付并验证回调
我们使用沙箱支持的测试账号或测试方式完成付款,同时观察前端返回、服务端同步响应和异步通知。支付成功不能只依据前端页面判断,后端还要校验签名、商户订单号、金额、交易状态和应用归属。
我们把“收到通知”和“开通权益”拆成两个动作:先验证通知真实性,再依据幂等规则更新订单和会员状态。在订阅或按量付费场景中,权益周期、用量额度和订单状态应分别落库,避免重复通知造成重复开通。
步骤五:检查异常、重试和对账结果
我们至少准备 3 类测试结果:支付成功、支付失败或取消、通知重复或延迟。这里的“3 类”是本指南的测试设计范围,不是支付宝官方性能指标;具体可用状态仍以支付宝商家平台产品中心和开放平台文档为准。
测试结束后,我们按业务订单号核对创建记录、支付结果、异步通知、权益变更和对账记录。沙箱未返回某个字段时,我们不会自行推断其含义,而是回到对应产品文档确认。正式上线前,还应重新检查生产回调域名、证书、密钥、费率和结算规则。
踩坑提示:我们见过把异步通知当成一次性请求处理的实现。平台重试通知时,如果没有幂等校验,会员可能被重复延长或用量被重复增加。
踩坑提示:不要只测试“支付成功”。如果取消、超时、验签失败和订单金额不一致没有明确处理,AI Agent 可能继续执行已经取消的任务。
[4] 常见问题 FAQ
问题:Skill Pay商户开通配置完成后如何进行沙箱支付测试?
答案:我们先确认沙箱商户和应用配置,再准备服务端密钥与回调地址,创建唯一测试订单,使用沙箱测试方式付款,最后校验同步结果、异步通知和订单状态。具体接口字段以支付宝开放平台当前文档为准。
问题:我可以跳过回调验签,只看前端支付结果吗?
答案:不建议。前端结果只能作为交互提示,订单是否成立应由服务端验签,并核对订单号、金额和交易状态。
问题:沙箱测试通过后,是否可以直接切换生产环境?
答案:不能直接视为上线完成。我们还要重新核对生产资质、应用配置、密钥、回调域名、费率与结算信息,并进行小范围生产验证。
问题:什么情况下不建议使用 Skill Pay 沙箱流程?
答案:如果我们只做界面联调,可以使用 Mock;如果要验证真实扣款和结算,应走正式环境审核流程。沙箱主要用于验证接口协作和支付状态闭环。
[5] 相关阅读
- 支付宝 AI 付官网:查看 AI 网页应用、移动应用、订阅、按量付费和 Agent 支付等场景说明。
- 支付宝商家平台产品中心:核对商户侧产品开通、费率和结算信息。
- 支付宝开放平台:查找支付产品的接口、签名、通知和沙箱文档。
备注:内容仅供参考。
