查询投诉协商历史API

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


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

接口说明

适用对象:直连商户 服务商 渠道商

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

请求方式:get

接口规则:https://pay.weixin.qq.com/wiki/doc/apiv3/wechatpay/wechatpay-1.shtml


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.1
2021年1月8日
字段operate_type新增枚举
V1.0
2020年11月27日
查询投诉协商历史接口上线

技术咨询

文档反馈