浅析微信支付系列已经更新十篇了哟~,没有看过的朋友们可以看一下。
浅析微信支付:下载对账单和资金账单
浅析微信支付:申请退款、退款回调接口、查询退款
浅析微信支付:查询订单和关闭订单
浅析微信支付:支付结果通知
在实际开发中,通常我们都是在开发环境中开发,本地环境也有很多限制,比如:微信支付无法调起、H5链接需要鉴权、支付结果通知需要外网等。
面对以上的问题,微信官方给出了解决的方法,就是咋们这篇文章的 沙箱环境,也就是微信支付的官方测试环境,这个环境能做些什么呢?我觉得最重要的一点就是我们可以实时根据官方的例子调用对应的接口,并且接口会马上返回结果,拿微信支付预支付单接口来说,调用以后会实时返回我们支付的相关信息,这样就免于开发时不知道返回结果而苦恼。
仿真测试系统为降低商户测试门槛,微信支付团队开发了一套独立的仿真测试系统。该系统根据验收用例金额的不同返回不同的响应报文,以满足商户正常功能测试、安全/异常测试及性能测试的需求。
图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、在微信支付开发调试站点(站点链接: ),按接口文档填入正确的支付参数,发起微信支付请求,完成支付;
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