最新更新时间：2020.11.27 版本说明
商户可通过调用此接口，查询指定时间段的所有用户投诉信息，并在返回结果分页输出查询结果。对于服务商、渠道商，可通过调用此接口，查询指定子商户号对应子商户的投诉信息，若不指定，则查询所有子商户投诉信。
1、接口已经从目前的V1.0版本升级到V2.0版本，请尽快升级，2.0版本文档请查阅。
2、V1.0版本接口将继续运营一段时间，具体下线时间请关注商户平台公告和微信支付邮件
3、V1.0版接口与V2.0版本接口区别说明
适用对象：直连商户
请求URL：https://api.mch.weixin.qq.com/v3/merchant-service/complaints
请求方式：GET
path 指该参数为路径参数
query 指该参数为URL参数
body 指该参数需在请求JSON传参
| 参数名 | 变量 | 类型[长度限制] | 必填 | 描述 |
|---|---|---|---|---|
| 分页大小 | limit | uint32 | 否 | query该次请求每页返回的最大投诉条数，取值范围【1,50】，商户自定义字段，不传默认为10。 示例值：5 |
| 分页开始位置 | offset | uint32 | 否 | query该次请求的分页开始位置，商户自定义字段，默认为0，从0开始计数，譬如offset=10，表示从第11条记录开始返回。 示例值：10 |
| 开始日期 | begin_date | string[1,10] | 是 | query投诉发生的开始日期，格式为yyyy-MM-DD。注意，查询日期跨度不超过30天。 示例值：2019-01-01 |
| 结束日期 | end_date | string[1,10] | 是 | query投诉发生的结束日期，格式为yyyy-MM-DD。注意，查询日期跨度不超过30天。 示例值：2019-01-01 |
| 特约商户号 | sub_mchid | string[1,64] | 否 | query被投诉子商户的商户号，当服务商或渠道商查询指定子商户的投诉信息时，传入此参数。 服务商模式，特约商户号必传 示例值：1900012181 |
https://api.mch.weixin.qq.com/v3/merchant-service/complaints?offset=10&limit=20&begin_date=2019-01-01&end_date=2019-01-03
| 参数名 | 变量 | 类型[长度限制] | 必填 | 描述 |
|---|---|---|---|---|
| +用户投诉信息详情 | data | array | 是 | 用户投诉信息的详情。如果查询结果为空时，则为空数组。 |
| 分页开始位置 | offset | uint32 | 是 | 该次请求的分页开始位置，从0开始计数，譬如offset=10，表示从第11条记录开始返回。 示例值：10 |
| 分页大小 | limit | uint32 | 是 | 该次请求返回的最大投诉条数，范围为【1，50】。 示例值：5 |
| 投诉总条数 | total_count | uint64 | 否 | 投诉总条数，投诉总条数，offset=0时返回，若记录不为空返回投诉总条数，若记录为空返回0。 示例值：1234 |
{
"data": [
{
"out_trade_no": "20190906154617947762231",
"complaint_time": "2015-05-20T13:29:35.120+08:00",
"amount": 3,
"payer_phone": "Qe41VhP/sGdNeTHMQGlxCWiUyHu6XNO9GCYln2Luv4HhwJzZBfcL12sB+PgZcS5NhePBog30NgJ1xRaK+gbGDKwpg==",
"complaint_detail": "反馈一个重复扣费的问题",
"transaction_id": "4200000404201909069117582536",
"frozen_end_time": "2015-05-20T13:29:35.120+08:00",
"sub_mchid": "1900012181",
"complaint_handle_state": "WAIT_MERCHANT_RESPONSE"
}
],
"offset": 10,
"limit": 5,
"total_count": 1234
}
| 状态码 | 错误码 | 描述 | 解决方案 |
|---|---|---|---|
| 500 | SYSTEM_ERROR | 系统错误 | 5开头的状态码都为系统问题，请使用相同参数 稍后重新调用 |
| 400 | PARAM_ERROR | 参数错误 | 根据错误提示，传入正确参数 |
| 403 | NO_AUTH | 商户信息不合法 | 登录商户平台核对，传入正确信息 |
| 429 | FREQUENCY_LIMITED | 频率超限 | 请求量不要超过接口调用频率限制 |