接口说明
接口名称 | share_query |
---|---|
是否幂等 | 否 |
接口模式 | 直连 |
异步通知 | 否 |
商户通过分账订单查询接口主动查询分账订单状态。
注意事项:
- 宝付订单号、商户订单号至少选择一个传入,推荐传入宝付订单号,如果同时传入,系统默认使用宝付订单号。
- 由于分账为系统异步处理,建议在提交确认分账1分钟以后发起查询,或者等待宝付支付系统异步通知分账结果。
- 调用确认分账接口,系统返回交易状态异常时,请调用查询接口确认订单状态
接口参数
- 请求:
字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
---|---|---|---|---|---|
代理商商户号 | 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
最后编辑:xiaofeng 更新时间:2025-06-05 10:43