接口说明

接口名称 order_query
是否幂等 否
接口模式 直连
异步通知 否

商户通过订单查询接口主动查询支付订单状态。

注意事项：

  • 宝付订单号、商户订单号至少选择一个传入，推荐传入宝付订单号，如果同时传入，系统默认使用宝付订单号。
  • 调用支付接口，系统返回交易状态异常时，请调用查询接口确认订单状态。
  • 查询接口返回状态异常时，请稍后再次发起查询。

接口参数

  • 请求：
字段名 变量名 必填 类型 示例值 描述
代理商商户号 agentMerId 否 S(16) 100000 宝付支付分配的商户号
代理商终端号 agentTerId 否 S(16) 100000 宝付支付分配的终端号
商户号 merId 是 S(16) 100000 宝付支付分配的商户号
终端号 terId 是 S(16) 100000 宝付支付分配的终端号
宝付交易号 tradeNo 否 S(32) 12312312312 与商户订单号对应的宝付侧唯一订单号，推荐传入此值
商户订单号 outTradeNo 否 S(32) 20210315155012 商户系统内部订单号，同一个商户号下唯一
  • 返回：
字段名 变量名 必填 类型 示例值 描述
代理商商户号 agentMerId 否 S(16) 100000 宝付支付分配的商户号
代理商终端号 agentTerId 否 S(16) 100000 宝付支付分配的终端号
商户号 merId 是 S(16) 100000 宝付支付分配的商户号
终端号 terId 是 S(16) 100000 宝付支付分配的终端号
宝付交易号 tradeNo 否 S(32) 12312312312 与商户订单号对应的宝付侧唯一订单号，推荐传入此值
商户订单号 outTradeNo 否 S(32) 20210315155012 商户系统内部订单号，同一个商户号下唯一
订单状态 txnState 否 E REFUND 详见附录订单状态
完成时间 finishTime 否 T 20210315155012 订单状态为成功时才有值
成功金额 succAmt 否 I 100 单位：分，订单状态为成功时才有值
支付手续费 feeAmt 否 I 100 单位：分，订单状态为成功时才有值
分期手续费 instFeeAmt 否 I 100 单位：分，商户使用分期产品支付时，订单状态为成功时有值
业务结果 resultCode 是 S(16) SUCCESS SUCCESS：成功 FAIL：失败
错误代码 errCode 否 S(32) SUCCESS 当业务结果FAIL时，返回错误代码
错误描述 errMsg 否 S(128) SUCCESS 当业务结果FAIL时，返回错误代码
请求渠道订单号 reqChlNo 否 S SUCCESS 支付成功时返回
支付方式 payCode 否 E SUCCESS 支付成功时返回
渠道返回参数 chlRetParam 否 C SUCCESS 根据不同的支付方式返回相应的业务参数详见：渠道返回参数
清算日期 clearingDate 否 D 20210501
作者：郑成定  创建时间：2026-05-22 14:55
最后编辑：荣古城  更新时间：2026-09-17 19:13