跳到主要内容

查询订单

请求接口

openapi/v2/pay/query/payorder

公共参数

接口协议 - 公共参数

请求参数

参数pay_no、out_trade_no、transaction_id三个参数必须三选一,至少传一个。优先级:pay_no > out_trade_no > transaction_id

参数必填类型说明
pay_noString(64)聚合支付订单号,600开头。能明确为pay_no的情况下,请优先选择此字段
out_trade_noString(64)业务系统订单号
transaction_idString(64)交易流水号,此字段为模糊查询,可为响应参数里的transaction_id或channel_transaction_id
is_refreshString(1)此查询是否强制查询支付渠道并刷新订单状态,Y:刷新,N:不刷新,默认为N。普通查询、轮询状态情况,不建议传次参数。
提示

如果强制查询刷新会加大查询时间,请设置更长的超时时间。

响应参数

名称必填类型说明
mch_idString商户id
pay_noString聚合支付订单号
out_trade_noString业务系统订单号
transaction_idString支付平台交易流水号。微信、支付宝、云闪付等用户支付使用的平台返回流水号
ch_transaction_idString间连渠道交易流水号。聚合或其他第三方间连渠道返回流水号
paymentString支付方式
subjectString商品名或订单简要描述
amountint交易金额,单位:分
pay_timeString支付时间,格式"yyyy-MM-dd HH:mm:ss"
succ_timeString支付完成时间,只有在支付成功时返回,格式"yyyy-MM-dd HH:mm:ss"
statusint支付状态。参考支付状态值枚举
attachString附加信息,原样返回
result_msgString其他错误信息。当is_fresh为Y并且查询支付渠道失败时返回支付渠道的错误信息。
amount_infoJson支付订单相关金额信息,支付成功时返回