接口说明

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

商户通过分账订单查询接口主动查询分账订单状态。

注意事项:

  1. 宝付订单号、商户订单号至少选择一个传入,推荐传入宝付订单号,如果同时传入,系统默认使用宝付订单号。
  2. 由于分账为系统异步处理,建议在提交确认分账1分钟以后发起查询,或者等待宝付支付系统异步通知分账结果。
  3. 调用确认分账接口,系统返回交易状态异常时,请调用查询接口确认订单状态

接口参数

  • 请求:
字段名 变量名 必填 类型 示例值 描述
代理商商户号 agentMerId S(16) 100000 宝付支付分配的商户号
代理商终端号 agentTerId S(16) 100000 宝付支付分配的终端号
商户号 merId S(16) 100000 宝付支付分配的商户号
终端号 terId S(16) 100000 宝付支付分配的终端号
宝付分账交易号 tradeNo S(32) 12312312312 与商户分账订单号对应的宝付侧唯一分账交易号,推荐传入此值
商户分账订单号 outTradeNo S(50) 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 订单状态为成功时才有值格式为yyyyMMddHHmmss,如:2021年3月15日15点50分12秒表示为:20210315155012
分账成功金额 succAmt I 单位:分
清算日期 clearingDate D
业务结果 resultCode S(16) SUCCESS SUCCESS:成功 FAIL:失败
错误代码 errCode S(32) SUCCESS 当业务结果FAIL时,返回错误代码
错误描述 errMsg S(128) SUCCESS 当业务结果FAIL时,返回错误代码
作者:xiaofeng  创建时间:2025-03-25 15:29
最后编辑:xiaofeng  更新时间:2025-06-05 10:43