查询投诉单列表

更新时间：2024.12.26

商户可通过调用此接口，查询指定时间段的所有用户投诉信息，以分页输出查询结果。对于服务商、渠道商，可通过调用此接口，查询指定特约商户号下的投诉信息，若不指定，则查询的是名下所有特约商户投诉信息。

接口说明

支持商户：【普通商户】

请求方式：【GET】/v3/merchant-service/complaints-v2

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

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

请求参数

Header HTTP头参数

Authorization 　必填　string

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

Accept 　必填　string

请设置为application/json

query 查询参数

limit 　选填 integer

【分页大小】设置该次请求返回的最大投诉条数，范围[1,50]

offset 　选填 integer

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

begin_date 　必填 string(10)

【开始日期】投诉发生的开始日期。注意，查询日期跨度不超过30天

end_date 　必填 string(10)

【结束日期】投诉发生的结束日期。注意，查询日期跨度不超过30天

complainted_mchid 　选填 string(64)

【被诉商户号】投诉单对应的被诉商户号。当服务商或渠道商查询指定子商户的投诉信息时需传入

请求示例

GET

1curl -X GET \
2  https://api.mch.weixin.qq.com/v3/merchant-service/complaints-v2?limit=5&offset=10&begin_date=2019-01-01&end_date=2019-01-01&complainted_mchid=1900012181 \
3  -H "Authorization: WECHATPAY2-SHA256-RSA2048 mchid=\"1900000001\",..." \
4  -H "Accept: application/json"

应答参数

200 OK

data 　选填 array[object]

【用户投诉信息详情】用户投诉信息详情

属性

complaint_id 　必填 string(64)

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

complaint_time 　必填 string(32)

【投诉时间】投诉时间

complaint_detail 　必填 string(300)

【投诉详情】投诉的具体描述

complaint_state 　必填 string(30)

【投诉单状态】标识当前投诉单所处的处理阶段，具体状态如下所示：
PENDING-待处理
PROCESSING-处理中
PROCESSED-已处理完成

payer_phone 　选填 string(512)

【投诉人联系方式】投诉人联系方式。该字段已做加密处理，具体解密方法详见如何使用API证书解密敏感字段

complaint_order_info 　选填 array[object]

【投诉单关联订单信息】投诉单关联订单信息

属性

complaint_full_refunded 　必填 boolean

【投诉单是否已全额退款】投诉单下所有订单是否已全部全额退款

incoming_user_response 　必填 boolean

【是否有待回复的用户留言】投诉单是否有待回复的用户留言

user_complaint_times 　必填 integer

【用户投诉次数】用户投诉次数。用户首次发起投诉记为1次，用户每有一次继续投诉就加1

complaint_media_list 　选填 array[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)

problem_description 　必填 string(256)

【问题描述】用户发起投诉前选择的faq标题（2021年7月15日之后的投诉单均包含此信息）

problem_type 　选填 string

【问题类型】问题类型为申请退款的单据是需要最高优先处理的单据

可选取值：：

REFUND: 申请退款
SERVICE_NOT_WORK: 服务权益未生效
OTHERS: 其他类型

apply_refund_amount 　选填 integer

【申请退款金额】仅当问题类型为申请退款时, 有值, (单位:分)

user_tag_list 　选填 array[string]

【用户标签列表】用户标签列表

可选取值：：

TRUSTED: 此类用户满足极速退款条件
HIGH_RISK: 高风险投诉，请按照运营要求优先妥善处理

service_order_info 　选填 array[object]

【投诉单关联服务单信息】

属性

order_id 　选填 string(128)

【微信支付服务订单号】微信支付服务订单号，每个微信支付服务订单号与商户号下对应的商户服务订单号一一对应

out_order_no 　选填 string(128)

【商户服务订单号】商户系统内部服务订单号（不是交易单号），与创建订单时一致

state 　选填 string

【支付分服务单状态】此处上传的是用户发起投诉时的服务单状态，不会实时更新

可选取值：：

DOING: 服务订单进行中
REVOKED: 服务订单已取消
WAITPAY: 服务订单待支付
DONE: 服务订单已完成

additional_info 　选填 object

【补充信息】用在特定行业或场景下返回的补充信息

属性

type 　选填 string

【补充信息类型】补充信息类型

可选取值：：

SHARE_POWER_TYPE: 充电宝投诉相关行业

share_power_info 　选填 object

【充电宝投诉相关信息】当type为充电宝投诉相关时有值

属性

in_platform_service 　选填 boolean

【是否在平台协助中】标识当前投诉单是否正处在平台协助流程中。注：在协助期间由微信支付客服为用户服务，期间商户向用户发送的留言用户不可见

need_immediate_service 　选填 boolean

【是否需即时服务用户】因用户诉求紧急度、用户界面差异等因素，部分投诉单建议商户更即时地响应用户诉求。如此处标识为“是”，建议商户提升服务时效，给用户带来更好的体验

limit 　必填 integer

【分页大小】设置该次请求返回的最大投诉条数，范围[1,50]

offset 　必填 integer

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

total_count 　选填 integer

【投诉总条数】投诉总条数，当offset=0时返回

应答示例

200 OK

1{
2  "data" : [
3    {
4      "complaint_id" : "200201820200101080076610000",
5      "complaint_time" : "2015-05-20T13:29:35.120+08:00",
6      "complaint_detail" : "反馈一个重复扣费的问题",
7      "complaint_state" : "PENDING",
8      "payer_phone" : "18500000000",
9      "complaint_order_info" : [
10        {
11          "transaction_id" : "4200000404201909069117582536",
12          "out_trade_no" : "20190906154617947762231",
13          "amount" : 3
14        }
15      ],
16      "complaint_full_refunded" : true,
17      "incoming_user_response" : true,
18      "user_complaint_times" : 1,
19      "complaint_media_list" : [
20        {
21          "media_type" : "USER_COMPLAINT_IMAGE",
22          "media_url" : [
23            "https://api.mch.weixin.qq.com/v3/merchant-service/images/xxxxx"
24          ]
25        }
26      ],
27      "problem_description" : "不满意商家服务",
28      "problem_type" : "REFUND",
29      "apply_refund_amount" : 10,
30      "user_tag_list" : [
31        "TRUSTED"
32      ],
33      "service_order_info" : [
34        {
35          "order_id" : "15646546545165651651",
36          "out_order_no" : "1234323JKHDFE1243252",
37          "state" : "DOING"
38        }
39      ],
40      "additional_info" : {
41        "type" : "SHARE_POWER_TYPE",
42        "share_power_info" : {
43          "return_time" : "2015-05-20T13:29:35+08:00",
44          "return_address_info" : {
45            "return_address" : "广东省深圳市南山区海天二路南山区后海腾讯滨海大厦(海天二路西)",
46            "longitude" : "113.93535488533665",
47            "latitude" : "22.52305518747831"
48          },
49          "is_returned_to_same_machine" : false
50        }
51      },
52      "in_platform_service" : true,
53      "need_immediate_service" : true
54    }
55  ],
56  "limit" : 5,
57  "offset" : 10,
58  "total_count" : 1000
59}

错误码

公共错误码

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

业务错误码

状态码	错误码	描述	解决方案
403	NO_AUTH	商户信息不合法	登录商户平台核对，传入正确信息
429	FREQUENCY_LIMITED	频率超限	请求量不要超过接口调用频率限制
500	SYSTEM_ERROR	系统错误	5开头的状态码都为系统问题，请使用相同参数稍后重新调用

文档是否有帮助

更多支持

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