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

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

一、仿真测试系统

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

 

图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：

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

请求参数：

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

返回参数：

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

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

字段名字段必填示例值类型说明商户号mch_id是1305638280String(32)微信支付分配的微信商户号沙箱密钥sandbox_signkey否0****764String(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);