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

接口说明

支持商户：

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

请求方式：

【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)
【投诉单号】 投诉单对应的投诉单号

请求示例

GET

应答参数

200OK
complaint_id 必填 string(64)
【投诉单号】 投诉单对应的投诉单号
complaint_time 必填 string(32)
【投诉时间】 投诉时间
complaint_detail 必填 string(300)
【投诉详情】 投诉的具体描述
complaint_state 必填 string(30)
【投诉单状态】 标识当前投诉单所处的处理阶段，具体状态如下所示：
PENDING-待处理
PROCESSING-处理中
PROCESSED-已处理完成
complainted_mchid 必填 string(64)
【被诉商户号】 当服务商或渠道商查询时返回，具体的子商户标识。
payer_phone 选填 string(512)
【投诉人联系方式】 投诉人联系方式。该字段已做加密处理，具体解密方法详见敏感信息加密说明。
payer_openid 选填 string(128)
【投诉人OpenID】 投诉人在商户AppID下的唯一标识，支付分服务单类型无
complaint_order_info 选填 array[ComplaintOrderInfo]
【投诉单关联订单信息】 投诉单关联订单信息
• 属性
complaint_full_refunded 必填 boolean
【投诉单是否已全额退款】 投诉单下所有订单是否已全部全额退款
incoming_user_response 必填 boolean
【是否有待回复的用户留言】 投诉单是否有待回复的用户留言
user_complaint_times 必填 integer
【用户投诉次数】 用户投诉次数。用户首次发起投诉记为1次，用户每有一次继续投诉就加1
complaint_media_list 选填 array[ComplaintMedia]
【投诉资料列表】 用户上传的投诉相关资料，包括图片凭证等
• 属性
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[ServiceOrderInfo]
【投诉单关联服务单信息】
• 属性
additional_info 选填 AdditionalInfo
【补充信息】 用在特定行业或场景下返回的补充信息
• 属性

应答示例

200 OK

错误码

公共错误码

状态码	错误码	描述	解决方案
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开头的状态码都为系统问题，请使用相同参数稍后重新调用