微信支付-开发者文档

返回上一层文档首页 / 查询投诉协商历史

查询投诉协商历史API

最新更新时间：2021.1.8 版本说明

商户可通过调用此接口，查询指定投诉的用户商户协商历史，方便商户根据处理历史来制定后续处理方案。

注意：

1、接口已经从目前的V1.0版本升级到V2.0版本，请尽快升级，2.0版本文档请查阅。

2、V1.0版本接口将继续运营一段时间，具体下线时间请关注商户平台公告和微信支付邮件

3、V1.0版接口与V2.0版本接口区别说明

接口说明

适用对象：服务商渠道商从业机构

请求URL：https://api.mch.weixin.qq.com/v3/merchant-service/complaints/{transaction_id}/negotiation-historys

请求方式：GET

path 指该参数为路径参数

query 指该参数为URL参数

body 指该参数需在请求JSON传参

请求参数

参数名	变量	类型[长度限制]	必填	描述
微信支付订单号	transaction_id	string[1, 64]	是	path投诉单对应的微信订单号示例值：4200000404201909069117582536

请求示例


https://api.mch.weixin.qq.com/v3/merchant-service/complaints/4200000404201909069117582536/negotiation-historys


｛
JAVA示例代码
｝

返回参数

参数名

变量

类型[长度限制]

必填

描述

+投诉协商历史

complaint_negotiation_history

array

否

投诉协商历史信息。如果查询结果为空时，则为空数组。

参数名	变量	类型[长度限制]	必填	描述
操作人	operate_user	string[1, 64]	是	当前投诉协商记录的操作人，操作人枚举值包含：投诉人、商户、系统。示例值：投诉人
操作时间	operate_time	string[1, 32]	是	当前投诉协商记录的操作时间，遵循rfc3339标准格式，格式为yyyy-MM-DDTHH:mm:ss.sss+TIMEZONE，yyyy-MM-DD表示年月日，T出现在字符串中，表示time元素的开头，HH:mm:ss.sss表示时分秒毫秒，TIMEZONE表示时区（+08:00表示东八区时间，领先UTC 8小时，即北京时间）。例如：2015-05-20T13:29:35.120+08:00表示北京时间2015年05月20日13点29分35秒。示例值：2015-05-20T13:29:35.120+08:00
操作类型	operate_type	string[1, 64]	是	当前投诉协商记录的操作类型，枚举值： USER_CREATE_COMPLAINT：用户提交投诉 CREATE_COMPLAINT_BY_PLATFORM：用户提交投诉 USER_CONTINUE_COMPLAINT：用户继续投诉 USER_REVOKE_COMPLAINT：用户主动撤诉 USER_CONFIRM_COMPLAINT：用户确认投诉已解决 SELLER_REFUND：投诉单已全额退款 MERCHANT_LAUNCH_CONFIRM_PROCESS：商户反馈处理结果 USER_RESPONSE：用户留言 MERCHANT_RESPONSE：商户留言 RESPONSE_BY_PLATFORM：平台留言 CONTINUE_COMPLAINT_BY_PLATFORM：平台代用户继续投诉 CREATE_COMPLAINT_SYSTEM_MESSAGE：提交投诉系统通知 COMPLAINT_TIMEOUT_SYSTEM_MESSAGE：投诉单超时系统通知 SELLER_REFUND_SYSTEM_MESSAGE：全额退款系统通知 CONTINUE_COMPLAINT_SYSTEM_MESSAGE：继续投诉系统通知 LAUNCH_CONFIRM_PROCESS_SYSTEM_MESSAGE：反馈处理结果系统通知示例值：CREATE_COMPLAINT_BY_PLATFORM
操作内容	operate_details	string[1, 200]	否	当前投诉协商记录的具体内容。示例值：投诉一个重复扣费问题
协商历史图片凭证	image_list	array	否	当前投诉协商记录提交的图片凭证（url格式），最多返回4张图片，url有效时间为1小时。如未查询到协商历史图片凭证，则返回空数组。示例值：https://qpic.cn/xxx

返回示例

正常示例


{
  "complaint_negotiation_history": [
    {
      "operate_user": "投诉人",
      "operate_time": "2015-05-20T13:29:35.120+08:00",
      "operate_type": "USER_CREATE_COMPLAINT",
      "operate_details": "投诉一个重复扣费问题",
      "image_list": [
        "https://qpic.cn/xxx"
      ]
    }
  ]
}


http://2323weixin.qq.com

错误码公共错误码

状态码	错误码	描述	解决方案
500	SYSTEM_ERROR	系统错误	5开头的状态码都为系统问题，请使用相同参数稍后重新调用
400	PARAM_ERROR	参数错误	根据错误提示，传入正确参数
400	INVALID_REQUEST	请求参数符合参数格式，但不符合业务规则项	请确认参数符合业务要求，稍后重新调用
401	SIGN_ERROR	签名验证失败	请检查签名参数和方法是否都符合签名算法要求
403	NO_AUTH	商户暂无权限使用此功能	请开通商户号权限。请联系产品或商务申请
429	FREQUENCY_LIMITED	频率超限	请求量不要超过接口调用频率限制

消费者投诉V1.0版接口与V2.0版本区别

关闭

V2.0	接口	V1.0
新增“投诉单号” 新增“用户投诉次数” 新增“有新留言”	查询投诉列表接口	无
新增“投诉单号” 新增“用户投诉次数” 新增“有新留言”	查询投诉详情接口	无
新增动作类型“商户新回复” 新增动作类型“商户反馈处理完成”	回调接口	新增动作类型“商户新回复” 新增动作类型“商户反馈处理完成”
将回复及反馈处理完成拆成2个接口	处理投诉接口	回复跟反馈处理完成公用一个接口
待处理、处理中、处理完成	投诉单状态	待商户处理、商家已反馈、用户已确认、用户已撤诉、商户已退款

微信支付合作伙伴平台