业务说明
商户可通过调用此接口,查询指定时间段的所有用户投诉信息,以分页输出查询结果。
请求报文
JSON:
{"request_type": "risk_complaints_listquery_request","isspid": "39493002","transaction_id": "query202406170000000001","system_id": "8888","seller_account": "66660000000000001","begin_time": "20240617000000","end_time": "20240617235959","page": "1","size": "10","sign": "2EB4051F33C84719D59E0F5EADACF5D2"}
XML:
<?xml version="1.0" encoding="GBK"?><business_trans><request_type>risk_complaints_listquery_request</request_type><isspid>39493002</isspid><transaction_id>query202406170000000001</transaction_id><system_id>8888</system_id><seller_account>66660000000000001</seller_account><begin_time>20240617000000</begin_time><end_time>20240617235959</end_time><page>1</page><size>10</size></business_trans>
请求报文说明
| 节点名称 | 中文名称 | 类型 | 说明 | 是否必填 |
|---|---|---|---|---|
| sign | 报文签名 | String(32) | 请求报文格式为JSON时必填 计算签名方式请看2.1章节 | 可空 |
| request_type | 请求类型 | String(32) | 固定值:risk_complaints_listquery_request | 必填 |
| isspid | 商户号 | String(8) | 翼码商户号,由翼码提供 | 必填 |
| transaction_id | 请求流水号 | String(32) | 必填 | |
| system_id | 系统平台号 | String(4) | 由翼码提供 | 必填 |
| seller_account | 收款账户编号 | String(64) | 必填 | |
| begin_time | 开始时间 | String(14) | 格式:yyyyMMddHHmmss,例如:20240617000000 注意,查询日期跨度不超过30天 | 必填 |
| end_time | 结束时间 | String(14) | 格式:yyyyMMddHHmmss,例如:20240617235959 注意,查询日期跨度不超过30天 | 必填 |
| page | 当前页码 | String | 传空默认为1 | 可空 |
| size | 分页大小 | String | 分页最大条数,传空默认为10 | 可空 |
返回报文
JSON:
{"response_type": "risk_complaints_listquery_response","isspid": "39493002","transaction_id": "query2022083111260000001","seller_account": "66660000000000001","page": "1","size": "10","list": [{"agentOrg": "55333100000F6UR","complaint_detail": "需要退款没找到入口,请商家联系我","complaint_id": "200000020241213110233971398","complaint_order_info": [{"amount": "1","out_trade_no": "241213123010143223","transaction_id": "4200059297202412138968485906"}],"complaint_state": "PENDING","complaint_time": "2024-12-13T11:37:19+08:00","complainted_mchid": "608051663","merchantName": "福建创贝信息科技有限公司927605","merchantNo": "563391048169ZC3","payer_phone": "18659101805"}],"result": {"id": "0000","comment": "查询成功"},"sign": "824FE953936278AEE61CA8CEE8A08C86"}
XML:
<?xml version="1.0" encoding="GBK"?><business_trans><response_type>risk_complaints_listquery_response</response_type><isspid>39493002</isspid><transaction_id>query2022083111260000001</transaction_id><seller_account>66660000000000001</seller_account><page>1</page><size>10</size><list><![CDATA[[{"agentOrg": "55333100000F6UR","complaint_detail": "需要退款没找到入口,请商家联系我","complaint_id": "200000020241213110233971398","complaint_order_info": [{"amount": "1","out_trade_no": "241213123010143223","transaction_id": "4200059297202412138968485906"}],"complaint_state": "PENDING","complaint_time": "2024-12-13T11:37:19+08:00","complainted_mchid": "608051663","merchantName": "福建创贝信息科技有限公司927605","merchantNo": "563391048169ZC3","payer_phone": "18659101805"}]]]></list><result><id>0000</id><comment>查询成功</comment></result></business_trans>
返回报文说明
标准接口会因业务升级需要而新增节点,请在解析返回报文时避免新增未知节点产生的程序出错!
| 节点名称 | 中文名称 | 类型 | 说明 | 是否必填 |
|---|---|---|---|---|
| sign | 报文签名 | String(32) | 返回报文格式为JSON时必填 计算签名方式请看2.1章节 | 可选 |
| response_type | 返回类型 | String(32) | 固定值:risk_complaints_listquery_response | 必填 |
| isspid | 商户号 | String(8) | 翼码商户号,由翼码提供 | 必填 |
| transaction_id | 请求流水号 | String(32) | 与请求报文相同 | 必填 |
| seller_account | 收款账户编号 | String(64) | 与请求报文相同 | 必填 |
| page | 当前页码 | String | 必填 | |
| size | 分页大小 | String | 分页最大条数 | 必填 |
| list | 数据列表 | JSONArray | 数据列表采用JSON格式 XML报文时使用CDATA标签包裹 | 可空 |
| result ->id | 响应码 | String(4) | 0000:查询成功 其它失败,错误信息说明见“响应码解释”字段 | 必填 |
| result ->comment | 响应码解释 | String(64) | 响应码对应中文注解,用于显示提示 | 必填 |
标准接口会因业务升级需要而新增节点,请在解析返回报文时避免新增未知节点产生的程序出错!
list 数据列表 (JSONArray)
| JSON节点 | 参数名称 | 类型 | 说明 | 是否必填 |
|---|---|---|---|---|
| complaint_detail | 投诉详情 | String(300) | 投诉的具体描述 | 必填 |
| complaint_id | 投诉单号 | String(64) | 必填 | |
| complaint_order_info | 投诉单关联订单信息 | JSONArray | 必填 | |
| complaint_state | 投诉单状态 | String(30) | 标识当前投诉单所处的处理阶段,具体状态如下所示: PENDING:待处理 PROCESSING:处理中 PROCESSED:已处理完成 | 必填 |
| complaint_time | 投诉时间 | String(32) | yyyy-MM-DDTHH:mm:ss.sss+TIMEZONE | 必填 |
| complainted_mchid | 被诉商户号 | String(64) | 必填 | |
| payer_phone | 投诉人联系方式 | String(64) | 可空 | |
| merchantNo | 收银宝平台客户号 | String | 可空 | |
| merchantName | 收银宝平台客户名称 | String | 可空 | |
| agentOrg | 收银宝平台代理商号 | String | 可空 |
complaint_order_info 投诉单关联订单信息 (JSONArray)
| JSON节点 | 参数名称 | 类型 | 说明 | 是否必填 |
|---|---|---|---|---|
| amount | 订单金额 | String(9) | 单位元 | 必填 |
| out_trade_no | 商户订单号 | String(64) | 必填 | |
| transaction_id | 微信订单号 | String(64) | 必填 |


