查询订单(商户订单号)

该接口提供所有微信支付订单的查询，商户可以通过查询订单接口主动查询订单状态，完成下一步的业务逻辑。

🔰

本接口服务已于 2022.09.08 (北京时间)发布新版，新接口见这里，此文档仅做留存参考。

请求参数	类型	描述
base_uri	string	声明接入点https://api.mch.weixin.qq.com/hk/(国内接入)
out_trade_no	string	商户订单号
query	object	声明请求的查询参数
mchid	string	商户号
sub_mchid	string	子商户号
sp_mchid	string	机构商户号

异步纯链式

$instance->v3->transactions->outTradeNo->_out_trade_no_->getAsync([
  'base_uri' => 'https://api.mch.weixin.qq.com/hk/', // 接入点(国内接入)
  'out_trade_no' => '1217752501201407033233368018',
  'query' => [
    'mchid'     => '1900000109',
    'sub_mchid' => '1900000109',
    'sp_mchid'  => '1900000100',
  ],
])
->then(static function(\Psr\Http\Message\ResponseInterface $response) {
  print_r(json_decode((string) $response->getBody(), true));
})
->wait();

异步声明式

$instance->chain('v3/transactions/out-trade-no/{out_trade_no}')->getAsync([
  'base_uri' => 'https://api.mch.weixin.qq.com/hk/', // 接入点(国内接入)
  'out_trade_no' => '1217752501201407033233368018',
  'query' => [
    'mchid'     => '1900000109',
    'sub_mchid' => '1900000109',
    'sp_mchid'  => '1900000100',
  ],
])
->then(static function(\Psr\Http\Message\ResponseInterface $response) {
  print_r(json_decode((string) $response->getBody(), true));
})
->wait();

异步属性式

$instance['v3/transactions/out-trade-no/{out_trade_no}']->getAsync([
  'base_uri' => 'https://api.mch.weixin.qq.com/hk/', // 接入点(国内接入)
  'out_trade_no' => '1217752501201407033233368018',
  'query' => [
    'mchid'     => '1900000109',
    'sub_mchid' => '1900000109',
    'sp_mchid'  => '1900000100',
  ],
])
->then(static function(\Psr\Http\Message\ResponseInterface $response) {
  print_r(json_decode((string) $response->getBody(), true));
})
->wait();

同步纯链式

$response = $instance->v3->transactions->outTradeNo->_out_trade_no_->get([
  'base_uri' => 'https://api.mch.weixin.qq.com/hk/', // 接入点(国内接入)
  'out_trade_no' => '1217752501201407033233368018',
  'query' => [
    'mchid'     => '1900000109',
    'sub_mchid' => '1900000109',
    'sp_mchid'  => '1900000100',
  ],
]);
print_r(json_decode((string) $response->getBody(), true));

同步声明式

$response = $instance->chain('v3/transactions/out-trade-no/{out_trade_no}')->get([
  'base_uri' => 'https://api.mch.weixin.qq.com/hk/', // 接入点(国内接入)
  'out_trade_no' => '1217752501201407033233368018',
  'query' => [
    'mchid'     => '1900000109',
    'sub_mchid' => '1900000109',
    'sp_mchid'  => '1900000100',
  ],
]);
print_r(json_decode((string) $response->getBody(), true));

同步属性式

$response = $instance['v3/transactions/out-trade-no/{out_trade_no}']->get([
  'base_uri' => 'https://api.mch.weixin.qq.com/hk/', // 接入点(国内接入)
  'out_trade_no' => '1217752501201407033233368018',
  'query' => [
    'mchid'     => '1900000109',
    'sub_mchid' => '1900000109',
    'sp_mchid'  => '1900000100',
  ],
]);
print_r(json_decode((string) $response->getBody(), true));

返回字典	类型	描述
mchid	string	商户号
appid	string	APPID
sp_mchid	string	机构商户号
sub_mchid	string	子商户号
sp_appid	string	机构APPID
sub_appid	string	子商户APPID
out_trade_no	string	商户订单号
id	string	微信支付订单号
attach	string	商户数据
trade_type	string	交易类型 JSAPI | NATIVE | APP | MWEB | MICROPAY 枚举值之一
bank_type	string	付款银行
success_time	string	支付完成时间
trade_state	string	交易状态 SUCCESS | REFUND | NOTPAY | CLOSED | REVOKED | USERPAYING | PAYERROR 枚举值之一
trade_state_desc	string	交易状态描述
payer	object	支付者
openid	string	用户标识
sp_openid	string	机构用户标识
sub_openid	string	子商户用户标识
amount	object	订单金额
total	integer	订单金额
payer_total	integer	用户支付金额
currency	string	订单标价币种
payer_currency	string	用户支付币种
exchange_rate	object	汇率信息
type	string	汇率类型 SETTLEMENT_RATE 枚举值
rate	integer	汇率值
promotion_detail	object[]	优惠功能
promotion_id	string	券ID
name	string	优惠名称
scope	string	优惠范围 GLOBAL | SINGLE 枚举值之一
type	string	优惠类型 COUPON | DISCOUNT 枚举值之一
amount	integer	优惠券面额
currency	string	优惠币种
activity_id	string	活动ID
wxpay_contribute_amount	integer	微信出资
merchant_contribute_amount	integer	商户出资
other_contribute_amount	integer	其他出资
goods_detail	object[]	单品列表
goods_id	string	商品编码
goods_remark	string	商品备注
discount_amount	integer	商品优惠金额
quantity	integer	商品数量
price	integer	商品价格

参阅 官方文档