查询交易单

接口说明

接口名称 trade_order_query
接口模式 直连
异步通知 是

应用场景

商户可通过调用此接口查询交易订单，以确认支付状态。

注意事项：

  • 调用支付接口，系统返回交易状态异常时，请调用查询接口确认订单状态。
  • 查询接口返回状态异常时，请稍后再次发起查询。

接口参数

  • 请求：
说明 字段 类型 条件 示例值 备注
代理商商户号 agentMerId S(16) 否 100003789 宝付支付分配的商户号
代理商终端号 agentTerId S(16) 否 213003567 宝付支付分配的终端号
交易商户号 merId S(16) 是 102002369 宝付支付分配的商户号
交易终端号 terId S(16) 是 100003123 宝付支付分配的终端号
商户交易订单号 outTradeNo 否 S(32) 20210315155012 商户系统内部交易订单号
  • 返回：
说明 字段 类型 条件 示例值 备注
代理商商户号 agentMerId S(16) 否 100003789 宝付支付分配的商户号
代理商终端号 agentTerId S(16) 否 213003567 宝付支付分配的终端号
交易商户号 merId S(16) 是 102002369 宝付支付分配的商户号
交易终端号 terId S(16) 是 100003123 宝付支付分配的终端号
宝付交易订单号 tradeNo 否 S(32) 12312312312 与商户订单号对应的宝付侧唯一订单号，推荐传入此值
商户交易订单号 outTradeNo 否 S(32) 20210315155012 商户系统内部交易订单号，同一个商户号下唯一
交易订单状态 txnState 否 E SUCCESS 详见：【交易订单状态】
完成时间 finishTime 否 T 20210315155012 订单状态为成功时才有值
成功金额 succAmt 否 I 100 单位：分，订单状态为成功时才有值
支付手续费 feeAmt 否 I 100 单位：分，订单状态为成功时才有值
分期手续费 instFeeAmt 否 I 100 单位：分，商户使用分期产品支付时，订单状态为成功时有值
请求渠道订单号 reqChlNo 否 S SUCCESS 支付成功时返回
支付方式 payCode 否 E SUCCESS 支付成功时返回请求时的支付方式
清算日期 clearingDate 否 D 20210501
渠道返回参数 chlRetParam 否 C SUCCESS JSON格式，根据不同的业务场景，动态返回响应的参数。
详见：【渠道返回参数】
业务结果 resultCode 是 S(16) SUCCESS SUCCESS：成功 FAIL：失败
错误代码 errCode 否 S(32) SUCCESS 当业务结果FAIL时，返回错误代码
错误描述 errMsg 否 S(128) SUCCESS 当业务结果FAIL时，返回错误代码
作者：admin  创建时间：2025-03-21 18:44
最后编辑：admin  更新时间：2025-11-05 15:01