业务说明

商户可通过调用此接口，查询指定投诉单的用户与商户的协商历史，以分页输出查询结果，方便商户根据处理历史来制定后续处理方案。

请求报文

JSON:

  1. {
  2.     "request_type": "risk_complaints_history_request",
  3.     "isspid": "39493002",
  4.     "transaction_id": "query202406170000000001",
  5.     "system_id": "8888",
  6.     "seller_account": "66660000000000001",
  7.     "complaint_id": "200201820200101080076610000",
  8.     "offset": "0",
  9.     "size": "100",
  10.     "sign": "2EB4051F33C84719D59E0F5EADACF5D2"
  11. }

XML:

  1. <?xml version="1.0" encoding="GBK"?>
  2. <business_trans>
  3.     <request_type>risk_complaints_history_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.     <complaint_id>200201820200101080076610000</complaint_id>
  9.     <offset>0</offset>
  10.     <size>100</size>
  11. </business_trans>

请求报文说明

节点名称中文名称类型说明是否必填
sign报文签名String(32)请求报文格式为JSON时必填
计算签名方式请看2.1章节		可空
request_type请求类型String(32)固定值：risk_complaints_history_request必填
isspid商户号String(8)翼码商户号，由翼码提供必填
transaction_id请求流水号String(32)必填
system_id系统平台号String(4)由翼码提供必填
seller_account收款账户编号String(64)必填
complaint_id投诉单号String(64)必填
offset分页开始位置String该次请求的分页开始位置，从0开始计数，例如offset=10，表示从第11条记录开始返回。
传空默认为0		可空
size分页大小String设置该次请求返回的最大协商历史条数
传空默认为100		可空

返回报文

JSON:

  1. {
  2.     "response_type": "risk_complaints_history_response",
  3.     "isspid": "39493002",
  4.     "transaction_id": "query2022083111260000001",
  5.     "seller_account": "66660000000000001",
  6.     "complaint_id": "200201820200101080076610000",
  7.     "offset": "0",
  8.     "size": "100",
  9.     "list": [
  10.         {
  11.             "complaint_media_list": {
  12.                 "media_type": "USER_COMPLAINT_IMAGE",
  13.                 "media_url": [
  14.                     "https://api.mch.weixin.qq.com/v3/merchant-service/images/xxxxx"
  15.                 ]
  16.             },
  17.             "image_list": [
  18.                 "https://qpic.cn/xxx"
  19.             ],
  20.             "log_id": "300285320210322170000071077",
  21.             "operate_details": "已与用户电话沟通解决",
  22.             "operate_time": "2015-05-20T13:29:35.120+08:00",
  23.             "operate_type": "USER_CREATE_COMPLAINT",
  24.             "operator": "投诉人"
  25.         }
  26.     ],
  27.     "result": {
  28.         "id": "0000",
  29.         "comment": "查询成功"
  30.     },
  31.     "sign": "824FE953936278AEE61CA8CEE8A08C86"
  32. }

XML:

  1. <?xml version="1.0" encoding="GBK"?>
  2. <business_trans>
  3.     <response_type>risk_complaints_history_response</response_type>
  4.     <isspid>39493002</isspid>
  5.     <transaction_id>query2022083111260000001</transaction_id>
  6.     <seller_account>66660000000000001</seller_account>
  7.     <complaint_id>200201820200101080076610000</complaint_id>
  8.     <offset>0</offset>
  9.     <size>100</size>
  10.     <list><![CDATA[
  11.     [
  12.         {
  13.             "complaint_media_list": {
  14.                 "media_type": "USER_COMPLAINT_IMAGE",
  15.                 "media_url": [
  16.                     "https://api.mch.weixin.qq.com/v3/merchant-service/images/xxxxx"
  17.                 ]
  18.             },
  19.             "image_list": [
  20.                 "https://qpic.cn/xxx"
  21.             ],
  22.             "log_id": "300285320210322170000071077",
  23.             "operate_details": "已与用户电话沟通解决",
  24.             "operate_time": "2015-05-20T13:29:35.120+08:00",
  25.             "operate_type": "USER_CREATE_COMPLAINT",
  26.             "operator": "投诉人"
  27.         }
  28.     ]
  29.     ]]></list>
  30.     <result>
  31.         <id>0000</id>
  32.         <comment>查询成功</comment>
  33.     </result>
  34. </business_trans>

