商户创建投诉通知回调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-10-21 15:46
最后编辑:admin 更新时间:2024-10-21 15:46