业务说明

商户可通过调用此接口,查询指定时间段的所有用户投诉信息,以分页输出查询结果。

请求报文

JSON:

  1. {
  2. "request_type": "risk_complaints_listquery_request",
  3. "isspid": "39493002",
  4. "transaction_id": "query202406170000000001",
  5. "system_id": "8888",
  6. "seller_account": "66660000000000001",
  7. "begin_time": "20240617000000",
  8. "end_time": "20240617235959",
  9. "page": "1",
  10. "size": "10",
  11. "sign": "2EB4051F33C84719D59E0F5EADACF5D2"
  12. }

XML:

  1. <?xml version="1.0" encoding="GBK"?>
  2. <business_trans>
  3. <request_type>risk_complaints_listquery_request</request_type>
  4. <isspid>39493002</isspid>
  5. <transaction_id>query202406170000000001</transaction_id>
  6. <system_id>8888</system_id>
  7. <seller_account>66660000000000001</seller_account>
  8. <begin_time>20240617000000</begin_time>
  9. <end_time>20240617235959</end_time>
  10. <page>1</page>
  11. <size>10</size>
  12. </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:

  1. {
  2. "response_type": "risk_complaints_listquery_response",
  3. "isspid": "39493002",
  4. "transaction_id": "query2022083111260000001",
  5. "seller_account": "66660000000000001",
  6. "page": "1",
  7. "size": "10",
  8. "list": [
  9. {
  10. "agentOrg": "55333100000F6UR",
  11. "complaint_detail": "需要退款没找到入口,请商家联系我",
  12. "complaint_id": "200000020241213110233971398",
  13. "complaint_order_info": [
  14. {
  15. "amount": "1",
  16. "out_trade_no": "241213123010143223",
  17. "transaction_id": "4200059297202412138968485906"
  18. }
  19. ],
  20. "complaint_state": "PENDING",
  21. "complaint_time": "2024-12-13T11:37:19+08:00",
  22. "complainted_mchid": "608051663",
  23. "merchantName": "福建创贝信息科技有限公司927605",
  24. "merchantNo": "563391048169ZC3",
  25. "payer_phone": "18659101805"
  26. }
  27. ],
  28. "result": {
  29. "id": "0000",
  30. "comment": "查询成功"
  31. },
  32. "sign": "824FE953936278AEE61CA8CEE8A08C86"
  33. }

XML:

  1. <?xml version="1.0" encoding="GBK"?>
  2. <business_trans>
  3. <response_type>risk_complaints_listquery_response</response_type>
  4. <isspid>39493002</isspid>
  5. <transaction_id>query2022083111260000001</transaction_id>
  6. <seller_account>66660000000000001</seller_account>
  7. <page>1</page>
  8. <size>10</size>
  9. <list><![CDATA[
  10. [
  11. {
  12. "agentOrg": "55333100000F6UR",
  13. "complaint_detail": "需要退款没找到入口,请商家联系我",
  14. "complaint_id": "200000020241213110233971398",
  15. "complaint_order_info": [
  16. {
  17. "amount": "1",
  18. "out_trade_no": "241213123010143223",
  19. "transaction_id": "4200059297202412138968485906"
  20. }
  21. ],
  22. "complaint_state": "PENDING",
  23. "complaint_time": "2024-12-13T11:37:19+08:00",
  24. "complainted_mchid": "608051663",
  25. "merchantName": "福建创贝信息科技有限公司927605",
  26. "merchantNo": "563391048169ZC3",
  27. "payer_phone": "18659101805"
  28. }
  29. ]
  30. ]]></list>
  31. <result>
  32. <id>0000</id>
  33. <comment>查询成功</comment>
  34. </result>
  35. </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)必填