---
url: "https://pay.weixin.qq.com/doc/v3/partner/4012691648.md"
title: "查询投诉单详情"
doc_id: 4012691648
---

>更新时间：2025.08.28

商户可通过调用此接口，查询指定投诉单的用户投诉详情，包含投诉关联订单信息、支付分服务单信息、投诉的问题类型、问题描述、投诉人联系方式等信息，方便商户处理投诉。




## 接口说明

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

请求方式：【GET】 `/v3/merchant-service/complaints-v2/{complaint_id}`

请求域名：【主域名】https://api.mch.weixin.qq.com 使用该域名将访问就近的接入点

　　　　　【备域名】https://api2.mch.weixin.qq.com 使用该域名将访问异地的接入点，指引[点击查看](https://pay.weixin.qq.com/doc/v3/merchant/4012075113.md)

## 请求参数

### Header 参数
| 参数名 | 类型 | 必填 | 描述 |
| --- |  --- | --- | --- |
| Authorization | string | true | 请参考 [签名认证](https://pay.weixin.qq.com/doc/v3/merchant/4012365342.md#%E8%AF%B7%E6%B1%82%E6%8E%A5%E5%8F%A3%E5%90%8E%E7%AB%AF%E7%AD%BE%E5%90%8D) 生成认证信息 |
| Accept | string | true | 请设置为 `application/json` |
### Path 参数
| 参数名 | 类型 | 必填 | 描述 |
| --- |  --- | --- | --- |
| complaint_id | string(64) | true | 【投诉单号】 投诉单对应的投诉单号 |
## 应答参数

200 OK

| 参数名 | 类型 | 必填 | 描述 |
| --- |  --- | --- | --- |
| complaint_id | string(64) | true | 【投诉单号】 投诉单对应的投诉单号 |
| complaint_time | string(32) | true | 【投诉时间】 投诉时间 |
| complaint_detail | string(300) | true | 【投诉详情】 投诉的具体描述 |
| complaint_state | string(30) | true | 【投诉单状态】 标识当前投诉单所处的处理阶段，具体状态如下所示：<br>PENDING-待处理<br>PROCESSING-处理中<br>PROCESSED-已处理完成 |
| complainted_mchid | string(64) | true | 【被诉商户号】 当服务商或渠道商查询时返回，具体的子商户标识。 |
| payer_phone | string(512) | false | 【投诉人联系方式】 投诉人联系方式。该字段已做加密处理，具体解密方法详见 [如何使用API证书解密敏感字段](https://pay.weixin.qq.com/doc/v3/partner/4013059060.md) |
| payer_openid | string(128) | false | 【投诉人OpenID】 投诉人在商户AppID下的唯一标识，支付分服务单类型无 |
| complaint_order_info | array[object] | false | 【投诉单关联订单信息】 投诉单关联订单信息 |
| complaint_order_info.transaction_id | string(64) | true | 【微信订单号】 投诉单关联的微信订单号 |
| complaint_order_info.out_trade_no | string(64) | true | 【商户订单号】 投诉单关联的商户订单号 |
| complaint_order_info.amount | integer | true | 【订单金额】 订单金额，单位（分） |
| complaint_full_refunded | boolean | true | 【投诉单是否已全额退款】 投诉单下所有订单是否已全部全额退款 |
| incoming_user_response | boolean | true | 【是否有待回复的用户留言】 投诉单是否有待回复的用户留言 |
| user_complaint_times | integer | true | 【用户投诉次数】 用户投诉次数。用户首次发起投诉记为1次，用户每有一次继续投诉就加1 |
| complaint_media_list | array[object] | false | 【投诉资料列表】 用户上传的投诉相关资料，包括图片凭证等 |
| complaint_media_list.media_type | string | true | 【媒体文件业务类型】 媒体文件对应的业务类型<br>可选取值<br><ul><li>`USER_COMPLAINT_IMAGE`:  用户提交投诉时上传的图片凭证</li><li>`OPERATION_IMAGE`:  用户、商户、微信支付客服在协商解决投诉时，上传的图片凭证</li></ul> |
| complaint_media_list.media_url | array[string(512)] | true | 【媒体文件请求url】 微信返回的媒体文件请求url，详细调用请参考： [图片请求接口](https://pay.weixin.qq.com/doc/v3/partner/4012467223.md)<br>示例 " [https://api.mch.weixin.qq.com/v3/merchant-service/images/xxxxx"](https://api.mch.weixin.qq.com/v3/merchant-service/images/xxxxx%22) 中 "xxxxx" 代表媒体文件标识 ID(meida\_id) |
| problem_description | string(256) | true | 【问题描述】 用户发起投诉前选择的faq标题（2021年7月15日之后的投诉单均包含此信息） |
| problem_type | string | false | 【问题类型】 问题类型为申请退款的单据是需要最高优先处理的单据<br>可选取值<br><ul><li>`REFUND`:  申请退款</li><li>`SERVICE_NOT_WORK`:  服务权益未生效</li><li>`OTHERS`:  其他类型</li></ul> |
| apply_refund_amount | integer | false | 【申请退款金额】 仅当问题类型为申请退款时, 有值, (单位:分) |
| user_tag_list | array[string] | false | 【用户标签列表】 用户标签列表<br>可选取值<br><ul><li>`TRUSTED`:  此类用户满足极速退款条件</li><li>`HIGH_RISK`:  高风险投诉，请按照运营要求优先妥善处理</li></ul> |
| service_order_info | array[object] | false | 【投诉单关联服务单信息】 |
| service_order_info.order_id | string(128) | false | 【微信支付服务订单号】 微信支付服务订单号，每个微信支付服务订单号与商户号下对应的商户服务订单号一一对应 |
| service_order_info.out_order_no | string(128) | false | 【商户服务订单号】 商户系统内部服务订单号（不是交易单号），与创建订单时一致 |
| service_order_info.state | string | false | 【支付分服务单状态】 此处上传的是用户发起投诉时的服务单状态，不会实时更新<br>可选取值<br><ul><li>`DOING`:  服务订单进行中</li><li>`REVOKED`:  服务订单已取消</li><li>`WAITPAY`:  服务订单待支付</li><li>`DONE`:  服务订单已完成</li></ul> |
| additional_info | object | false | 【补充信息】 用在特定行业或场景下返回的补充信息 |
| additional_info.type | string | false | 【补充信息类型】 补充信息类型<br>可选取值<br><ul><li>`SHARE_POWER_TYPE`:  充电宝投诉相关行业</li></ul> |
| additional_info.share_power_info | object | false | 【充电宝投诉相关信息】 当type为充电宝投诉相关时有值 |
| additional_info.share_power_info.return_time | string | false | 【归还时间】 遵循rfc3339标准格式，格式为yyyy-MM-DDTHH:mm:ss+TIMEZONE，yyyy-MM-DD表示年月日，T出现在字符串中，表示time元素的开头，HH:mm:ss表示时分秒，TIMEZONE表示时区（+08:00表示东八区时间，领先UTC 8小时，即北京时间）。例如：2015-05-20T13:29:35+08:00表示，北京时间2015年5月20日 13点29分35秒。 |
| additional_info.share_power_info.return_address_info | object | false | 【归还地点信息】 归还地点信息，选填 |
| additional_info.share_power_info.return_address_info.return_address | string(256) | false | 【归还地点】 归还地点 |
| additional_info.share_power_info.return_address_info.longitude | string(32) | false | 【归还地点经度】 经度，字符串，范围为-180~180，负数表示西经。使用GCJ-02坐标系 |
| additional_info.share_power_info.return_address_info.latitude | string(32) | false | 【归还地点纬度】 纬度，字符串，范围为-90~90，负数表示南纬。使用GCJ-02坐标系 |
| additional_info.share_power_info.is_returned_to_same_machine | boolean | false | 【是否归还同一柜机】 用户声明是否将充电宝归还至与借取时同一柜机 |
| in_platform_service | boolean | false | 【是否在平台协助中】 标识当前投诉单是否正处在平台协助流程中。注：在协助期间由微信支付客服为用户服务，期间商户向用户发送的留言用户不可见 |
| need_immediate_service | boolean | false | 【是否需即时服务用户】 因用户诉求紧急度、用户界面差异等因素，部分投诉单建议商户更即时地响应用户诉求。如此处标识为“是”，建议商户提升服务时效，给用户带来更好的体验 |
| is_agent_mode | boolean | false | 【是否是智能体投诉】 对接商家智能体的商户，用户针对某笔订单下的智能服务质量产生投诉，商户需要结合投诉内容，在智能体服务内更加及时、妥善地服务用户 |
## 错误码

以下是本接口返回的错误码列表。详细错误码规则，请参考[微信支付接口规则-错误码和错误提示](https://pay.weixin.qq.com/doc/v3/partner/4012081726.md#%E9%94%99%E8%AF%AF%E7%A0%81%E5%92%8C%E9%94%99%E8%AF%AF%E6%8F%90%E7%A4%BA)

| 状态码 | 错误码 | 描述 | 解决方案 |
| --- | --- | --- | --- |
| 400 | PARAM\_ERROR | 参数错误 | 请根据错误提示正确传入参数 |
| 400 | INVALID\_REQUEST | HTTP 请求不符合微信支付 APIv3 接口规则 | 请参阅 [接口规则](https://pay.weixin.qq.com/doc/v3/merchant/4012081709.md) |
| 401 | SIGN\_ERROR | 验证不通过 | 请参阅 [签名常见问题](https://pay.weixin.qq.com/doc/v3/merchant/4012072670.md) |
| 500 | SYSTEM\_ERROR | 系统异常，请稍后重试 | 请稍后重试 |

请求示例

- [curl 示例](https://pay.weixin.qq.com/doc/v3/partner/4012691648-curl.md)
- [Java 示例](https://pay.weixin.qq.com/doc/v3/partner/4012691648-java.md)
- [Go 示例](https://pay.weixin.qq.com/doc/v3/partner/4012691648-go.md)


应答示例

> 200 OK

```
{
  "complaint_id" : "200201820200101080076610000",
  "complaint_time" : "2015-05-20T13:29:35.120+08:00",
  "complaint_detail" : "反馈一个重复扣费的问题",
  "complaint_state" : "PENDING",
  "complainted_mchid" : "1900012181",
  "payer_phone" : "18500000000",
  "payer_openid" : "oUpF8uMuAJO_M2pxb1Q9zNjWeS6o",
  "complaint_order_info" : [
    {
      "transaction_id" : "4200000404201909069117582536",
      "out_trade_no" : "20190906154617947762231",
      "amount" : 3
    }
  ],
  "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" : "不满意商家服务",
  "problem_type" : "REFUND",
  "apply_refund_amount" : 10,
  "user_tag_list" : [
    "TRUSTED"
  ],
  "service_order_info" : [
    {
      "order_id" : "15646546545165651651",
      "out_order_no" : "1234323JKHDFE1243252",
      "state" : "DOING"
    }
  ],
  "additional_info" : {
    "type" : "SHARE_POWER_TYPE",
    "share_power_info" : {
      "return_time" : "2015-05-20T13:29:35+08:00",
      "return_address_info" : {
        "return_address" : "广东省深圳市南山区海天二路南山区后海腾讯滨海大厦(海天二路西)",
        "longitude" : "113.93535488533665",
        "latitude" : "22.52305518747831"
      },
      "is_returned_to_same_machine" : false
    }
  },
  "in_platform_service" : true,
  "need_immediate_service" : true,
  "is_agent_mode" : true
}

```
