接口说明
| 接口名称 | complaint_query_list |
|---|---|
| 是否幂等 | 否 |
| 接口模式 | 直连 |
| 异步通知 | 否 |
应用场景
商户可通过调用此接口，查询指定时间段的所有用户投诉信息，以分页输出查询结果。
接口参数
- 请求
| 字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
|---|---|---|---|---|---|
| 代理商商户号 | agentMerId | 否 | S(16) | 100000 | 宝付支付分配的商户号 |
| 代理商终端号 | agentTerId | 否 | S(16) | 100000 | 宝付支付分配的终端号 |
| 交易商户号 | merId | 是 | S(16) | 宝付支付分配的商户号 | |
| 交易终端号 | terId | 是 | S(16) | 宝付支付分配的终端号 | |
| 分页大小 | limit | 是 | S(32) | 10 | 设置该次请求返回的最大投诉条数，范围【1,50】,商户自定义字段，不传默认为10。 |
| 分页开始位置 | offset | 是 | I | 10 | 该次请求的分页开始位置，从0开始计数，例如offset=10，表示从第11条记录开始返回，不传默认为0。 |
| 开始日期 | beginDate | 是 | S(10) | 2021-12-01 | 投诉发生的开始日期，格式为yyyy-MM-dd HH:mm:ss。注意，查询日期跨度不超过30天。 示例值：2021-12-01 00:00:00 |
| 结束日期 | endDate | 是 | S(10) | 2021-12-01 | 投诉发生的结束日期，格式为yyyy-MM-dd HH:mm:ss。注意，查询日期跨度不超过30天。 示例值：2021-12-01 23:59:59 |
| 被诉商户号 | complaintedMchid | 否 | S(32) | 9639639639 | 投诉单对应的被诉商户号 |
- 返回
| 字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
|---|---|---|---|---|---|
| 代理商商户号 | agentMerId | 否 | S(16) | 100000 | 宝付支付分配的商户号 |
| 代理商终端号 | agentTerId | 否 | S(16) | 100000 | 宝付支付分配的终端号 |
| 商户号 | merId | 是 | S(16) | 宝付支付分配的商户号 | |
| 终端号 | terId | 是 | S(16) | 宝付支付分配的终端号 | |
| 用户投诉信息详情 | complaintQueryDetailList | 是 | C | 用户投诉信息详情列表JSON数组 | |
| -投诉单号 | complaintId | 是 | S(32) | 200201820200101080076610000 | 投诉单号 |
| -投诉时间 | complaintTime | 是 | S(32) | 2015-05-20 13:29:35 | 投诉时间：格式YYYY-MM-DD HH:mm:ss |
| -投诉详情 | complaintDetail | 是 | S(32) | 反馈一个重复扣费的问题 | 投诉的具体描述 |
| -投诉单状态 | complaintState | 是 | S(32) | PENDING | 标识当前投诉单所处的处理阶段，具体状态如下所示： PENDING：待处理 PROCESSING：处理中 PROCESSED：已处理完成 PENDING：待处理 PROCESSING：处理中 PROCESSED：已处理完成 |
| -被诉商户号 | complaintedMchid | 是 | S(32) | 384886001 | 被投诉的商户号 |
| -投诉人联系方式 | payerPhone | 是 | S(256) | 69C342BC09E27CB451EDD4CBBCCE5D26 | 投诉人联系方式。该字段已做加密处理（3DES加密） |
| -投诉资料列表 | complaintMediaList | 是 | S(32) | [{“mediaType”: “USER_COMPLAINT_IMAGE”,”mediaUrl”:[“https://api.mch.weixin.qq.com/v3/merchant-service/images/xxxxx"] | 投诉资料列表JSON数组 |
| —媒体文件业务类型 | mediaType | 是 | S(32) | USER_COMPLAINT_IMAGE | 媒体文件对应的业务类型 |
| —媒体文件请求url | mediaUrl | 是 | C | [“https://api.mch.weixin.qq.com/v3/merchant-service/images/xxxxx"] | 微信返回的媒体文件请求url |
| -投诉单关联订单信息 | complaintOrderInfoList | 是 | C | [{“transactionId”: “4200000404201909069117582536”, “outTradeNo”: “20190906154617947762231”,”amount”: 3 }, {“transactionId”: “4200000404201909069117582836”, “outTradeNo”: “20190906154617947762291”,”amount”: 4 }] | 投诉单关联订单信息注：投诉单和订单目前是一对一关系，array是预留未来一对多的扩展 |
| —微信订单号 | transactionId | 是 | S(64) | 4200000404201909069117582536 | 投诉单关联的微信订单号 |
| —商户订单号 | outTradeNo | 是 | S(64) | 20190906154617947762231 | 投诉单关联的商户订单号 |
| —订单金额 | amount | 是 | I | 5 | 订单金额，单位（分） |
| -投诉单关联服务订单信息 | serviceOrderInfoList | 否 | C | {“order_id”: “15646546545165651651”,”out_order_no”:”1234323JKHDFE1243252”,”state”: “DOING” } | 投诉单关联服务单信息,支付分服务单投诉时可能存在 |
| —微信支付服务订单号 | order_id | 否 | S(128) | 示例值：15646546545165651651 | 微信支付服务订单号，每个微信支付服务订单号与商户号下对应的商户服务订单号一一对应 |
| —商户服务订单号 | out_order_no | 否 | S(128) | 示例值：1234323JKHDFE1243252 | 商户系统内部服务订单号（不是交易单号），与创建订单时一致 |
| —支付分服务单状态 | state | 否 | S | DOING | 此处上传的是用户发起投诉时的服务单状态，不会实时更新。 DOING：服务订单进行中 REVOKED：商户取消服务订单 WAITPAY：服务订单待支付 DONE：服务订单已完成 |
| -投诉单是否已全额退款 | complaintFullRefunded | 是 | B | true | 投诉单下所有订单是否已全部全额退款 |
| -是否有待回复的用户留言 | incomingUserResponse | 是 | B | true | 投诉单是否有待回复的用户留言 |
| -问题描述 | problemDescription | 是 | S(255) | 不满意商家服务 | 用户发起投诉前选择的faq标题 |
| -用户投诉次数 | userComplaintTimes | 是 | I | 1 | 用户投诉次数。用户首次发起投诉记为1次，用户每有一次继续投诉就加1 |
| -问题类型 | problemType | 否 | S | REFUND | 问题类型为申请退款的单据是需要最高优先处理的单据。 REFUND：退款类型的问题投诉 SERVICE_NOT_WORK：服务权益未生效 OTHERS：其他类型 |
| -申请退款金额 | applyRefundAmount | 否 | I | 10 | 仅当问题类型为申请退款时, 有值, (单位:分) |
| -用户标签列表 | userTagList | 否 | C | 10 | TRUSTED：可信，此类用户满足极速退款条件 OTHERS：其它，此类用户不满足极速退款条件 |
| -补充信息 | additionalInfo | 否 | C | { “share_power_info”:{ “return_time”: “2023-02-10 14:44:00”}, “type”:”SHARE_POWER_TYPE”} | 用在特定行业或场景下返回的补充信息 |
| —补充信息类型 | type | 否 | S | SHARE_POWER_TYPE | 补充信息类型，枚举值： SHARE_POWER_TYPE：充电宝投诉相关行业 |
| —充电宝投诉相关信息 | share_power_info | 否 | C | 10 | 当type为充电宝投诉相关时有值 |
| —归还时间 | return_time | 否 | S | 2015-05-20 13:29:35 | 时间YYYY-MM-DD HH:mm:ss |
| 分页大小 | limit | 是 | I | 10 | 设置该次请求返回的最大投诉条数，范围【1,50】 |
| 分页开始位置 | offset | 是 | I | 10 | 该次请求的分页开始位置，从0开始计数，例如offset=10，表示从第11条记录开始返回。 |
| 投诉总条数 | totalCount | 是 | 100 | 投诉总条数 | |
| 业务结果 | resultCode | 是 | S(16) | SUCCESS | 业务处理结果 |
| 错误代码 | errCode | 否 | S(32) | 当业务结果FAIL时，返回错误代码 | |
| 错误描述 | errMsg | 否 | S(128) | 当业务结果为FAIL时，返回错误描述 |
作者：郑成定 创建时间：2026-05-22 15:10
最后编辑：郑成定 更新时间：2026-09-17 19:13
最后编辑：郑成定 更新时间：2026-09-17 19:13
