用户服务开通状态变更通知
应用场景
- 用户开通服务或解除授权时,即签约和解约,宝付系统会将消息发送至商户指定的服务端地址(需联系宝付提前配置)。商户接收到通知系统处理完成后,按约定返回OK。
- 注意:商户侧收到支付结果通知并且验签通过后,请判断订单状态为SUCCESS或CLOSED进行后续业务处理。注意:商户侧收到支付结果通知并且验签通过后,请判断订单状态为SUCCESS或CLOSED进行后续业务处理。
注意事项:
- 由于网络抖动等异常因素以及商户侧未按照约定返回OK,宝付支付系统会多次请求商户侧通知地址,商户系统需做订单的幂等性处理,避免重复处理导致损失。
- 商户系统接收到异步通知后,为保证资金安全建议做验签处理,防止数据篡改泄漏等造成资损。
- 初次使用请仔细核对,信息是否有误,出现错误请及时联系宝付技术人员。
通知参数
字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
---|---|---|---|---|---|
代理商商户号 | agentMerId | S(16) | 否 | 100003789 | 宝付支付分配的商户号 |
代理商终端号 | agentTerId | S(16) | 否 | 213003567 | 宝付支付分配的终端号 |
交易商户号 | merId | S(16) | 是 | 102002369 | 宝付支付分配的商户号 |
交易终端号 | terId | S(16) | 是 | 100003123 | 宝付支付分配的终端号 |
商户外部协议号 | outAgreementNo | S(32) | 是 | 12312312312 | 商户系统内部协议号,同一个商户号下唯一 |
协议状态 | agreementState | S(32) | 否 | INVALID | INVALID:无效;VALID:有效 |
状态变更时间 | bizTime | T | 否 | ||
开通渠道 | openChannel | S(64) | 否 | ||
渠道返回参数 | chlRetParam | C | 否 | JSON格式,会根据业务需求动态添加相应字段属性,详见:【渠道返回参数】 | |
业务结果 | resultCode | S(16) | 是 | SUCCESS | 业务处理结果 |
错误代码 | errCode | S(32) | 否 | 当业务结果FAIL时,返回错误代码 | |
错误描述 | errMsg | S(128) | 否 | 当业务结果为FAIL时,返回错误描述 |
作者:lilizhi 创建时间:2025-03-21 18:45
最后编辑:lilizhi 更新时间:2025-06-17 14:16
最后编辑:lilizhi 更新时间:2025-06-17 14:16