查询投诉单详情

更新时间：2024.12.26

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

# 接口说明

支持商户：

【普通商户】

请求方式：

【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)

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

请求示例

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"

# 应答参数

200OK

complaint_id 必填 string(64)

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

complaint_time 必填 string(32)

【投诉时间】 投诉时间

complaint_detail 必填 string(300)

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

complaint_state 必填 string(30)

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

payer_phone 选填 string(512)

【投诉人联系方式】 投诉人联系方式。该字段已做加密处理，具体解密方法详见敏感信息加密说明。

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

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

应答示例

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}

# 错误码

# 公共错误码

状态码	错误码	描述	解决方案
400	PARAM_ERROR	参数错误	请根据错误提示正确传入参数
400	INVALID_REQUEST	HTTP 请求不符合微信支付 APIv3 接口规则	请参阅接口规则
401	SIGN_ERROR	验证不通过	请参阅签名常见问题
500	SYSTEM_ERROR	系统异常，请稍后重试	请稍后重试

# 业务错误码

状态码	错误码	描述	解决方案
400	INVALID_REQUEST	请求参数符合参数格式，但不符合业务规则项	请确认参数符合业务要求，稍后重新调用
403	NO_AUTH	无权限	请开通商户号权限，并确认参数符合规范
429	FREQUENCY_LIMITED	频率超限	请求量不要超过接口调用频率限制
500	SYSTEM_ERROR	系统错误	5开头的状态码都为系统问题，请使用相同参数稍后重新调用

文档是否有帮助

服务商文档

消费者投诉2.0参考文档

更多支持

开发者社区微信开放平台微信公众平台腾讯客服

查询投诉单详情

# 接口说明

# 请求参数

# 应答参数

# 错误码

# 公共错误码

# 业务错误码

关于我们

服务支持

友情链接

客服帮助