查询投诉单协商历史

更新时间：2024.12.26

商户可通过调用此接口，查询指定投诉单的用户与商户的协商历史，以分页输出查询结果，方便商户根据处理历史来制定后续处理方案。

接口说明

支持商户：【普通商户】

请求方式：【GET】/v3/merchant-service/complaints-v2/{complaint_id}/negotiation-historys

请求域名：【主域名】https://api.mch.weixin.qq.com 使用该域名将访问就近的接入点

　　　　　【备域名】https://api2.mch.weixin.qq.com 使用该域名将访问异地的接入点，指引点击查看

请求参数

Header HTTP头参数

Authorization 　必填　string

请参考签名认证生成认证信息

Accept 　必填　string

请设置为application/json

path 路径参数

complaint_id 　必填 string(64)

【投诉单号】投诉单对应的投诉单号

query 查询参数

limit 　选填 integer

【分页大小】设置该次请求返回的最大协商历史条数，范围[1,300]

offset 　选填 integer

【分页开始位置】该次请求的分页开始位置，从0开始计数，例如offset=10，表示从第11条记录开始返回。

请求示例

GET

1curl -X GET \
2  https://api.mch.weixin.qq.com/v3/merchant-service/complaints-v2/200201820200101080076610000/negotiation-historys?limit=50&offset=10 \
3  -H "Authorization: WECHATPAY2-SHA256-RSA2048 mchid=\"1900000001\",..." \
4  -H "Accept: application/json"

应答参数

200 OK

data 　选填 array[object]

【投诉协商历史】投诉协商历史

属性

log_id 　必填 string(64)

【操作流水号】操作流水号

operator 　必填 string(64)

【操作人】当前投诉协商记录的操作人

operate_time 　必填 string(64)

【操作时间】当前投诉协商记录的操作时间

operate_type 　必填 string

【操作类型】当前投诉协商记录的操作类型，对应枚举ComplaintNegotiationOperateType

可选取值：：

USER_CREATE_COMPLAINT: 用户提交投诉
USER_CONTINUE_COMPLAINT: 用户继续投诉
USER_RESPONSE: 用户留言
PLATFORM_RESPONSE: 平台留言
MERCHANT_RESPONSE: 商户留言
MERCHANT_CONFIRM_COMPLETE: 商户申请结单
USER_CREATE_COMPLAINT_SYSTEM_MESSAGE: 用户提交投诉系统通知
COMPLAINT_FULL_REFUNDED_SYSTEM_MESSAGE: 投诉单发起全额退款系统通知
USER_CONTINUE_COMPLAINT_SYSTEM_MESSAGE: 用户继续投诉系统通知
USER_REVOKE_COMPLAINT: 用户主动撤诉（只存在于历史投诉单的协商历史中）
USER_COMFIRM_COMPLAINT: 用户确认投诉解决（只存在于历史投诉单的协商历史中）
PLATFORM_HELP_APPLICATION: 平台催办
USER_APPLY_PLATFORM_HELP: 用户申请平台协助
MERCHANT_APPROVE_REFUND: 商户同意退款申请
MERCHANT_REFUSE_RERUND: 商户拒绝退款申请, 此时操作内容里展示拒绝原因
USER_SUBMIT_SATISFACTION: 用户提交满意度调查结果,此时操作内容里会展示满意度分数
SERVICE_ORDER_CANCEL: 服务订单已取消
SERVICE_ORDER_COMPLETE: 服务订单已完成
COMPLAINT_PARTIAL_REFUNDED_SYSTEM_MESSAGE: 投诉单发起部分退款系统通知
COMPLAINT_REFUND_RECEIVED_SYSTEM_MESSAGE: 投诉单退款到账系统通知
COMPLAINT_ENTRUSTED_REFUND_SYSTEM_MESSAGE: 投诉单受托退款系统通知
USER_APPLY_PLATFORM_SERVICE: 用户申请平台协助
USER_CANCEL_PLATFORM_SERVICE: 用户取消平台协助
PLATFORM_SERVICE_FINISHED: 客服结束平台协助

