微信支付开发之沙箱密钥步骤详解

程序员文章站 2022-03-25 22:43:34

...

一、仿真测试系统

为降低商户测试门槛，微信支付团队开发了一套独立的仿真测试系统。该系统根据验收用例金额的不同返回不同的响应报文，以满足商户正常功能测试、安全/异常测试及性能测试的需求。

微信支付开发之沙箱密钥步骤详解

图1 微信支付仿真测试系统

图1为微信支付仿真测试系统（后简称仿真系统）的简化原理图。仿真系统的API协议与正式API完全相同。商户开发者只需将正式API的调用URL增加一层sandboxnew路径，即可对接到仿真系统。

例如，刷卡支付URL：api.mch.weixin.qq.com/pay/micropay

变更为：api.mch.weixin.qq.com/sandboxnew/pay/micropay。

仿真系统与生产环境完全独立，包括存储层。商户在仿真系统所做的所有交易（如下单、支付、查询）均为无资金流的假数据，即：用户无需真实扣款，商户也不会有资金入账。代金券同理，沙箱环境中无需商户真实制券与发券，亦不会出现真实扣券情况。验收仿真测试系统的API验签密钥需从API获取:

获取验签秘钥API：

请求Url	api.mch.weixin.qq.com/sandboxnew/pay/getsignkey
是否需要证书	否
请求方式	POST

请求参数：

字段名	字段	必填	示例值	类型	说明
商户号	mch_id	是	1305638280	String(32)	微信支付分配的微信商户号
随机字符串	nonce_str	是	5K8264ILTKCH16CQ2502SI8ZNMTM67VS	String(32)	随机字符串，不长于32位
签名	sign	是	5K8264ILTKCH16CQ2502SI8ZNMTM67VS	String(32)	签名值

返回参数：

字段名	字段	必填	示例值	类型	说明
返回状态码	return_code	是	SUCCESS	String(16)	SUCCESS/FAIL 此字段是通信标识，非交易标识
返回信息	return_msg	否	签名失败	String(128)	返回信息，如非空，为错误原因，签名失败，参数格式校验错误

以下字段在return_code 为SUCCESS的时有返回。

字段名	字段	必填	示例值	类型	说明
商户号	mch_id	是	1305638280	String(32)	微信支付分配的微信商户号
沙箱密钥	sandbox_signkey	否	013467007045764	String(32)	返回的沙箱密钥

商户接入仿真系统的交互流程示例：
1. 商户发起刷卡支付请求，使用POST方式调用 api.mch.weixin.qq.com/sandboxnew/pay/micropay
2. 带sandboxnew 的https请求会被nginx路由到仿真系统。仿真系统根据支付金额（total_fee字段）返回预期报文给商户。同时，落地该笔请求数据；
3. 商户发起查单，调用 api.mch.weixin.qq.com/sandboxnew/pay/orderquery，带上微信订单号（transaction_id）或商户内部单号（out_trade_no）；
4. 仿真系统收到查单请求后，根据单号及金额返回预期的查单结果给商户；
5. 商户下载对账单，调用 api.mch.weixin.qq.com/sandboxnew/pay/downloadbill，仿真系统返回固定的账单格式给商户。注：账单内容不一定与商户在仿真系统产生的交易完全相同。

二、沙箱密钥

使用方倍工作室微信支付全能接口类，几行代码即可实现

//1.5 沙箱密钥$obj = array();$obj['mch_id'] = MCHID;$url = 'https://api.mch.weixin.qq.com/sandboxnew/pay/getsignkey';$wxHongBaoHelper = new WxPay();$data = $wxHongBaoHelper->wxpay($url, $obj, false);$res = $wxHongBaoHelper->xmlToArray($data);

返回结果如下

array(3) {
  ["return_code"]=>  string(7) "SUCCESS"
  ["return_msg"]=>  string(2) "ok"
  ["sandbox_signkey"]=>  string(32) "4d827419cb511d8f6ccc35d574ff1f7b"}