业务说明

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

请求报文

JSON:

  1. {
  2.     "request_type": "risk_wxcomplaint_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_wxcomplaint_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_wxcomplaint_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_wxcomplaint_listquery_response",
  3.     "isspid": "39493002",
  4.     "transaction_id": "query2022083111260000001",
  5.     "seller_account": "66660000000000001",
  6.     "page": "1",
  7.     "size": "10",
  8.     "list": [
  9.         {
  10.             "complaint_detail": "反馈一个重复扣费的问题",
  11.             "complaint_id": "200201820200101080076610000",
  12.             "complaint_order_info": [
  13.                 {
  14.                     "amount": 3,
  15.                     "out_trade_no": "20190906154617947762231",
  16.                     "transaction_id": "4200000404201909069117582536"
  17.                 }
  18.             ],
  19.             "complaint_state": "PENDING",
  20.             "complaint_time": "2015-05-20T13:29:35.120+08:00",
  21.             "complainted_mchid": "1900012181",
  22.             "payer_phone": "18500000000",
  23.             "merchantNo": "",
  24.             "merchantName": "",
  25.             "agentOrg": ""
  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_wxcomplaint_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.             "complaint_detail": "反馈一个重复扣费的问题",
  13.             "complaint_id": "200201820200101080076610000",
  14.             "complaint_order_info": [
  15.                 {
  16.                     "amount": 3,
  17.                     "out_trade_no": "20190906154617947762231",
  18.                     "transaction_id": "4200000404201909069117582536"
  19.                 }
  20.             ],
  21.             "complaint_state": "PENDING",
  22.             "complaint_time": "2015-05-20T13:29:35.120+08:00",
  23.             "complainted_mchid": "1900012181",
  24.             "payer_phone": "18500000000",
  25.             "merchantNo": "",
  26.             "merchantName": "",
  27.             "agentOrg": ""
  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_wxcomplaint_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可空
merchantNo收银宝平台客户号String可空
merchantName收银宝平台客户名称String可空
agentOrg收银宝平台代理商号String可空

complaint_order_info 投诉单关联订单信息 (JSONArray)

JSON节点参数名称类型说明是否必填
amount订单金额Integer单位元必填
out_trade_no商户订单号String(64)必填
transaction_id微信订单号String(64)必填