业务说明

商户可通过调用此接口，查询指定投诉单的用户投诉详情，包含投诉关联订单信息、支付分服务单信息、投诉的问题类型、问题描述、投诉人联系方式等信息，方便商户处理投诉。

请求报文

JSON:

  1. {
  2.     "request_type": "risk_wxcomplaint_detail_request",
  3.     "isspid": "39493002",
  4.     "transaction_id": "query202406170000000001",
  5.     "system_id": "8888",
  6.     "seller_account": "66660000000000001",
  7.     "complaint_id": "200201820200101080076610000",
  8.     "sign": "2EB4051F33C84719D59E0F5EADACF5D2"
  9. }

XML:

  1. <?xml version="1.0" encoding="GBK"?>
  2. <business_trans>
  3.     <request_type>risk_wxcomplaint_detail_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. </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)必填
complaint_id投诉单号String(64)必填

返回报文

JSON:

  1. {
  2.     "response_type": "risk_wxcomplaint_detail_response",
  3.     "isspid": "39493002",
  4.     "transaction_id": "query2022083111260000001",
  5.     "seller_account": "66660000000000001",
  6.     "complaint_id": "200201820200101080076610000",
  7.     "detail": {
  8.         "complaint_detail": "反馈一个重复扣费的问题",
  9.         "complaint_full_refunded": true,
  10.         "complaint_id": "200201820200101080076610000",
  11.         "complaint_media_list": [
  12.             {
  13.                 "media_type": "USER_COMPLAINT_IMAGE",
  14.                 "media_url": [
  15.                     "https://api.mch.weixin.qq.com/v3/merchant-service/images/xxxxx"
  16.                 ]
  17.             }
  18.         ],
  19.         "complaint_order_info": [
  20.             {
  21.                 "amount": 3,
  22.                 "out_trade_no": "20190906154617947762231",
  23.                 "transaction_id": "4200000404201909069117582536"
  24.             }
  25.         ],
  26.         "complaint_state": "PENDING",
  27.         "complaint_time": "2015-05-20T13:29:35.120+08:00",
  28.         "complainted_mchid": "1900012181",
  29.         "incoming_user_response": true,
  30.         "payer_openid": "oUpF8uMuAJO_M2pxb1Q9zNjWeS6o",
  31.         "payer_phone": "18500000000",
  32.         "problem_description": "不满意商家服务",
  33.         "problem_type": "REFUND",
  34.         "service_order_info": [
  35.             {
  36.                 "order_id": "15646546545165651651",
  37.                 "out_order_no": "1234323JKHDFE1243252",
  38.                 "state": "DOING"
  39.             }
  40.         ],
  41.         "user_complaint_times": 1,
  42.         "user_tag_list": [
  43.             "TRUSTED"
  44.         ]
  45.     },
  46.     "result": {
  47.         "id": "0000",
  48.         "comment": "查询成功"
  49.     },
  50.     "sign": "824FE953936278AEE61CA8CEE8A08C86"
  51. }

XML:

  1. <?xml version="1.0" encoding="GBK"?>
  2. <business_trans>
  3.     <response_type>risk_wxcomplaint_detail_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.     <detail><![CDATA[
  9.     {
  10.         "complaint_detail": "反馈一个重复扣费的问题",
  11.         "complaint_full_refunded": true,
  12.         "complaint_id": "200201820200101080076610000",
  13.         "complaint_media_list": [
  14.             {
  15.                 "media_type": "USER_COMPLAINT_IMAGE",
  16.                 "media_url": [
  17.                     "https://api.mch.weixin.qq.com/v3/merchant-service/images/xxxxx"
  18.                 ]
  19.             }
  20.         ],
  21.         "complaint_order_info": [
  22.             {
  23.                 "amount": 3,
  24.                 "out_trade_no": "20190906154617947762231",
  25.                 "transaction_id": "4200000404201909069117582536"
  26.             }
  27.         ],
  28.         "complaint_state": "PENDING",
  29.         "complaint_time": "2015-05-20T13:29:35.120+08:00",
  30.         "complainted_mchid": "1900012181",
  31.         "incoming_user_response": true,
  32.         "payer_openid": "oUpF8uMuAJO_M2pxb1Q9zNjWeS6o",
  33.         "payer_phone": "18500000000",
  34.         "problem_description": "不满意商家服务",
  35.         "problem_type": "REFUND",
  36.         "service_order_info": [
  37.             {
  38.                 "order_id": "15646546545165651651",
  39.                 "out_order_no": "1234323JKHDFE1243252",
  40.                 "state": "DOING"
  41.             }
  42.         ],
  43.         "user_complaint_times": 1,
  44.         "user_tag_list": [
  45.             "TRUSTED"
  46.         ]
  47.     }
  48.     ]]></detail>
  49.     <result>
  50.         <id>0000</id>
  51.         <comment>查询成功</comment>
  52.     </result>
  53. </business_trans>

返回报文说明

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

节点名称中文名称类型说明是否必填
sign报文签名String(32)返回报文格式为JSON时必填
计算签名方式请看2.1章节		可选
response_type返回类型String(32)固定值：risk_wxcomplaint_detail_response必填
isspid商户号String(8)翼码商户号，由翼码提供必填
transaction_id请求流水号String(32)与请求报文相同必填
seller_account收款账户编号String(64)与请求报文相同必填
complaint_id投诉单号String(64)与请求报文相同必填
detail详情JSONObject详情采用JSON格式
XML报文时使用CDATA标签包裹		可空
result
->id		响应码String(4)0000：查询成功
其它失败，错误信息说明见“响应码解释”字段		必填
result
->comment		响应码解释String(64)响应码对应中文注解，用于显示提示必填

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

detail 详情 (JSONObject)

JSON节点参数名称类型说明是否必填
complaint_detail投诉详情String(300)投诉的具体描述必填
complaint_full_refunded投诉单是否已全额退款booleantrue：已全额退款
false：未全额退款		必填
complaint_id投诉单号String(64)必填
complaint_media_list投诉资料列表JSONArray用户上传的投诉相关资料，包括图片凭证等可空
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)必填
incoming_user_response是否有待回复的用户留言booleantrue：是
false：否		必填
payer_openid投诉人OpenIDString(128)投诉人在商户AppID下的唯一标识，支付分服务单类型无可空
payer_phone投诉人联系方式String可空
problem_description问题描述String(256)用户发起投诉前选择的faq标题（2021年7月15日之后的投诉单均包含此信息）必填
problem_type问题类型String可选取值
REFUND：申请退款
SERVICE_NOT_WORK：服务权益未生效
OTHERS：其他类型		可空
service_order_info投诉单关联服务单信息JSONArray可空
user_complaint_times用户投诉次数Integer用户首次发起投诉记为1次，用户每有一次继续投诉就加1必填
user_tag_list用户标签列表Array[String]可选取值
TRUSTED：此类用户满足极速退款条件
HIGH_RISK：高风险投诉，请按照运营要求优先妥善处理		可空

complaint_media_list 投诉资料列表 (JSONArray)

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

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

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

service_order_info 投诉单关联服务单信息 (JSONArray)

JSON节点参数名称类型说明是否必填
order_id微信支付服务订单号String(128)微信支付服务订单号，每个微信支付服务订单号与商户号下对应的商户服务订单号一一对应可空
out_order_no商户服务订单号String(128)商户系统内部服务订单号（不是交易单号），与创建订单时一致可空
state支付分服务单状态StringDOING：服务订单进行中
REVOKED：服务订单已取消
WAITPAY：服务订单待支付
DONE：服务订单已完成		可空