注意事项:

  • 由于网络抖动等异常因素以及商户侧未按照约定返回OK,宝付支付系统会多次请求商户侧通知地址,商户系统需做订单的幂等性处理,避免重复处理导致损失。
  • 商户系统接收到异步通知后,为保证资金安全建议做验签处理,并校验返回的订单金额与商户侧订单金额一致性,防止数据篡改泄漏等造成资损。
  • 初次使用请仔细核对,信息是否有误,出现错误请及时联系宝付技术人员。

接口说明

  • 支付完成后或订单关闭后,宝付支付系统会把结果通过请求原支付单传入的服务端通知地址,通知到商户侧。商户接收到通知系统处理完成后,按约定返回OK。
  • 注意:商户侧收到支付结果通知并且验签通过后,请判断订单状态为SUCCESS或CLOSED进行后续业务处理。注意:商户侧收到支付结果通知并且验签通过后,请判断订单状态为SUCCESS或CLOSED进行后续业务处理。
  • 聚合通知频率,最多通知14次
    0秒/10秒/10秒/10秒/10秒/15秒/1分钟/3分钟/10分钟/30分钟/60分钟/3小时/6小时/6小时

通知参数

字段名 变量名 必填 类型 示例值 描述
代理商商户号 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 SUCCESS 详见附录订单状态
完成时间 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
渠道返回参数 chlRetParam C 根据不同的支付方式返回相应的业务参数详见:渠道返回参数
清算日期 clearingDate D 20210501
作者:xiaofeng  创建时间:2025-03-25 15:32
最后编辑:xiaofeng  更新时间:2025-04-24 15:18