最新更新时间：2023.03.07 版本说明
商户可通过调用此接口，查询指定投诉单的用户投诉详情，包含投诉关联订单信息/支付分服务单信息、投诉的问题类型、问题描述、投诉人联系方式等信息，方便商户处理投诉。
适用对象：直连商户
请求URL：https://api.mch.weixin.qq.com/v3/merchant-service/complaints-v2/{complaint_id}
请求方式：GET
path 指该参数为路径参数
query 指该参数为URL参数
body 指该参数需在请求JSON传参
| 参数名 | 变量 | 类型[长度限制] | 必填 | 描述 |
|---|---|---|---|---|
| 投诉单号 | complaint_id | string[1,64] | 是 | path投诉单对应的投诉单号 示例值：200201820200101080076610000 |
https://api.mch.weixin.qq.com/v3/merchant-service/complaints-v2/200201820200101080076610000
| 参数名 | 变量 | 类型[长度限制] | 必填 | 描述 |
|---|---|---|---|---|
| 投诉单号 | complaint_id | string[1, 64] | 是 | 投诉单对应的投诉单号 示例值：200201820200101080076610000 |
| 投诉时间 | complaint_time | string[1, 32] | 是 | 投诉时间，遵循rfc3339标准格式，格式为yyyy-MM-DDTHH:mm:ss.sss+TIMEZONE，yyyy-MM-DD表示年月日，T出现在字符串中，表示time元素的开头，HH:mm:ss.sss表示时分秒毫秒，TIMEZONE表示时区（+08:00表示东八区时间，领先UTC 8小时，即北京时间）。例如：2015-05-20T13:29:35.120+08:00表示北京时间2015年05月20日13点29分35秒 示例值：2015-05-20T13:29:35.120+08:00 |
| 投诉详情 | complaint_detail | string[1, 300] | 是 | 投诉的具体描述 示例值：反馈一个重复扣费的问题 |
| 被诉商户号 | complainted_mchid | string[1, 64] | 否 | 投诉单对应的被诉商户号。 示例值：1900012181 |
| 投诉单状态 | complaint_state | string[1, 30] | 是 | 标识当前投诉单所处的处理阶段，具体状态如下所示： PENDING：待处理 PROCESSING：处理中 PROCESSED：已处理完成 示例值：PENDING |
| 投诉人联系方式 | payer_phone | string[1, 256] | 否 | 投诉人联系方式。该字段已做加密处理，具体解密方法详见敏感信息加密说明。 示例值：sGdNeTHMQGlxCWiUyHu6XNO9GCYln2Luv4HhwJzZBfcL12sB |
| 投诉人openid | payer_openid | string[1, 128] | 是 | 投诉人在商户appid下的唯一标识 示例值：oUpF8uMuAJO_M2pxb1Q9zNjWeS6o |
| +投诉资料列表 | complaint_media_list | array | 是 | 用户上传的投诉相关资料，包括图片凭证等 |
| +投诉单关联订单信息 | complaint_order_info | array | 是 | 投诉单关联订单信息 注：投诉单和订单目前是一对一关系，array是预留未来一对多的扩展 |
| +投诉单关联服务单信息 | service_order_info | array | 否 | 投诉单关联服务单信息, 支付分服务单投诉时可能存在 |
| 投诉单是否已全额退款 | complaint_full_refunded | boolean | 是 | 投诉单下所有订单是否已全部全额退款 示例值：true |
| 是否有待回复的用户留言 | incoming_user_response | boolean | 是 | 投诉单是否有待回复的用户留言 示例值：true |
| 问题描述 | problem_description | string[1, 256] | 是 | 用户发起投诉前选择的faq标题（2021年7月15日之后的投诉单均包含此信息） 示例值：不满意商家服务 |
| 用户投诉次数 | user_complaint_times | int | 是 | 用户投诉次数。用户首次发起投诉记为1次，用户每有一次继续投诉就加1 示例值：1 |
| 问题类型 | problem_type | string | 否 | 问题类型为申请退款的单据是需要最高优先处理的单据 REFUND：申请退款 SERVICE_NOT_WORK：服务权益未生效 OTHERS：其他类型 示例值：REFUND |
| 申请退款金额 | apply_refund_amount | int | 否 | 仅当问题类型为申请退款时, 有值, (单位:分) 示例值：10 |
| 用户标签列表 | user_tag_list | array | 否 | 用户标签列表 TRUSTED：可信，此类用户满足极速退款条件 OTHERS：其它，此类用户不满足极速退款条件 示例值：[TRUSTED] |
| + 补充信息 | additional_info | object | 否 | 用在特定行业或场景下返回的补充信息 |
{
"complaint_id": "200201820200101080076610000",
"complaint_time": "2015-05-20T13:29:35.120+08:00",
"complaint_detail": "反馈一个重复扣费的问题",
"complainted_mchid": 1900012181,
"complaint_state": "PENDING",
"payer_phone": "sGdNeTHMQGlxCWiUyHu6XNO9GCYln2Luv4HhwJzZBfcL12sB",
"payer_openid": "oUpF8uMuAJO_M2pxb1Q9zNjWeS6o",
"complaint_media_list": [{
"media_type": "USER_COMPLAINT_IMAGE",
"media_url": [
"https://api.mch.weixin.qq.com/v3/merchant-service/images/xxxxx"
]
}],
"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,
"problem_description": "不满意商家服务",
"user_complaint_times": 1,
"additional_info": {
"share_power_info": {
"return_time": "2023-02-10T14:44:00+08:00"
},
"type": "SHARE_POWER_TYPE"
}
}
| 状态码 | 错误码 | 描述 | 解决方案 |
|---|---|---|---|
| 500 | SYSTEM_ERROR | 系统错误 | 5开头的状态码都为系统问题，请使用相同参数稍后重新调用 |
| 400 | PARAM_ERROR | 参数错误 | 请根据错误提示，传入正确参数 |
| 400 | INVALID_REQUEST | 请求参数符合参数格式，但不符合业务规则项 | 请确认参数符合业务要求，稍后重新调用 |
| 401 | SIGN_ERROR | 签名验证失败 | 请检查签名参数和方法是否都符合签名算法要求 |
| 403 | NO_AUTH | 无权限 | 请开通商户号权限，并确认参数符合规范 |
| 429 | FREQUENCY_LIMITED | 频率超限 | 请求量不要超过接口调用频率限制 |