商户创建投诉通知回调URL 后，当有新的投诉事件发生、投诉状态发生变化时，商户会收到通知回调。

接口说明

通知地址：商户交予运维配置的回调通知地址。

通知方式：POST

通知规则

商户收到服务端通知后需返回字符串SUCCESS，如果未收到应答或未按要求返回，则视为通知失败，系统会重新发起通知，尽可能提高通知的成功率，通知频率为0s/3s/5s/10s/15s/60s/3m/10m/30m/60m/3h/6h/6h ,如果还通知失败，可调用查询订单API查询结果。

公共通知参数

变量 参数名 类型[长度限制] 必填 描述
method 方法名 string[1,32] 是 CALLBACK
version 版本 string[1,16] 是 接口版本：1.0
format 请求格式 string[1,16] 是 业务请求参数格式，支持：JSON
merchantNo 商户号 string[1,16] 是 商户在慧收钱的商户号，由慧收钱生成并下发
signType 加密类型 string[1,16] 是 CFCA:加密机制查看说明
signContent 加密数据 string 是 业务请求参数，当加密类型为CFCA时，此字段上送加密后密文
sign 签名数据 string[1,128] 否 签名数据

业务参数

变量 参数名 类型[长度限制] 必填 描述
actionType 动作类型 string[1, 64] 是 触发本次投诉通知回调的具体动作类型
当前投诉协商记录的操作类型
详见动作类型状态码
complaintId 投诉单号 string[1, 64] 是

公共通知示例

{method=CALLBACK, format=json, signType=CFCA, signContent=3fbf98d18b060fa562c029252990b1cc3888553232b884f9c50d31779b46fb7141da82718d8ecaf134e414da5b77f499cf7bb7b7f0f37128c8516b6bc36bd4cbc3ad96b157062d803325adb8c802d6dae630abfde1a80f39ed3c9850a1f3b6215980f602ccab71cc05852df4fd44560ef8e29e9b9a690f025cde959dea27a909, version=1.0, merchantNo=814000473149}

业务示例

{
  "complaintId": "200201820200101080076610000",
  "actionType":"CREATE_COMPLAINT"
}

应答参数

客户端在正常接收服务端通知报文同步响应“SUCCESS”来结束此流程。

动作类型状态码

状态码 描述
CREATE_COMPLAINT 用户提交投诉
CONTINUE_COMPLAINT 用户继续投诉
USER_RESPONSE 用户新留言
RESPONSE_BY_PLATFORM 平台新留言
SELLER_REFUND 收款方全额退款
MERCHANT_RESPONSE 商户新回复
MERCHANT_CONFIRM_COMPLETE 商户反馈处理完成

业务响应码

状态码 描述
000000 成功
000001 系统异常，请稍后再试
130000 受理成功
130001 结果未知,请稍后查询
130002 参数校验不通过
130003 投诉订单号不存在
130004 商户号不匹配
130005 商户号不存在
130006 代理商户号不匹配
130007 文件大小超限
130008 文件类型不合法
130009 回复上传图片不能超过四张
130010 投诉订单号不能为空
130011 商户秘钥未配置
作者：xiaochen  创建时间：2023-05-24 14:46
最后编辑：admin  更新时间：2024-09-19 18:06