最新更新时间：2023.03.07 版本说明
商户可通过调用此接口，查询指定时间段的所有用户投诉信息，以分页输出查询结果。对于服务商、渠道商，可通过调用此接口，查询指定特约商户号下的投诉信息，若不指定，则查询的是名下所有特约商户投诉信息。
适用对象：直连商户
请求URL：https://api.mch.weixin.qq.com/v3/merchant-service/complaints-v2
请求方式：GET
path 指该参数为路径参数
query 指该参数为URL参数
body 指该参数需在请求JSON传参
| 参数名 | 变量 | 类型[长度限制] | 必填 | 描述 |
|---|---|---|---|---|
| 分页大小 | limit | int | 否 | query设置该次请求返回的最大投诉条数，范围【1,50】,商户自定义字段，不传默认为10。 注：如遇到提示“当前查询结果数据量过大”，是回包触发微信支付下行数据包大小限制，请缩小入参limit并重试。 示例值：5 |
| 分页开始位置 | offset | int | 否 | query该次请求的分页开始位置，从0开始计数，例如offset=10，表示从第11条记录开始返回，不传默认为0 。 示例值：10 |
| 开始日期 | begin_date | string[10, 10] | 是 | query投诉发生的开始日期，格式为yyyy-MM-DD。注意，查询日期跨度不超过30天，当前查询为实时查询 示例值：2019-01-01 |
| 结束日期 | end_date | string[10, 10] | 是 | query投诉发生的结束日期，格式为yyyy-MM-DD。注意，查询日期跨度不超过30天，当前查询为实时查询 示例值：2019-01-01 |
| 被诉商户号 | complainted_mchid | string[1, 64] | 否 | query投诉单对应的被诉商户号。 示例值：1900012181 |
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
| 参数名 | 变量 | 类型[长度限制] | 必填 | 描述 |
|---|---|---|---|---|
| + 用户投诉 详情 | data | array | 否 | 用户投诉信息详情投诉单相关信息 |
| 分页大小 | limit | int | 是 | 设置该次请求返回的最大投诉条数，范围[1,50] 示例值：5 |
| 分页开始位置 | offset | int | 是 | 该次请求的分页开始位置，从0开始计数，例如offset=10，表示从第11条记录开始返回。 示例值：10 |
| 投诉总条数 | total_count | int | 否 | 投诉总条数，当offset=0时返回 示例值：1000 |
{
"data": [
{
"additional_info": {
"share_power_info": {
"return_time": "2023-02-10T14:44:00+08:00"
},
"type": "SHARE_POWER_TYPE"
},
"complaint_id": "200201820200101080076610000",
"complaint_time": "2015-05-20T13:29:35.120+08:00",
"complaint_detail": "反馈一个重复扣费的问题",
"complaint_state": "PENDING",
"payer_phone": "Qe41VhP/sGdNeTHMQGlxCWiUyHu6XNO9GCYln2Luv4HhwJzZBfcL12sB+PgZcS5NhePBog30NgJ1xRaK+gbGDKwpg==",
"complaint_order_info":[
{
"transaction_id": "4200000404201909069117582536",
"out_trade_no": "20190906154617947762231",
"amount": 3
}
],
"service_order_info": [
{
"order_id": "15646546545165651651",
"out_order_no": "1234323JKHDFE1243252",
"state": "DOING"
}
],
"complaint_full_refunded": true,
"incoming_user_response": true,
"user_complaint_times": 1,
"complaint_media_list": [
{
"media_type": "USER_COMPLAINT_IMAGE",
"media_url": [
"https://api.mch.weixin.qq.com/v3/merchant-service/images/xxxxx"
]
}
],
"problem_description": "不满意商家服务",
"limit": 5,
"offset": 10,
"total_count": 1000
}
| 状态码 | 错误码 | 描述 | 解决方案 |
|---|---|---|---|
| 500 | SYSTEM_ERROR | 系统错误 | 5开头的状态码都为系统问题，请使用相同参数稍后重新调用 |
| 400 | PARAM_ERROR | 参数错误 | 请根据错误提示，传入正确参数 |
| 403 | NO_AUTH | 商户信息不合法 | 登录商户平台核对，传入正确信息 |
| 429 | FREQUENCY_LIMITED | 频率超限 | 请求量不要超过接口调用频率限制 |