Skip to content

沙箱订单查询

该系统分为两种用例类型:支付成功用例与支付异常用例。请严格按照用例的顺序、金额执行用例,确保用例的检查点完全符合预期。 支付成功用例根据测试用例金额的不同返回不同的响应报文,支付异常用例的识别将通过 Http Header 中添加异常头 Wechatpay-Negative-Test: {用例名} 识别。沙箱系统将通过识别用例名返回对应的异常信息。

请求参数类型描述
timeoutfloat请求超时时间
headersobject声明请求的头参数
Wechatpay-Negative-Teststring异常用例名称
MICROPAY_USERPAYING | MICROPAY_TIMEOUT | MICROPAY_PAYERROR | MICROPAY_PAY_QUERY_TIMEOUT枚举值之一
xmlobject声明请求的XML数据结构
appidstring公众账号ID
mch_idstring商户号
out_trade_nostring商户订单号
sign_typestring签名类型
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_codestring返回状态码
SUCCESS | FAIL 枚举值之一
return_msgstring返回信息
result_codestring业务结果
SUCCESS | FAIL 枚举值之一
err_codestring错误代码
err_code_desstring错误代码描述
trade_typestring交易类型 MICROPAY
trade_statestring交易状态
SUCCESS | REFUND | NOTPAY | CLOSED | REVOKED | USERPAYING | PAYERROR | ACCEPT 枚举值之一
out_trade_nostring商户订单号
transaction_idstring微信支付订单号
total_feestring标价金额
cash_feestring现金支付金额
coupon_feestring代金券金额

重要提示

  1. $instance 构造实例化时,需要显式初始化 secret 字段,此为沙箱环境密钥,即前序获取沙箱环境密钥获取到的 sandbox_signkey
  2. 请求参数的appid为任意值,官方沙箱环境未做要求,也无需有绑定关系
  3. 此接口仅支持以商户订单号out_trade_no查询;
  4. 支付成功用例仅代表前序沙箱付款码支付受理成功,用户支付行为是一个异步过程,是否完成,需要通过此接口二次确认交易真实完成,即:
    1. 【付款码-正常】订单金额0.01元,用户支付成功
    2. 【付款码-正常】订单金额0.02元(含0.01元代金券),用户支付成功
    3. 【付款码-正常】订单金额0.03元(含0.01元代金券和0.02元免充值现金券),用户支付成功
  5. 支付异常用例通过此接口的第二参数 headers 字段进行验证,为可选字段,按需显式传递 Wechatpay-Negative-Test 对应的用例名称,即:
    1. MICROPAY_USERPAYING 用户未支付完成
    2. MICROPAY_TIMEOUT 用户支付成功,微信支付返回超时(客户端超时时间请设置在 500ms 以内)
    3. MICROPAY_PAYERROR 用户支付失败,微信支付返回超时(客户端超时时间请设置在 500ms 以内)
    4. MICROPAY_PAY_QUERY_TIMEOUT 微信支付返回超时,且查单失败
  6. 支付异常用例中要求限定客户端超时时间的,请求参数增加 timeout 参数,按需显式设置;
  7. 此接口有QPS限制(官方未公布),高频请求会被官方重定向到腾讯公益404页面;

参阅 官方文档

Published on the GitHub by TheNorthMemory