wechatpay.im

主题模式

沙箱订单查询 ​

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

请求参数类型描述
xmlarray声明请求的XML数据结构
appidstring公众账号ID
mch_idstring商户号
out_trade_nostring商户订单号
sign_typestring签名类型
MD5 | HMAC-SHA256枚举值之一
默认值 MD5
headersarray请求头
Wechatpay-Negative-Teststring声明所请求的用例名称
timeoutfloat请求超时时间
php
$instance->v2->xdc->apiv2sandbox->pay->orderquery->postAsync([
  'xml' => [
    'appid' => 'wxd678efh567hg6787',
    'mch_id' => '1230000109',
    'out_trade_no' => '20150806125346',
    'sign_type' => 'HMAC-SHA256',
  ],
  'headers' => [
    'Wechatpay-Negative-Test' => 'MICROPAY_USERPAYING',
  ],
  'timeout' => 0.4,
])
->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([
  'xml' => [
    'appid' => 'wxd678efh567hg6787',
    'mch_id' => '1230000109',
    'out_trade_no' => '20150806125346',
    'sign_type' => 'HMAC-SHA256',
  ],
  'headers' => [
    'Wechatpay-Negative-Test' => 'MICROPAY_USERPAYING',
  ],
  'timeout' => 0.4,
])
->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([
  'xml' => [
    'appid' => 'wxd678efh567hg6787',
    'mch_id' => '1230000109',
    'out_trade_no' => '20150806125346',
    'sign_type' => 'HMAC-SHA256',
  ],
  'headers' => [
    'Wechatpay-Negative-Test' => 'MICROPAY_USERPAYING',
  ],
  'timeout' => 0.4,
])
->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([
  'xml' => [
    'appid' => 'wxd678efh567hg6787',
    'mch_id' => '1230000109',
    'out_trade_no' => '20150806125346',
    'sign_type' => 'HMAC-SHA256',
  ],
  'headers' => [
    'Wechatpay-Negative-Test' => 'MICROPAY_USERPAYING',
  ],
  'timeout' => 0.4,
]);
print_r(\WeChatPay\Transformer::toArray((string)$response->getBody()));
php
$response = $instance->chain('v2/xdc/apiv2sandbox/pay/orderquery')->post([
  'xml' => [
    'appid' => 'wxd678efh567hg6787',
    'mch_id' => '1230000109',
    'out_trade_no' => '20150806125346',
    'sign_type' => 'HMAC-SHA256',
  ],
  'headers' => [
    'Wechatpay-Negative-Test' => 'MICROPAY_USERPAYING',
  ],
  'timeout' => 0.4,
]);
print_r(\WeChatPay\Transformer::toArray((string)$response->getBody()));
php
$response = $instance['v2/xdc/apiv2sandbox/pay/orderquery']->post([
  'xml' => [
    'appid' => 'wxd678efh567hg6787',
    'mch_id' => '1230000109',
    'out_trade_no' => '20150806125346',
    'sign_type' => 'HMAC-SHA256',
  ],
  'headers' => [
    'Wechatpay-Negative-Test' => 'MICROPAY_USERPAYING',
  ],
  'timeout' => 0.4,
]);
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交易状态
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