微信投诉查询API为通用接口,商户可以通过该接口查询投诉协商历史


接口说明

测试请求URL:https://test-api.huishouqian.com/complaint/queryHistory

生产请求URL:https://api.huishouqian.com/complaint/queryHistory

请求方式:POST

公共请求参数

变量 参数名 类型[长度限制] 必填 描述
method 方法名 string[1,32] COMPLAINT_QUERY_HISTORY
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] 签名数据

业务请求参数

变量 参数名 类型[长度限制] 必填 描述
limit 返回条数 int[0,300] 最大300,默认100
offset 分页开始位置 int[0,-] 该次请求的分页开始位置,从0开始计数,例如offset=10,表示从第11条记录开始返回,不传默认为0。
complaintId 投诉单号 string[1,64]

公共请求示例

{method=COMPLAINT_QUERY_HISTORY, format=JSON, signType=RSA2, signContent=【参考业务请求示例】,sign=7ecbad9cb113bd54e6ee45f7fe76883a40428d548b7294ce8f7ba30f211881073820d3ec7a54d3406dcf7a4d3f87f0994c24db54bab430777425147378dbf01afe0491a1c287e5ce380454b0e228a5a20d541874c14addd4100199660e6c4a857fa080ceb4601a0ee21e3fab9d87016198f151a3b16f60a254c1e8b4cd42cdf7, version=1.0, merchantNo=814000473149}

业务请求示例

{
"limit":100,
"complaintId":"200210220211228100360913215", 
}

公共响应参数

变量 参数名 类型[长度限制] 必填 描述
success 响应状态 string[1,32] 服务端响应状态,如果为true,则可以调用result;如果为false,则调用errorCode来获取出错信息
errorCode 错误码 string[1,32] 响应码
errorMsg 错误描述 string[1,128] 响应描述
result 响应内容 string 业务响应参数,当加密类型为CFCA时,此字段为密文
sign 签名数据 string[1,128] 响应验签数据

业务响应参数

变量 参数名 类型[长度限制] 必填 描述
offset 分页开始位置 int[0,500] 分页开始位置
totalSize 返回条数 int 投诉协商历史总条数,当offset=0时返回正确条数,其余值返回0
data 投诉协商历史 array
logId 操作流水号 string[1,32]
operator 操作人 string[1,64]
operateTime 操作时间 string[1,64]
operateType 操作类型 string[1,64] 当前投诉协商记录的操作类型
详见操作类型状态码
operateDetails 操作内容 string[1, 200]
imageList 图片凭证 array 详见投诉单状态码

公共响应示例

{
"success":true,
"result":"【业务响应示例】",
"errorCode":null,
"errorMsg":null,
"sign":"88faca1f2511cc194367ffd96aa78a4cdf25a8284b0cd74b75e331b37c642b26aaeb46f2e4be38080eeb2b78575abd715d58fd30bbf59e167d64d0b714487f9462381e499a48524b1704694f256fa8f6e917d33cd413e365872ef2c7eede37ab4b23f67dcf6f34ec0daf65a34502123f792a646bea6447c126a612087825b17b91e585f74e56220328b198982e62a734387cd8556927e6881878b821969b6e784a20771cf55fad70a4368b8650c0ece0a7903678e1ad6134f6c711329a3e3e456c28ffbfc607fa6bf1f969a4d38b35ca3bf9ad81f71b2d2ad816502d579c0c4fc1f1fccec74a861c4679c5217be0176bf1eebcb57aea381f922fcf920aa471198be972f0c4f9fab10f7885b9c09eda977351b40e9058247ec30da55dd4c0be4a9de7d996e186e9f9ff2693f564f0eaddca9d7ff9f3b813d0c70bdba75b2a1bf9bd4ddf28ff66c45d6ce31e188d8606c82078d842008a9a1b4c1b64b7b2d3632087e46bbc4322181a9832cecd852682fdb72d336b32512bde94e81ba322fe9d2d"
}

业务响应示例

{
"data":[
{
"imageList":[
],
"logId":"300210220211228100360913216",
"operateDetails":"昨天晚上我都没有充电,为什么要扣款请核对一下。",
"operateTime":"20211228105914",
"operateType":"USER_CREATE_COMPLAINT",
"operator":"投诉人"
},
{
"imageList":[
],
"logId":"300210220211228100360913218",
"operateDetails":"用户已向微信支付投诉贵司,请于3个自然日内妥善处理用户投诉",
"operateTime":"20211228105916",
"operateType":"USER_CREATE_COMPLAINT_SYSTEM_MESSAGE",
"operator":"系统"
},
{
"imageList":[
],
"logId":"300210220211228130361166399",
"operateDetails":"您好,相关业务投诉已向商户反馈,具体业务请于商户核实处理结果,请保持手机畅通,谢谢。",
"operateTime":"20211228133138",
"operateType":"MERCHANT_RESPONSE",
"operator":"商家"
},
{
"imageList":[
],
"logId":"300210220211229160362846059",
"operateDetails":"商家已原路全额退款",
"operateTime":"20211229163003",
"operateType":"COMPLAINT_FULL_REFUNDED_SYSTEM_MESSAGE",
"operator":"系统"
},
{
"imageList":[
],
"logId":"300210220211229160362891198",
"operateDetails":"投诉已处理完成",
"operateTime":"20211229165254",
"operateType":"MERCHANT_CONFIRM_COMPLETE",
"operator":"商家"
},
{
"imageList":[
],
"logId":"300210220211229160362891199",
"operateDetails":"若问题仍未得到解决,请继续投诉",
"operateTime":"20211229165255",
"operateType":"MERCHANT_CONFIRM_COMPLETE_SYSTEM_MESSAGE",
"operator":"系统"
}
],
"offset":0,
"totalSize":6
}

操作类型状态码

状态码 描述
USER_RESPONSE 用户留言
PLATFORM_RESPONSE 平台留言
MERCHANT_RESPONSE 商户留言
MERCHANT_CONFIRM_COMPLET 商户处理完成
COMPLAINT_FULL_REFUNDED 投诉单全额退款
USER_CREATE_COMPLAINT_SYSTEM_MESSAGE 用户提交投诉系统通知
COMPLAINT_FULL_REFUNDED_SYSTEM_MESSAGE 投诉单全额退款系统通知
USER_CONTINUE_COMPLAINT_SYSTEM_MESSAGE 用户继续投诉系统通知
MERCHANT_CONFIRM_COMPLETE_SYSTEM_MESSAGE 商户处理完成系统通知
USER_REVOKE_COMPLAINT 用户主动撤诉
USER_COMFIRM_COMPLAINT 用户确认投诉解决
PLATFORM_HELP_APPLICATION 平台问询
USER_APPLY_PLATFORM_HELP 申请协助

业务响应码

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