二、微信验收公众平台验收(为微信点赞)
https://pay.weixin.qq.com/wiki/doc/api/jsapi.php?chapter=23_1&index=2
支付验收指引
为保证商户接入质量,提升交易安全及用户体验,微信支付的合作服务商在正式上线交易前,必须先根据本文指引完成验收。验收完成后,服务商在验收公众平台(微信号:WXPayAssist)提交验收通过申请,审核通过后,才能开通相应的支付权限(如:付款码支付)。否则,请根据审核驳回提示,重新完成验收。
注:仿真测试环境中的商户号(父子商户号)需使用真实商户号。
二、仿真测试系统
为降低商户测试门槛,微信支付团队开发了一套独立的仿真测试系统。该系统根据验收用例金额的不同返回不同的响应报文,以满足商户正常功能测试、安全/异常测试及性能测试的需求。
图1 微信支付仿真测试系统
图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获取:
获取验签秘钥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,仿真系统返回固定的账单格式给商户。注:账单内容不一定与商户在仿真系统产生的交易完全相同。
三、验收流程
图2 商户接入验收流程
如图2,商户在收到微信支付审核通过的邮件后,即可用邮件中提供的开发者信息,启动测试验收工作。验收开始后,验收负责人可按照下表步骤操作:
步骤 | 准备项 | 说明 |
---|---|---|
1 | 商户通过审核,收到审核通过的邮件。 邮件中包含了商户的MCHID、APPID及密码等开发者信息。 |
|
2 | 测试硬件全部到位,且被测的APP已被成功安装在硬件。 | 1、APP支付:测试手机(安卓/IOS/winphone)1台,被测app及微信已安装 2、JSAPI支付:测试手机(安卓/IOS/winphone)1台,微信已安装且已关注被测公众号 3、付款码支付:被测app已被安装至收银台平板,机具或扫码枪功能正常 4、Native支付:联网PC一台,且网站已接入微信支付功能;手机1台,已安装微信 |
3 | 关注公众号“微信支付商户接入验收助手”( 微信号: WXPayAssist),在验收case栏,选择本次接入的支付类型,如付款码支付,即可看到全部验收用例。
|
|
4 | 修改代码或配置中所有微信支付api的链接,对接仿真系统。 | 例如:付款码支付现网的api https://api.mch.weixin.qq.com/pay/micropay 变更为: https://api.mch.weixin.qq.com/sandboxnew/pay/micropay |
5 | 严格按照用例的顺序、金额执行用例,确保用例的检查点完全符合预期。 | 注意: 用例分必选和可选。必选是一定要验的,否则会直接导致验收审核不通过;可选是建议商户要做的,但不验也不会影响验收结果。 |
6 | 全部用例测试通过后,商户在公众号“我的验收”里提交验收通过申请。微信支付团队将在3个工作日内完成验收审核。 | 验收审核通过后,商户会收到邮件通知,相关支付权限开通,可正式上线交易;对于验收不通过的原因,可在公众号“我的验收”里查询验收详细结果,对未通过的case回归测试。 |