企业内部开发
基础
连接微信
办公
会议
会议统计管理
企业内部开发
服务端API
小程序接入对外收款
普通支付
查询订单
查询订单
最后更新:2022/11/29
商户可以通过商户订单号查询订单,获取订单状态等信息,完成下一步的业务逻辑。
需要调用查询接口的情况
• 当商户后台、网络、服务器等出现异常,商户系统最终未接收到支付通知。
• 调用支付接口后,返回系统错误或未知交易状态情况。
• 调用关单或撤销接口API之前,需确认支付状态。

 

请求方式: POST(HTTPS)
请求地址:https://qyapi.weixin.qq.com/cgi-bin/miniapppay/get_order?access_token=ACCESS_TOKEN

 

请求包体:

{
  "mchid" : "xxx",
  "out_trade_no" : "xxx"
}

参数说明:

参数名变量类型[长度限制]必填说明
商户号mchidstring[1,32]二级商户号,由企业微信生成并下发。
商户订单号out_trade_nostring[6,32]商户系统内部订单号,只能是数字、大小 写字母_-*且在同一个商户号下唯一。

 

返回结果:

{
    "mchid": "xxx",
    "out_trade_no": "xxxx",
    "trade_state": "xxx",
    "trade_state_desc": "xxx",
    "payer": {
        "openid": "xxxxxx"
    },
    "transaction_id": "xxxxxxxx"
}

参数说明:

参数名变量类型[长度限制]必填说明
商户号mchidstring[1,32]二级商户号,由企业微信生成并下发。
商户订单号out_trade_nostring[6,32]商户系统内部订单号,只能是数字、大小 写字母_-*且在同一个商户号下唯一。
交易类型trade_typestring[1,16]交易类型,枚举值:
JSAPI:公众号支付
NATIVE:扫码支付
APP:APP支付
MICROPAY:付款码支付
MWEB:H5支付
FACEPAY:刷脸支付
示例值:MICROPAY
交易状态trade_statestring[1,32]交易状态,枚举值:
SUCCESS:支付成功
REFUND:转入退款
NOTPAY:未支付
CLOSED:已关闭
REVOKED:已撤销(付款码支付
USERPAYING:用户支付中(付款码支付)
PAYERROR:支付失败(其他原因,如银行返回失败)
ACCEPT:已接收,等待扣款
示例值:SUCCESS
交易状态描述trade_state_descstring[1,256]示例值:支付失败,请重新下单支付
支付者标识payer.openidstring[1,128]用户在子商户appid下的唯一标识。
微信支付订单号transaction_idstring[1,32]微信支付系统生成的订单号
付款银行bank_typestring[1,32]银行类型,采用字符串类型的银行标识。
附加数据attachstring[1,128]附加数据,在查询API和支付通知中原样返回,可作为自定义参数使用,实际情况下只有支付完成状态才会返回该字段。
支付完成时间success_timestring[1,64]支付完成时间,遵循rfc3339标准格式,格式为yyyy-MM-DDTHH:mm:ss+TIMEZONE
订单总金额amount.totalint订单总金额,单位为分
用户支付金额amount.payer_totalint用户支付金额,单位为分
货币类型amount.currencystring[1,16]境内商户号仅支持人民币 CNY
用户支付币种amount.payer_currencystring[1,16]用户支付币种
商户端设备号scene_info.totalstring[1,32]商户端设备号(发起扣款请求的商户服务器设备号)。
商品小票IDpromotion_detail.coupon_idstring[1,32]商家小票ID
优惠名称promotion_detail.namestring[1,64]优惠名称
优惠范围promotion_detail.scopestring[1,32]GLOBAL:全场代金券
SINGLE:单品优惠
优惠类型promotion_detail.typestring[1,32]CASH:充值型代金券
NOCASH:免充值型代金券
示例值:CASH
优惠券面额promotion_detail.amountint优惠券面额
活动IDpromotion_detail.stock_idstring[1,32]活动ID
微信出资promotion_detail.wechatpay_contributeint微信出资,单位为分
商户出资promotion_detail.merchant_contributeint商户出资,单位为分
其他出资promotion_detail.other_contributeint其他出资,单位为分
优惠币种promotion_detail.currencystring[1,16]CNY:人民币,境内商户号仅支持人民币。
商品编码promotion_detail.goods_detail.goods_idstring[1,32]商品编码
商品数量promotion_detail.goods_detail.quantityint用户购买的数量
商品单价promotion_detail.goods_detail.unit_priceint商品单价,单位为分
商品优惠金额promotion_detail.goods_detail.discount_amountint商品优惠金额
商品备注promotion_detail.goods_detail.goods_remarkstring[1,128]商品备注信息
上一篇小程序下单
下一篇关闭订单
    本节内容
服务端API
基础
连接微信
办公
会议
会议统计管理
客户端API
小程序
基础
连接微信
办公
WECOM-JSSDK
JS-SDK
基础
连接微信
办公
更新日志
联系我们