查询投诉详情API

最新更新时间:2020.11.27 版本说明


商户可通过调用此接口,查询指定投诉的用户投诉详情,包含投诉内容、投诉订单、投诉人联系方式等信息,方便商户获取投诉详情处理投诉。

接口说明

适用对象:直连商户 服务商 渠道商

请求URL:https://api.mch.weixin.qq.com/v3/merchant-service/complaints/{transaction_id}

请求方式:get

接口规则:https://pay.weixin.qq.com/wiki/doc/apiv3/wechatpay/wechatpay-1.shtml


path 指该参数为路径参数

query 指该参数为URL参数

body 指该参数需在请求JSON传参


请求参数

参数名 变量 类型[长度限制] 必填 描述
微信支付订单号transaction_idstring[1, 64]path投诉单对应的微信订单号
示例值:4200000404201909069117582536

请求示例


https://api.mch.weixin.qq.com/v3/merchant-service/complaints/4200000404201909069117582536

{
JAVA示例代码
}

返回参数

参数名 变量 类型[长度限制] 必填 描述
商户订单号out_trade_nostring[1, 64]投诉对应的商户订单号
示例值:20190906154617947762231
投诉时间complaint_timestring[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
投诉金额amountint投诉金额,单位(分)
示例值:3
投诉人联系方式payer_phonestring[1, 256]投诉人联系方式,用户投诉时填写了手机号则返回,未填写则不返回。该字段已做加密处理,具体解密方法详见《敏感信息加密说明》
示例值:Qe41VhP/sGdNeTHMQGlxCWiUyHu6XNO9GCYln2Luv4HhwJzZBfcL12sB+PgZcS5NhePBog30NgJ1xRaK+gbGDKwpg==
投诉描述complaint_detailstring[1, 300] 投诉具体描述。
示例值:反馈一个重复扣费的问题
投诉单状态complaint_statestring[1, 30]

投诉状态(已废弃)。用于标识当前投诉单的状态,针对投诉单本身。既包括用户投诉、撤诉,也包括商户未能及时解决投诉带来的资金相关的投诉状态。
注意:投诉状态正在逐渐废弃,后续将使用投诉单处理进展状态,建议还在使用投诉状态的商户切换到投诉单处理进展状态上来。

枚举值:
PAYER_COMPLAINTED:用户已投诉
FROZENED:交易已冻结
FROZEN_FINISHED:冻结已结束
PAYER_CANCELED:用户已撤诉
MERCHANT_REFUNDED:商户已退款
SYSTEM_REFUNDED:系统(微信支付)已退款
MANUAL_UNFROZEN:人工(微信支付运营人员)手动解冻
示例值:PAYER_COMPLAINTED

微信支付订单号transaction_idstring[1, 64]投诉对应的微信订单号
示例值:4200000404201909069117582536
冻结结束时间frozen_end_timestring[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_mchidstring[1, 64] 当服务商或渠道商查询时返回,返回具体被投诉子商户的商户号。
示例值:1900012181
投诉单处理进展状态complaint_handle_statestring[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"
}
                    

http://2323weixin.qq.com
                    

错误码公共错误码

状态码 错误码 描述 解决方案
500 SYSTEM_ERROR 系统错误 5开头的状态码都为系统问题,请使用相同参数稍后重新调用
400 PARAM_ERROR 参数错误 根据错误提示,传入正确参数
400 INVALID_REQUEST 请求参数符合参数格式,但不符合业务规则项 请确认参数符合业务要求,稍后重新调用
401 SIGN_ERROR 签名验证失败 请检查签名参数和方法是否都符合签名算法要求
403 NO_AUTH 商户暂无权限使用此功能 请开通商户号权限。请联系产品或商务申请
429 FREQUENCY_LIMITED 频率超限 请求量不要超过接口调用频率限制


版本说明

关闭
V1.0
2020年11月27
查询投诉信息接口上线

技术咨询

文档反馈