通知结果

接口说明

商户创建投诉通知回调URL 后,当有新的投诉事件发生、投诉状态发生变化时,商户会收到通知回调。商户接收到通知系统处理完成后,按约定返回OK。

注意事项:

由于网络抖动等异常因素以及商户侧未按照约定返回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 商户系统内部订单号,同一个商户号下唯一
投诉单号 complaintId 是 S(64) 200201820200101080076610000 投诉单对应的投诉单号
投诉单创建时间 createTime 是 T 2021-12-16 09:00:00 通知创建的时间,格式为YYYY-MM-DD HH:mm:ss
通知类型 eventType 是 E COMPLAINT.CREATE 通知的类型,投诉事件通知的类型值,详见附录
通知ID notifyId 是 S(32) EV-2018022511223320873 通知的唯一ID
通知时间 notifyTime 是 T 2021-12-16 09:00:00 通知的时间,格式为YYYY-MM-DD HH:mm:ss
回调摘要 summary 是 S(64) 产生新投诉 回调摘要
动作类型 actionType 是 E CREATE_COMPLAINT 触发本次投诉通知回调的具体动作类型,详见附录
业务结果 resultCode 是 S(16) SUCCESS

SUCCESS:成功

FAIL:失败

错误代码 errCode 否 S(32) 当业务结果FAIL时,返回错误代码
错误描述 errMsg 否 S(128) 当业务结果为FAIL时,返回错误描述
作者:郑成定  创建时间:2026-05-22 15:09
最后编辑:郑成定  更新时间:2026-09-17 19:13