业务说明
商户可通过调用此接口,查询指定时间段的所有用户投诉信息,以分页输出查询结果。
请求报文
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) | 必填 |