查询订单
请求接口
openapi/v2/pay/query/payorder
公共参数
请求参数
参数pay_no、out_trade_no、transaction_id三个参数必须三选一,至少传一个。优先级:pay_no > out_trade_no > transaction_id
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| pay_no | 否 | String(64) | 聚合支付订单号,600开头。能明确为pay_no的情况下,请优先选择此字段 |
| out_trade_no | 否 | String(64) | 业务系统订单号 |
| transaction_id | 否 | String(64) | 交易流水号,此字段为模糊查询,可为响应参数里的transaction_id或channel_transaction_id |
| is_refresh | 否 | String(1) | 此查询是否强制查询支付渠道并刷新订单状态,Y:刷新,N:不刷新,默认为N。普通查询、轮询状态情况,不建议传次参数。 |
提示
如果强制查询刷新会加大查询时间,请设置更长的超时时间。
响应参数
| 名称 | 必填 | 类型 | 说明 |
|---|---|---|---|
| mch_id | 是 | String | 商户id |
| pay_no | 是 | String | 聚合支付订单号 |
| out_trade_no | 是 | String | 业务系统订单号 |
| transaction_id | 否 | String | 支付平台交易流水号。微信、支付宝、云闪付等用户支付使用的平台返回流水号 |
| ch_transaction_id | 否 | String | 间连渠道交易流水号。聚合或其他第三方间连渠道返回流水号 |
| payment | 是 | String | 支付方式 |
| subject | 是 | String | 商品名或订单简要描述 |
| amount | 是 | int | 交易金额,单位:分 |
| pay_time | 是 | String | 支付时间,格式"yyyy-MM-dd HH:mm:ss" |
| succ_time | 否 | String | 支付完成时间,只有在支付成功时返回,格式"yyyy-MM-dd HH:mm:ss" |
| status | 是 | int | 支付状态。参考支付状态值枚举 |
| attach | 否 | String | 附加信息,原样返回 |
| result_msg | 否 | String | 其他错误信息。当is_fresh为Y并且查询支付渠道失败时返回支付渠道的错误信息。 |
| amount_info | 否 | Json | 支付订单相关金额信息,支付成功时返回 |