接口说明
微信小程序受管控后,在用户确认收货/系统自动收货后,订单资金才会解冻结算,此时宝付会通知到商户预留的指定后端地址。商户接收到通知系统处理完成后,按约定返回OK。
- 通知频率:最多通知14次
0秒/10秒/10秒/10秒/10秒/15秒/1分钟/3分钟/10分钟/30分钟/60分钟/3小时/6小时/6小时
注意事项:
- 由于网络抖动等异常因素以及商户侧未按照约定返回OK,宝付支付系统会多次请求商户侧通知地址,商户系统需做订单的幂等性处理,避免重复处理导致损失。
- 商户系统接收到异步通知后,为保证资金安全需做验签处理。
- 初次使用请仔细核对,信息是否有误,出现错误请及时联系宝付技术人员。
通知参数
| 字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
|---|---|---|---|---|---|
| 代理商商户号 | agentMerId | 否 | S(16) | 100000 | 宝付支付分配的商户号 |
| 代理商终端号 | agentTerId | 否 | S(16) | 100000 | 宝付支付分配的终端号 |
| 商户号 | merId | 是 | S(16) | 100000 | 宝付支付分配的商户号 |
| 终端号 | terId | 是 | S(16) | 100000 | 宝付支付分配的终端号 |
| 宝付订单号 | tradeNo | 是 | S(32) | 12312312312 | 与商户订单号对应的宝付侧唯一订单号 |
| 商户订单号 | outTradeNo | 是 | S(32) | 20210315155012 | 商户系统内部订单号,同一个商户号下唯一 |
| 资金冻结状态 | fundFreezeState | 是 | S(16) | UNFREEZE | UNFREEZE:解冻 |
| 解冻金额 | unfreezeAmt | 是 | S(16) | 1200 | 单位分,含手续费;不含退款金额。如订单金额为10元,冻结期间退款2元,则解冻金额为8元。 |
| 冻结时间 | freezeTime | 是 | S(16) | 20251123102030 | 格式为yyyyMMddHHMMSS;订单资金冻结时间,一般为支付成功时间 |
| 解冻时间 | unfreezeTime | 是 | S(16) | 20251125141526 | 格式为yyyyMMddHHMMSS;宝付在确认渠道资金解冻后,解冻本订单资金的时间,一般约为订单确认收货的时间 |
作者:lilizhi 创建时间:2025-12-09 02:30
最后编辑:lilizhi 更新时间:2025-12-11 16:01
最后编辑:lilizhi 更新时间:2025-12-11 16:01