# 获取投诉列表

接口应在服务器端调用，不可在前端（小程序、网页、APP等）直接调用，具体可参考接口调用指南。

接口英文名：get_complaint_list

本接口用于获取投诉列表

# 1. 调用方式

# HTTPS 调用

POST https://api.weixin.qq.com/xpay/get_complaint_list?access_token=ACCESS_TOKEN&pay_sig=PAY_SIG

# 云调用

本接口不支持云调用。

# 第三方调用

本接口支持第三方平台代商家调用。
该接口所属的权限集 id 为：157
服务商获得其中之一权限集授权后，可通过使用 authorizer_access_token 代商家进行调用，具体可查看第三方调用说明文档。

# 2. 请求参数

# 查询参数 `Query String Parameters`

参数名	类型	必填	示例	说明
access_token	string	是	ACCESS_TOKEN	接口调用凭证，可使用 access_token、authorizer_access_token
pay_sig	string	是	-	支付签名

# 请求体 `Request Payload`

参数名	类型	必填	说明
env	number	是	0-正式环境 1-沙箱环境（仅作为签名校验，查询的结果都是正式环境的）
begin_date	string	是	筛选开始时间，格式为yyyy-mm-dd,如"2023-01-01"
end_date	string	是	筛选结束时间，格式为yyyy-mm-dd,如"2023-01-01"
offset	number	是	筛选偏移，从0开始
limit	number	是	筛选最多返回条数

# 3. 返回参数

# 返回体 `Response Payload`

参数名	类型	说明
errcode	number	错误码
errmsg	string	错误信息
total	number	总条数
complaints	objarray	投诉列表

# Res.complaints(Array) `Object Payload`

投诉列表

参数名	类型	说明
complaint_id	string	投诉id
complaint_time	string	投诉时间格式为yyyy-mm-dd'T'HH:MM:ssXXX，其中XXX为时区偏移，例如：2023-11-28T11:11:49+08:00
complaint_detail	string	投诉内容
complaint_state	string	投诉状态 PENDING-待处理；PROCESSING-处理中；PROCESSED-已处理完成
payer_phone	string	投诉人联系方式
payer_openid	string	投诉人在商户AppID下的唯一标识
complaint_order_info	objarray	投诉单关联订单信息
complaint_full_refunded	boolean	投诉单下所有订单是否已全部全额退款
incoming_user_response	boolean	投诉单是否有待回复的用户留言
user_complaint_times	number	用户投诉次数。用户首次发起投诉记为1次，用户每有一次继续投诉就加1
complaint_media_list	objarray	用户上传的投诉相关资料，包括图片凭证等
problem_description	string	用户发起投诉前选择的faq标题
problem_type	string	问题类型为申请退款的单据是需要最高优先处理的单据。REFUND: 申请退款；SERVICE_NOT_WORK: 服务权益未生效；OTHERS: 其他类型
apply_refund_amount	number	当问题类型为申请退款时, 有值, (单位:分)
user_tag_list	array	用户标签列表，每一项内容为string。TRUSTED: 此类用户满足极速退款条件；HIGH_RISK: 高风险投诉，请按照运营要求优先妥善处理
service_order_info	objarray	投诉单关联服务单信息

# Res.complaints(Array).complaint_order_info`Object Payload`

投诉单关联订单信息

参数名	类型	说明
transaction_id	string	投诉单关联的微信支付交易单号
out_trade_no	string	渠道单号，query_order接口返回的channel_order_id
amount	number	订单金额，单位（分）
wxa_out_trade_no	string	商户单号，商家在拉起支付时传的单号
wx_order_id	string	小程序侧单号

# Res.complaints(Array).complaint_media_list`Object Payload`

用户上传的投诉相关资料，包括图片凭证等

参数名	类型	说明
media_type	string	媒体文件对应的业务类型，USER_COMPLAINT_IMAGE: 用户提交投诉时上传的图片凭证；OPERATION_IMAGE: 用户、商户、微信支付客服在协商解决投诉时，上传的图片凭证
media_url	array	每一项的内容为string，媒体文件请求url

# Res.complaints(Array).service_order_info`Object Payload`

投诉单关联服务单信息

参数名	类型	说明
order_id	string	微信支付服务订单号，每个微信支付服务订单号与商户号下对应的商户服务订单号一一对应
out_order_no	string	商户系统内部服务订单号（不是交易单号），与创建订单时一致
state	string	此处上传的是用户发起投诉时的服务单状态，不会实时更新。DOING: 服务订单进行中；REVOKED: 服务订单已取消；WAITPAY: 服务订单待支付；DONE: 服务订单已完成

# 4. 注意事项

使用用户态签名与支付签名

# 支付签名

签名参数为 pay_sig，加在 query 后面

例如接口地址是：https://api.weixin.qq.com/xpay/query_user_balance?access_token=xxxx

加上签名后则需要传 https://api.weixin.qq.com/xpay/query_user_balance?access_token=xxxx&pay_sig=xxx

# 5. 代码示例

本接口无代码示例

# 6. 错误码

以下是本接口的错误码列表，其他错误码可参考通用错误码；调用接口遇到报错，可使用官方提供的 API 诊断工具辅助定位和分析问题。

错误码	错误描述
-1	系统错误
268490001	openid错误
268490002	请求参数字段错误，具体看errmsg
268490003	签名错误
268490004	重复操作（赠送和代币支付和充值广告金相关接口会返回，表示之前的操作已经成功）
268490005	订单已经通过cancel_currency_pay接口退款，不支持再退款
268490006	代币的退款/支付操作金额不足
268490007	图片或文字存在敏感内容，禁止使用
268490008	代币未发布，不允许进行代币操作
268490009	用户session_key不存在或已过期，请重新登录
268490011	数据生成中，请稍后调用本接口获取
268490012	批量任务运行中，请等待完成后才能再次运行
268490013	禁止对核销状态的单进行退款
268490014	退款操作进行中，稍后可以使用相同参数重试
268490015	频率限制
268490016	退款的left_fee字段与实际不符，请通过query_order接口查询确认
268490018	广告金充值帐户行业 id 不匹配
268490019	广告金充值帐户 id已绑定其他 appid
268490020	广告金充值帐户主体名称错误
268490021	账户未完成进件
268490022	广告金充值账户无效
268490023	广告金余额不足
268490024	广告金充值金额必须大于 0

# 7. 适用范围

本接口暂未明确可调用账号类型，或在业务中根据调用传参自行确定是否可调用，请以实际调用情况为准。