微信支付开发中沙箱密钥的示例分析
一、仿真测试系统
为降低商户测试门槛，微信支付团队开发了一套独立的仿真测试系统。该系统根据验收用例金额的不同返回不同的响应报文，以满足商户正常功能测试、安全/异常测试及性能测试的需求。
图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"}仿真测试系统
为降低商户测试门槛，微信支付团队开发了一套独立的仿真测试系统。该系统根据验收用例金额的不同返回不同的响应报文，以满足商户正常功能测试、安全/异常测试及性能测试的需求。