Skip to content

投诉历史查询

说明:支付宝的投诉不支持协商历史查询,可以根据投诉列表中返回的 source值为3 或 投诉单号为9位 的为支付宝投诉。

公共参数

参数类型是否必填最大长度描述示例
mch_noString32商户号2014072300007148
methodString128接口名称trade.complaint.history
charsetString10编码方式固定为 utf8utf-8
sign_typeString10商户生成签名字符串所使用的加密方式,目前支持 RSARSA
signString344商户请求参数的签名字符串
timestampString19发送请求的时间,格式为"yyyy-MM-dd HH:mm:ss2014-07-24 03:07:50
versionString3调用的接口版本,固定为:1.01.0
notify_urlString256异步通知地址https://www.xxx.com/notify.html
return_urlString256同步跳转地址https://www.xxx.com/notify.html
biz_contentString业务参数

业务参数

参数类型是否必填最大长度描述示例
complaint_noString20投诉单号200000020231209090135273738

示例代码

php
<?php

$pay_params                = [];
$pay_params['mch_no']      = '鸿闻分配的商户编号';
$pay_params['method']      = 'trade.complaint.history';
$pay_params['version']     = "1.0";
$pay_params['charset']     = 'UTF-8';
$pay_params['sign_type']   = 'rsa';
$pay_params['notify_url']  = 'https://www.xxx.com/notify/test_pay'; // 支付回调通知地址
$pay_params['timestamp']   = date("Y-m-d H:i:s");
$pay_params['biz_content'] = json_decode(['complaint_no' => '200000020231209090135273738']);

ksort($pay_params);

$sign_str = http_build_query($pay_params);
$sign = openssl_sign($sign_str, $sign, '你的私钥', OPENSSL_ALGO_SHA256);

$pay_params['sign'] = $sign;

// guzzle/http
$client = new Client();
$client->post('https://openapi.hwkjpay.com/gateway.do', ['form_params' => $pay_params]);

返回示例

json
{
  "code": 20000,
  "msg": "success",
  "data": [
    {
      "logId": "300200020231209093354338792",
      "operator": "投诉人",
      "operateTime": "2023-12-09 09:26:33",
      "operateType": "USER_CREATE_COMPLAINT",
      "operateDetails": "不知为什么扣费,申请退费。"
    },
    {
      "logId": "300200020231209093354412482",
      "operator": "系统",
      "operateTime": "2023-12-09 09:26:35",
      "operateType": "USER_CREATE_COMPLAINT_SYSTEM_MESSAGE",
      "operateDetails": "用户已向微信支付投诉贵司,请于72小时内妥善处理用户投诉。"
    },
    {
      "logId": "300200020231209093354312016",
      "operator": "商家",
      "operateTime": "2023-12-09 09:29:00",
      "operateType": "MERCHANT_RESPONSE",
      "operateDetails": "您好, 收到您的反馈,您这边购买了短剧解锁套餐,已经为您做了退款处理!带来不便十分抱歉!"
    },
    {
      "logId": "300200020231209093354442506",
      "operator": "商家",
      "operateTime": "2023-12-09 09:29:01",
      "operateType": "MERCHANT_CONFIRM_COMPLETE",
      "operateDetails": "已处理完成。"
    },
    {
      "logId": "300200020231209093354413716",
      "operator": "系统",
      "operateTime": "2023-12-09 09:29:12",
      "operateType": "COMPLAINT_FULL_REFUNDED_SYSTEM_MESSAGE",
      "operateDetails": "已发起全额退款。"
    },
    {
      "logId": "300200020231209093354442672",
      "operator": "系统",
      "operateTime": "2023-12-09 09:29:20",
      "operateType": "COMPLAINT_REFUND_RECEIVED_SYSTEM_MESSAGE",
      "operateDetails": "退款已到账,当前到账金额共为70.11元。"
    }
  ],
  "sign": "MhHpIJ/VD4YGqIorf/0CUe5Uvsx3iAajM9ZlyydA+aAQJqiDZyGdtoTogwtNdTfNMuNbAE2S9JfytqKeTOE9GvNyA16KhZJtZpRjRKP7/0d8QHRrtQ7i/nwfKBwkd7ZvygmbQSblol71Bzd+VZUwyGEdyNV7Tb2ZA1vjjSSwgxHT4KfnGIAPieDVTWggqMBaTOHfux0DUpUo6KSDaAdA7yWjpOqSFgyh7775sPEM2iSj71yF8EjmXyG7rrD876aG23Z7I5e6lf0mcixrfuiEqOR0WJdRYfnpR56n6WeY19v1v0I5DWrWqBEopyGJuaGAPh+Sv1UOp82EqPXXhGb07g=="
}

返回字段说明

名称描述
logId日志 ID
operator操作人
operateTime操作时间
operateType操作类型
operateDetails内容