查询投诉单详情

更新时间:2025.08.28

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

接口说明

支持商户:【普通商户】

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

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

     【备域名】https://api2.mch.weixin.qq.com 使用该域名将访问异地的接入点 ,指引点击查看

请求参数

Header  HTTP头参数

 Authorization  必填 string

请参考签名认证生成认证信息


 Accept  必填 string

请设置为application/json


path  路径参数

 complaint_id  必填   string(64)

【投诉单号】 投诉单对应的投诉单号

请求示例

curl
Java
Go

GET

1curl -X GET \
2  https://api.mch.weixin.qq.com/v3/merchant-service/complaints-v2/200201820200101080076610000 \
3  -H "Authorization: WECHATPAY2-SHA256-RSA2048 mchid=\"1900000001\",..." \
4  -H "Accept: application/json" 
5

应答参数

200 OK

 complaint_id  必填   string(64)

【投诉单号】 投诉单对应的投诉单号


 complaint_time  必填   string(32)

【投诉时间】 投诉时间


 complaint_detail  必填   string(300)

【投诉详情】 投诉的具体描述


 complaint_state  必填   string(30)

【投诉单状态】 标识当前投诉单所处的处理阶段,具体状态如下所示:
PENDING-待处理
PROCESSING-处理中
PROCESSED-已处理完成


 payer_phone  选填   string(512)

【投诉人联系方式】 投诉人联系方式。该字段已做加密处理,具体解密方法详见如何使用API证书解密敏感字段


 payer_openid  选填   string(128)

【投诉人OpenID】 投诉人在商户AppID下的唯一标识,支付分服务单类型无


 complaint_order_info  选填   array[object]

【投诉单关联订单信息】 投诉单关联订单信息

属性

 complaint_full_refunded  必填   boolean

【投诉单是否已全额退款】 投诉单下所有订单是否已全部全额退款


 incoming_user_response  必填   boolean

【是否有待回复的用户留言】 投诉单是否有待回复的用户留言


 user_complaint_times  必填   integer

【用户投诉次数】 用户投诉次数。用户首次发起投诉记为1次,用户每有一次继续投诉就加1


 complaint_media_list  选填   array[object]

【投诉资料列表】 用户上传的投诉相关资料,包括图片凭证等

属性

 problem_description  必填   string(256)

【问题描述】 用户发起投诉前选择的faq标题(2021年7月15日之后的投诉单均包含此信息)


 problem_type  选填   string

【问题类型】 问题类型为申请退款的单据是需要最高优先处理的单据

可选取值

  • REFUND:  申请退款

  • SERVICE_NOT_WORK:  服务权益未生效

  • OTHERS:  其他类型


 apply_refund_amount  选填   integer

【申请退款金额】 仅当问题类型为申请退款时, 有值, (单位:分)


 user_tag_list  选填   array[string]

【用户标签列表】 用户标签列表

可选取值

  • TRUSTED:  此类用户满足极速退款条件

  • HIGH_RISK:  高风险投诉,请按照运营要求优先妥善处理


 service_order_info  选填   array[object]

【投诉单关联服务单信息】 

属性

 additional_info  选填   object

【补充信息】 用在特定行业或场景下返回的补充信息

属性

 in_platform_service  选填   boolean

【是否在平台协助中】 标识当前投诉单是否正处在平台协助流程中。注:在协助期间由微信支付客服为用户服务,期间商户向用户发送的留言用户不可见


 need_immediate_service  选填   boolean

【是否需即时服务用户】 因用户诉求紧急度、用户界面差异等因素,部分投诉单建议商户更即时地响应用户诉求。如此处标识为“是”,建议商户提升服务时效,给用户带来更好的体验

应答示例

200 OK

1{
2  "complaint_id" : "200201820200101080076610000",
3  "complaint_time" : "2015-05-20T13:29:35.120+08:00",
4  "complaint_detail" : "反馈一个重复扣费的问题",
5  "complaint_state" : "PENDING",
6  "payer_phone" : "18500000000",
7  "payer_openid" : "oUpF8uMuAJO_M2pxb1Q9zNjWeS6o",
8  "complaint_order_info" : [
9    {
10      "transaction_id" : "4200000404201909069117582536",
11      "out_trade_no" : "20190906154617947762231",
12      "amount" : 3
13    }
14  ],
15  "complaint_full_refunded" : true,
16  "incoming_user_response" : true,
17  "user_complaint_times" : 1,
18  "complaint_media_list" : [
19    {
20      "media_type" : "USER_COMPLAINT_IMAGE",
21      "media_url" : [
22        "https://api.mch.weixin.qq.com/v3/merchant-service/images/xxxxx"
23      ]
24    }
25  ],
26  "problem_description" : "不满意商家服务",
27  "problem_type" : "REFUND",
28  "apply_refund_amount" : 10,
29  "user_tag_list" : [
30    "TRUSTED"
31  ],
32  "service_order_info" : [
33    {
34      "order_id" : "15646546545165651651",
35      "out_order_no" : "1234323JKHDFE1243252",
36      "state" : "DOING"
37    }
38  ],
39  "additional_info" : {
40    "type" : "SHARE_POWER_TYPE",
41    "share_power_info" : {
42      "return_time" : "2015-05-20T13:29:35+08:00",
43      "return_address_info" : {
44        "return_address" : "广东省深圳市南山区海天二路南山区后海腾讯滨海大厦(海天二路西)",
45        "longitude" : "113.93535488533665",
46        "latitude" : "22.52305518747831"
47      },
48      "is_returned_to_same_machine" : false
49    }
50  },
51  "in_platform_service" : true,
52  "need_immediate_service" : true
53}
54

 

错误码

公共错误码

状态码

错误码

描述

解决方案

400

PARAM_ERROR

参数错误

请根据错误提示正确传入参数

400

INVALID_REQUEST

HTTP 请求不符合微信支付 APIv3 接口规则

请参阅 接口规则

401

SIGN_ERROR

验证不通过

请参阅 签名常见问题

500

SYSTEM_ERROR

系统异常,请稍后重试

请稍后重试

 

 

更多技术问题
技术咨询
反馈
咨询
目录
置顶