沙箱订单查询
该系统分为两种用例类型:支付成功用例与支付异常用例。请严格按照用例的顺序、金额执行用例,确保用例的检查点完全符合预期。 支付成功用例根据测试用例金额的不同返回不同的响应报文,支付异常用例的识别将通过 Http Header 中添加异常头 Wechatpay-Negative-Test: {用例名}
识别。沙箱系统将通过识别用例名返回对应的异常信息。
请求参数 | 类型 | 描述 |
---|---|---|
timeout | float | 请求超时时间 |
headers | object | 声明请求的头参数 |
Wechatpay-Negative-Test | string | 异常用例名称MICROPAY_USERPAYING | MICROPAY_TIMEOUT | MICROPAY_PAYERROR | MICROPAY_PAY_QUERY_TIMEOUT 枚举值之一 |
xml | object | 声明请求的XML 数据结构 |
appid | string | 公众账号ID |
mch_id | string | 商户号 |
out_trade_no | string | 商户订单号 |
sign_type | string | 签名类型MD5 | HMAC-SHA256 枚举值之一默认值 MD5 |
php
$instance->v2->xdc->apiv2sandbox->pay->orderquery->postAsync([
'timeout' => 0.4,
'headers' => [
'Wechatpay-Negative-Test' => 'MICROPAY_USERPAYING',
],
'xml' => [
'appid' => 'wxd678efh567hg6787',
'mch_id' => '1230000109',
'out_trade_no' => '20150806125346',
'sign_type' => 'HMAC-SHA256',
],
])
->then(static function(\Psr\Http\Message\ResponseInterface $response) {
print_r(\WeChatPay\Transformer::toArray((string)$response->getBody()));
})
->wait();
php
$instance->chain('v2/xdc/apiv2sandbox/pay/orderquery')->postAsync([
'timeout' => 0.4,
'headers' => [
'Wechatpay-Negative-Test' => 'MICROPAY_USERPAYING',
],
'xml' => [
'appid' => 'wxd678efh567hg6787',
'mch_id' => '1230000109',
'out_trade_no' => '20150806125346',
'sign_type' => 'HMAC-SHA256',
],
])
->then(static function(\Psr\Http\Message\ResponseInterface $response) {
print_r(\WeChatPay\Transformer::toArray((string)$response->getBody()));
})
->wait();
php
$instance['v2/xdc/apiv2sandbox/pay/orderquery']->postAsync([
'timeout' => 0.4,
'headers' => [
'Wechatpay-Negative-Test' => 'MICROPAY_USERPAYING',
],
'xml' => [
'appid' => 'wxd678efh567hg6787',
'mch_id' => '1230000109',
'out_trade_no' => '20150806125346',
'sign_type' => 'HMAC-SHA256',
],
])
->then(static function(\Psr\Http\Message\ResponseInterface $response) {
print_r(\WeChatPay\Transformer::toArray((string)$response->getBody()));
})
->wait();
php
$response = $instance->v2->xdc->apiv2sandbox->pay->orderquery->post([
'timeout' => 0.4,
'headers' => [
'Wechatpay-Negative-Test' => 'MICROPAY_USERPAYING',
],
'xml' => [
'appid' => 'wxd678efh567hg6787',
'mch_id' => '1230000109',
'out_trade_no' => '20150806125346',
'sign_type' => 'HMAC-SHA256',
],
]);
print_r(\WeChatPay\Transformer::toArray((string)$response->getBody()));
php
$response = $instance->chain('v2/xdc/apiv2sandbox/pay/orderquery')->post([
'timeout' => 0.4,
'headers' => [
'Wechatpay-Negative-Test' => 'MICROPAY_USERPAYING',
],
'xml' => [
'appid' => 'wxd678efh567hg6787',
'mch_id' => '1230000109',
'out_trade_no' => '20150806125346',
'sign_type' => 'HMAC-SHA256',
],
]);
print_r(\WeChatPay\Transformer::toArray((string)$response->getBody()));
php
$response = $instance['v2/xdc/apiv2sandbox/pay/orderquery']->post([
'timeout' => 0.4,
'headers' => [
'Wechatpay-Negative-Test' => 'MICROPAY_USERPAYING',
],
'xml' => [
'appid' => 'wxd678efh567hg6787',
'mch_id' => '1230000109',
'out_trade_no' => '20150806125346',
'sign_type' => 'HMAC-SHA256',
],
]);
print_r(\WeChatPay\Transformer::toArray((string)$response->getBody()));
返回字典 | 类型 | 描述 |
---|---|---|
return_code | string | 返回状态码SUCCESS | FAIL 枚举值之一 |
return_msg | string | 返回信息 |
result_code | string | 业务结果SUCCESS | FAIL 枚举值之一 |
err_code | string | 错误代码 |
err_code_des | string | 错误代码描述 |
trade_type | string | 交易类型 MICROPAY |
trade_state | string | 交易状态SUCCESS | REFUND | NOTPAY | CLOSED | REVOKED | USERPAYING | PAYERROR | ACCEPT 枚举值之一 |
out_trade_no | string | 商户订单号 |
transaction_id | string | 微信支付订单号 |
total_fee | string | 标价金额 |
cash_fee | string | 现金支付金额 |
coupon_fee | string | 代金券金额 |
重要提示
- $instance 构造实例化时,需要显式初始化 secret 字段,此为沙箱环境密钥,即前序获取沙箱环境密钥获取到的 sandbox_signkey;
- 请求参数的appid为任意值,官方沙箱环境未做要求,也无需有绑定关系;
- 此接口仅支持以商户订单号out_trade_no查询;
- 支付成功用例仅代表前序沙箱付款码支付受理成功,用户支付行为是一个异步过程,是否完成,需要通过此接口二次确认交易真实完成,即:
- 【付款码-正常】订单金额0.01元,用户支付成功
- 【付款码-正常】订单金额0.02元(含0.01元代金券),用户支付成功
- 【付款码-正常】订单金额0.03元(含0.01元代金券和0.02元免充值现金券),用户支付成功
- 支付异常用例通过此接口的第二参数 headers 字段进行验证,为可选字段,按需显式传递 Wechatpay-Negative-Test 对应的用例名称,即:
- MICROPAY_USERPAYING 用户未支付完成
- MICROPAY_TIMEOUT 用户支付成功,微信支付返回超时(客户端超时时间请设置在 500ms 以内)
- MICROPAY_PAYERROR 用户支付失败,微信支付返回超时(客户端超时时间请设置在 500ms 以内)
- MICROPAY_PAY_QUERY_TIMEOUT 微信支付返回超时,且查单失败
- 支付异常用例中要求限定客户端超时时间的,请求参数增加 timeout 参数,按需显式设置;
- 此接口有QPS限制(官方未公布),高频请求会被官方重定向到腾讯公益404页面;
参阅 官方文档