微信支付沙箱环境

本文阅读对象为：商户自有系统（包括但不限于：在线购物平台、人工收银系统、自动化智能收银系统、APP应用等）负责微信支付功能测试的测试及开发人员。

一、概述

为保证商户接入质量，提升交易安全及用户体验，微信支付的合作服务商在正式上线交易前，建议先根据本文指引完成正常与异常情况的测试。

二、仿真测试系统

为降低商户测试门槛，微信支付团队开发了一套独立的仿真测试系统。该系统分为两种用例类型：支付成功用例与支付异常用例。支付成功用例根据测试用例金额的不同返回不同的响应报文，支付异常用例的识别将通过 Http Header 中添加异常头 Wechatpay-Negative-Test: {用例名} 识别。沙箱系统将通过识别用例名返回对应的异常信息。

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

例如，付款码支付URL：https://api.mch.weixin.qq.com/pay/micropay

变更为：https://api.mch.weixin.qq.com/xdc/apiv2sandbox/pay/micropay。

注意：目前只支持付款码支付成功用例与付款码支付异常用例中的接口调用，下单接口：https://api.mch.weixin.qq.com/pay/unifiedorder 等目前暂不支持使用

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

获取验签秘钥API：

请求参数：

返回参数：

商户接入仿真系统的交互流程示例：
1. 商户发起付款码支付请求，使用POST方式调用 https://api.mch.weixin.qq.com/xdc/apiv2sandbox/pay/micropay
2. 带xdc/apiv2sandbox的https请求会被nginx路由到仿真系统。仿真系统根据对应用例返回预期报文给商户。同时，落地该笔请求数据；
3. 商户发起查单，调用 https://api.mch.weixin.qq.com/xdc/apiv2sandbox/pay/orderquery，带上微信订单号（transaction_id）或商户内部单号（out_trade_no）；
4. 仿真系统收到查单请求后，根据单号及金额返回预期的查单结果给商户

三、测试流程