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

接口说明

支持商户：

【普通服务商】【从业机构（银行）】【从业机构（支付机构）】【渠道商】【清算机构】

请求方式：

【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

应答参数

200OK
data 选填 array[ComplaintInfo]
【用户投诉信息详情】 用户投诉信息详情
• 属性
limit 必填 integer
【分页大小】 设置该次请求返回的最大投诉条数，范围[1,50]
offset 必填 integer
【分页开始位置】 该次请求的分页开始位置，从0开始计数，例如offset=10，表示从第11条记录开始返回。
total_count 选填 integer
【投诉总条数】 投诉总条数，当offset=0时返回

应答示例

200 OK

错误码

公共错误码

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

业务错误码

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