operate_details 　选填 string(200)

【操作内容】当前投诉协商记录的具体内容

image_list 　选填 array[string]

【图片凭证】商户或微信支付客服上传的图片，以URL形式返回。注：此字段不包含用户提交的图片凭证，建议统一使用complaint_media_list字段接收和请求资料凭证，未来该字段将废弃

complaint_media_list 　选填 object

【操作资料列表】对投诉单执行操作时上传的资料凭证，包含用户、商户、微信支付客服等角色操作

属性

media_type 　必填 string

【媒体文件业务类型】媒体文件对应的业务类型

可选取值：：

USER_COMPLAINT_IMAGE: 用户提交投诉时上传的图片凭证
OPERATION_IMAGE: 用户、商户、微信支付客服在协商解决投诉时，上传的图片凭证

media_url 　必填 array[string(512)]

【媒体文件请求url】 微信返回的媒体文件请求url，详细调用请参考：图片请求接口
示例"https://api.mch.weixin.qq.com/v3/merchant-service/images/xxxxx”中"xxxxx" 代表媒体文件标识 ID(meida_id)

user_appy_platform_service_reason 　选填 string

【用户申请平台协助原因】 用户此次申请平台协助时选择的申请协助原因

user_appy_platform_service_reason_description 　选填 string

【用户申请平台协助原因描述】 用户此次申请平台协助时填写的具体申请协助原因描述

limit 　必填 integer

【分页大小】设置该次请求返回的最大协商历史条数，范围[1,300]

offset 　必填 integer

【分页开始位置】设置该次请求返回的最大协商历史条数，范围[1,300]

total_count 　选填 integer

【投诉协商历史总条数】投诉协商历史总条数，当offset=0时返回

应答示例

200 OK

1{
2  "data" : [
3    {
4      "log_id" : "300285320210322170000071077",
5      "operator" : "投诉人",
6      "operate_time" : "2015-05-20T13:29:35.120+08:00",
7      "operate_type" : "USER_CREATE_COMPLAINT",
8      "operate_details" : "已与用户电话沟通解决",
9      "image_list" : [
10        "https://qpic.cn/xxx"
11      ],
12      "complaint_media_list" : {
13        "media_type" : "USER_COMPLAINT_IMAGE",
14        "media_url" : [
15          "https://api.mch.weixin.qq.com/v3/merchant-service/images/xxxxx"
16        ]
17      },
18      "user_appy_platform_service_reason" : "商家响应不及时",
19      "user_appy_platform_service_reason_description" : "一周前就提交咨询了，到现在商家还没理我"
20    }
21  ],
22  "limit" : 50,
23  "offset" : 50,
24  "total_count" : 1000
25}

错误码

公共错误码

状态码	错误码	描述	解决方案
400	PARAM_ERROR	参数错误	请根据错误提示正确传入参数
400	INVALID_REQUEST	HTTP 请求不符合微信支付 APIv3 接口规则	请参阅接口规则
401	SIGN_ERROR	验证不通过	请参阅签名常见问题
500	SYSTEM_ERROR	系统异常，请稍后重试	请稍后重试

业务错误码

状态码	错误码	描述	解决方案
400	INVALID_REQUEST	请求参数符合参数格式，但不符合业务规则项	请确认参数符合业务要求，稍后重新调用
403	NO_AUTH	无权限	请开通商户号权限，并确认参数符合规范
429	FREQUENCY_LIMITED	频率超限	请求量不要超过接口调用频率限制
500	SYSTEM_ERROR	系统错误	5开头的状态码都为系统问题，请使用相同参数稍后重新调用

文档是否有帮助

更多支持

开发文档(服务商)开发文档(V2版)开发者社区微信开放平台微信公众平台腾讯客服