通知结果

接口说明

商户创建投诉通知回调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时,返回错误描述
作者:xiaofeng  创建时间:2025-03-25 17:02
最后编辑:xiaofeng  更新时间:2025-06-05 10:43