微信支付开发(9) 沙箱密钥

关键字：微信支付 微信支付v3 沙箱密钥 getsignkey
作者：方倍工作室
原文: http://www.cnblogs.com/txw1958/p/wxpayv3-signkey.html 

 

一、仿真测试系统

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

 

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

图1为微信支付仿真测试系统（后简称仿真系统）的简化原理图。仿真系统的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获取:

 

获取验签秘钥API：

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

 

 

二、沙箱密钥实现代码

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

返回结果如下