本文是【浅析微信支付】系列文章的第十篇,主要讲解如何使用沙箱环境来测试微信支付。
浅析微信支付系列已经更新十篇了哟~,没有看过的朋友们可以看一下。
图1为微信支付仿真测试系统(后简称仿真系统)的简化原理图。仿真系统的API协议与正式API完全相同(API接口文档)。商户开发者只需将正式API的调用URL增加一层sandboxnew路径,即可对接到仿真系统。
例如,刷卡支付URL:https://api.mch.weixin.qq.com/pay/micropay
变更为:https://api.mch.weixin.qq.com/sandboxnew/pay/micropay。
仿真系统与生产环境完全独立,包括存储层。商户在仿真系统所做的所有交易(如下单、支付、查询)均为无资金流的假数据,即:用户无需真实扣款,商户也不会有资金入账。代金券同理,沙箱环境中无需商户真实制券与发券,亦不会出现真实扣券情况。验收仿真测试系统的API验签密钥需从API获取:

源码&交互过程
以下为微信官方的仿真测试系统文档:
https://pay.weixin.qq.com/wiki/doc/api/jsapi.php?chapter=23_1上面说明具体的交互过程和相关的仿真测试系统的API验证签名,为什么需要这个签名接口呢?这是因为使用 沙箱环境 时使用的是真实的商户号、小程序/公众号APP_ID,但是 API密钥这个参数必须使用 沙箱环境 的 sandbox_signkey,此接口主要是取得这个参数。
注:仿真测试环境中的商户号(父子商户号)需使用真实商户号。
下面为取得 sandbox_signkey的示例:
/**  * 获取沙盒 sandbox_signkey  *  * @author yclimb  * @date 2018/9/18  */ private void doGetSandboxSignKey() throws Exception {     WXPayConfigImpl config = WXPayConfigImpl.getInstance();     HashMap<String, String> data = new HashMap<String, String>();     // 商户号     data.put("mch_id", config.getMchID());     // 获取随机字符串     data.put("nonce_str", WXPayUtil.generateNonceStr());     // 生成签名     String sign = WXPayUtil.generateSignature(data, config.getKey());     data.put("sign", sign);          // 得到 sandbox_signkey     WXPay wxPay = new WXPay(config);     String result = wxPay.requestWithoutCert("/sandboxnew/pay/getsignkey", data, 10000, 10000);     System.out.println(result); }小伙伴可以根据 result 来获取具体的返回数据,解析之后获取 sandbox_signkey参数。
商户接入仿真系统的交互流程示例:
- 商户发起刷卡支付请求,使用POST方式调用 https://api.mch.weixin.qq.com/sandboxnew/pay/micropay
- 带sandboxnew 的https请求会被nginx路由到仿真系统。仿真系统根据支付金额(total_fee字段)返回预期报文给商户。同时,落地该笔请求数据;
- 商户发起查单,调用 https://api.mch.weixin.qq.com/sandboxnew/pay/orderquery,带上微信订单号(transaction_id)或商户内部单号(out_trade_no);
- 仿真系统收到查单请求后,根据单号及金额返回预期的查单结果给商户;
- 商户下载对账单,调用 https://api.mch.weixin.qq.com/sandboxnew/pay/downloadbill ,仿真系统返回固定的账单格式给商户。注:账单内容不一定与商户在仿真系统产生的交易完全相同。
沙箱说明:sandbox/sandboxnew
微信支付沙箱环境,是提供给微信支付商户的开发者,用于模拟支付及回调通知。以验证商户是否理解回调通知、账单格式,以及是否对异常做了正确的处理。
◆ 如何对接沙箱环境?
1、修改商户自有程序或配置中,微信支付api的链接,如:被扫支付官网的url为:https://api.mch.weixin.qq.com/pay/micropay 增加sandboxnew路径,变更为https://api.mch.weixin.qq.com/sandboxnew/pay/micropay , 即可接入沙箱验收环境,其它接口类似;
2、在微信支付开发调试站点(站点链接:http://mch.weixin.qq.com/wiki/doc/api/index.php ),按接口文档填入正确的支付参数,发起微信支付请求,完成支付;
3、验收完成后,修改程序或配置中的api链接(重要!),去掉sandboxnew路径。对接现网环境。
说明地址:
https://pay.weixin.qq.com/wiki/doc/api/jsapi.php?chapter=23_1
https://pay.weixin.qq.com/wiki/doc/api/app/app.php?chapter=21_2
结语