返回报文说明

标准接口会因业务升级需要而新增节点，请在解析返回报文时避免新增未知节点产生的程序出错！

节点名称中文名称类型说明是否必填
sign报文签名String(32)返回报文格式为JSON时必填
计算签名方式请看2.1章节		可选
response_type返回类型String(32)固定值：risk_complaints_history_response必填
isspid商户号String(8)翼码商户号，由翼码提供必填
transaction_id请求流水号String(32)与请求报文相同必填
seller_account收款账户编号String(64)与请求报文相同必填
complaint_id投诉单号String(64)与请求报文相同必填
offset分页开始位置String该次请求的分页开始位置，从0开始计数，例如offset=10，表示从第11条记录开始返回。
传空默认为0		必填
size分页大小String设置该次请求返回的最大协商历史条数
传空默认为100		必填
list数据列表JSONArray数据列表采用JSON格式
XML报文时使用CDATA标签包裹		可空
result
->id		响应码String(4)0000：查询成功
其它失败，错误信息说明见“响应码解释”字段		必填
result
->comment		响应码解释String(64)响应码对应中文注解，用于显示提示必填

标准接口会因业务升级需要而新增节点，请在解析返回报文时避免新增未知节点产生的程序出错！

list 数据列表 (JSONArray)

JSON节点参数名称类型说明是否必填
complaint_media_list操作资料列表JSONObject对投诉单执行操作时上传的资料凭证，包含用户、商户、微信支付客服等角色操作可空
image_list图片凭证Array[String]商户或微信支付客服上传的图片，以URL形式返回。注：此字段不包含用户提交的图片凭证，建议统一使用complaint_media_list字段接收和请求资料凭证，未来该字段将废弃可空
log_id操作流水号String(64)必填
operate_details操作内容String(200)当前投诉协商记录的具体内容可空
operate_time操作时间String(64)当前投诉协商记录的操作时间必填
operate_type操作类型StringUSER_CREATE_COMPLAINT：用户提交投诉
USER_CONTINUE_COMPLAINT：用户继续投诉
USER_RESPONSE：用户留言
PLATFORM_RESPONSE：平台留言
MERCHANT_RESPONSE：商户留言
MERCHANT_CONFIRM_COMPLETE：商户申请结单
USER_CREATE_COMPLAINT_SYSTEM_MESSAGE：用户提交投诉系统通知
COMPLAINT_FULL_REFUNDED_SYSTEM_MESSAGE：投诉单发起全额退款系统通知
USER_CONTINUE_COMPLAINT_SYSTEM_MESSAGE：用户继续投诉系统通知
USER_REVOKE_COMPLAINT：用户主动撤诉（只存在于历史投诉单的协商历史中）
USER_COMFIRM_COMPLAINT：用户确认投诉解决（只存在于历史投诉单的协商历史中）
PLATFORM_HELP_APPLICATION：平台催办
USER_APPLY_PLATFORM_HELP：用户申请平台协助
MERCHANT_APPROVE_REFUND：商户同意退款申请
MERCHANT_REFUSE_RERUND：商户拒绝退款申请, 此时操作内容里展示拒绝原因
USER_SUBMIT_SATISFACTION：用户提交满意度调查结果,此时操作内容里会展示满意度分数
SERVICE_ORDER_CANCEL：服务订单已取消
SERVICE_ORDER_COMPLETE：服务订单已完成
COMPLAINT_PARTIAL_REFUNDED_SYSTEM_MESSAGE：投诉单发起部分退款系统通知
COMPLAINT_REFUND_RECEIVED_SYSTEM_MESSAGE：投诉单退款到账系统通知
COMPLAINT_ENTRUSTED_REFUND_SYSTEM_MESSAGE：投诉单受托退款系统通知		必填
operator操作人String(64)当前投诉协商记录的操作人必填

complaint_media_list 操作资料列表 (JSONObject)

JSON节点参数名称类型说明是否必填
media_type媒体文件业务类型StringUSER_COMPLAINT_IMAGE：用户提交投诉时上传的图片凭证
OPERATION_IMAGE：用户、商户、微信支付客服在协商解决投诉时，上传的图片凭证		必填
media_url媒体文件请求urlArray[String(512)]必填