微信投诉协商历史接口文档
1. 接口概述
| 项目 | 说明 |
|---|---|
| 接口名称 | 微信投诉协商历史查询 |
| 接口用途 | 根据投诉单号查询该投诉的协商历史记录 |
| 对外请求方式 | POST（JSON body，Content-Type: application/json） |
| 对外接口地址 | /api/v1/complaint/wechat/negotiationHistorys |
2. 请求参数
| 参数名 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
| complaintId | String | 是 | 投诉单号 | 2000000202***8230376368110 |
| mercNum | String | 是 | SaaS商户号 | M100000001 |
| accessid | String | 是 | 接入id | 4028805b6e86***79016e874f6c4200ad |
| sign | String | 是 | 密串（签名） | - |
| currentPage | Integer | 否 | 当前页（默认 1） | 1 |
| pageSize | Integer | 否 | 分页大小（默认 10，范围[1,300]） | 10 |
请求示例：
{
"complaintId": "20000002025***230376368110",
"mercNum": "M100000001",
"accessId": "4028805b6e86d1790***874f6c4200ad",
"sign": "xxxxxxxxxxxx",
"currentPage": 1,
"pageSize": 10
}3响应说明
本接口遵循平台通用响应规范：return_code 为 10000 表示成功，return_msg 为失败原因（仅失败时返回），业务数据置于 data 字段。
3.1 响应参数说明
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| return_code | String | 是 | 返回码，10000 表示成功 |
| return_msg | String | 否 | 返回信息（失败时返回） |
| data | Array | 否 | 协商历史记录数组 |
| offset | Number | 否 | 分页开始位置，范围[1,300] |
| limit | Number | 否 | 分页大小，范围[1,300] |
| total_count | Number | 否 | 投诉协商历史总条数，当offset=0时返回 |
3.1.1 data 数组元素结构
| 参数名 | 类型 | 说明 |
|---|---|---|
| log_id | String | 【操作流水号】 操作流水号 |
| complaint_media_list | Object | 媒体文件列表 |
| complaint_media_list.media_type | String | 【媒体文件业务类型】 媒体文件对应的业务类型，可选取值： - USER_COMPLAINT_IMAGE: 用户提交投诉时上传的图片凭证- OPERATION_IMAGE: 用户、商户、微信支付客服在协商解决投诉时，上传的图片凭证 |
| complaint_media_list.media_url | Array<String> | 【媒体文件请求url】 微信返回的媒体文件请求url，示例 https://api.mch.weixin.qq.com/v3/merchant-service/images/xxxxx 中 “xxxxx” 代表媒体文件标识 ID(media_id) |
| operate_type | String | 【操作类型】 当前投诉协商记录的操作类型，对应枚举ComplaintNegotiationOperateType（详见下方枚举值说明） |
| operate_details | String | 【操作内容】 当前投诉协商记录的具体内容 |
| operator | String | 【操作人】 当前投诉协商记录的操作人 |
| image_list | Array<String> | 【图片凭证】 商户或微信支付客服上传的图片，以URL形式返回。注：此字段不包含用户提交的图片凭证，建议统一使用 complaint_media_list 字段接收和请求资料凭证，未来该字段将废弃 |
| operate_time | String | 【操作时间】 当前投诉协商记录的操作时间 |
| normal_message | Object | 【消息内容】 消息内容块，支持文本、图片、链接、推荐FAQ、按钮和按钮组等多种类型 |
| normal_message.blocks | Array<Object> | 消息内容块列表 |
| normal_message.blocks[].type | String | 【消息块类型】 消息块类型，可选取值： - TEXT: 文本- IMAGE: 图片- LINK: 链接- FAQ_LIST: FAQ列表- BUTTON: 按钮- BUTTON_GROUP: 按钮组 |
| normal_message.blocks[].text | Object | 【文本】 文本消息块，当type为TEXT时使用 |
| normal_message.blocks[].text.text | String | 文本内容 |
3.1.2 operate_type 枚举值说明
| 枚举值 | 说明 |
|---|---|
| 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 | 客服结束平台协助 |
| USER_CLICK_RESPONSE | 用户因点击产生留言 |
4. 错误码说明
| return_code | return_msg | 说明 |
|---|---|---|
| 10000 | - | 成功 |
| 99999 | 未查询到该投诉单详情 | 通过投诉单号调用detail方法失败或返回空 |
| 99999 | 未查询到该投诉单对应的机构号 | 投诉详情中 complaintedMchid 为空 |
| 99999 | 其他 | 下游返回的 rspMsg |
| 99998 | 参数xxx不能为空 | 参数校验失败（由 ValidateParamsUtils 返回） |
| - | 签名错误 | sign校验失败（由 ValidateSignInterceptor 返回） |
文档更新时间: 2026-09-03 10:43 作者：张亚飞
