通知结果
接口说明
商户创建投诉通知回调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
最后编辑:xiaofeng 更新时间:2025-06-05 10:43