最新更新时间：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/{transaction_id}
请求方式：GET
path 指该参数为路径参数
query 指该参数为URL参数
body 指该参数需在请求JSON传参
| 参数名 | 变量 | 类型[长度限制] | 必填 | 描述 |
|---|---|---|---|---|
| 微信支付订单号 | transaction_id | string[1, 64] | 是 | path投诉单对应的微信订单号 示例值：4200000404201909069117582536 |
https://api.mch.weixin.qq.com/v3/merchant-service/complaints/4200000404201909069117582536
| 参数名 | 变量 | 类型[长度限制] | 必填 | 描述 |
|---|---|---|---|---|
| 商户订单号 | out_trade_no | string[1, 64] | 是 | 投诉对应的商户订单号 示例值：20190906154617947762231 |
| 投诉时间 | 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 |
| 投诉金额 | amount | int | 是 | 投诉金额，单位（分） 示例值：3 |
| 投诉人联系方式 | payer_phone | string[1, 256] | 否 | 投诉人联系方式，用户投诉时填写了手机号则返回，未填写则不返回。该字段已做加密处理，具体解密方法详见《敏感信息加密说明》。 示例值：Qe41VhP/sGdNeTHMQGlxCWiUyHu6XNO9GCYln2Luv4HhwJzZBfcL12sB+PgZcS5NhePBog30NgJ1xRaK+gbGDKwpg== |
| 投诉描述 | complaint_detail | string[1, 300] | 是 | 投诉具体描述。 示例值：反馈一个重复扣费的问题 |
| 投诉单状态 | complaint_state | string[1, 30] | 否 | 投诉状态(已废弃)。用于标识当前投诉单的状态，针对投诉单本身。既包括用户投诉、撤诉，也包括商户未能及时解决投诉带来的资金相关的投诉状态。 枚举值： |
| 微信支付订单号 | transaction_id | string[1, 64] | 是 | 投诉对应的微信订单号 示例值：4200000404201909069117582536 |
| 冻结结束时间 | frozen_end_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 |
| 特约商户号 | sub_mchid | string[1, 64] | 否 | 当服务商或渠道商查询时返回，返回具体被投诉子商户的商户号。 示例值：1900012181 |
| 投诉单处理进展状态 | complaint_handle_state | string[1, 64] | 是 | 投诉单处理进展状态，标识当前投诉单所处的处理阶段，描述用户与商户的沟通反馈进度，将逐步取代投诉状态。 具体状态如下所示： WAIT_MERCHANT_RESPONSE：待商户处理 MERCHANT_RESPONSED：商户已反馈 USER_CONFIRMED：用户已确认 TIME_OUT_CLOSED：投诉超时关闭 MERCHANT_FULL_REFUNDED：商户全额退款 PAYER_CANCELED：用户已撤诉 示例值：WAIT_MERCHANT_RESPONSE |
{
"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"
}
| 状态码 | 错误码 | 描述 | 解决方案 |
|---|---|---|---|
| 500 | SYSTEM_ERROR | 系统错误 | 5开头的状态码都为系统问题，请使用相同参数稍后重新调用 |
| 400 | PARAM_ERROR | 参数错误 | 根据错误提示，传入正确参数 |
| 400 | INVALID_REQUEST | 请求参数符合参数格式，但不符合业务规则项 | 请确认参数符合业务要求，稍后重新调用 |
| 401 | SIGN_ERROR | 签名验证失败 | 请检查签名参数和方法是否都符合签名算法要求 |
| 403 | NO_AUTH | 商户暂无权限使用此功能 | 请开通商户号权限。请联系产品或商务申请 |
| 429 | FREQUENCY_LIMITED | 频率超限 | 请求量不要超过接口调用频率限制 |