投诉记录查询

网关请求地址

POST https://openapi.hwkjpay.com/gateway.do

公共参数

参数	类型	是否必填	最大长度	描述	示例
mch_no	String	是	32	商户号	2014072300007148
method	String	是	128	接口名称	trade.complaint.list
charset	String	是	10	编码方式固定为 utf8	utf-8
sign_type	String	是	10	商户生成签名字符串所使用的加密方式，目前支持 RSA	RSA
sign	String	是	344	商户请求参数的签名字符串
timestamp	String	是	19	发送请求的时间，格式为"yyyy-MM-dd HH:mm:ss	2014-07-24 03:07:50
version	String	是	3	调用的接口版本，固定为：1.0	1.0
notify_url	String	是	256	异步通知地址	https://www.xxx.com/notify.html
return_url	String	否	256	同步跳转地址	https://www.xxx.com/notify.html
biz_content	String	是		业务参数

业务参数

参数	类型	是否必填	最大长度	描述	示例
page	Int	否	11	页码值	1
size	Int	否	3	每页条数, 最大 100	10
complaint_state	String	否	20	投诉单状态 1-待处理 2-处理中 3-处理完成	1
is_full_refunded	Int	否	11	是否退款 1已退款 2未退款	1
complaint_start_time	String	否	19	开始时间，格式为"yyyy-MM-dd HH:mm:ss complaint_start_time 与 complaint_end_time 同时存在才生效	2014-07-24 03:07:50
complaint_end_time	String	否	19	结束时间，格式为"yyyy-MM-dd HH:mm:ss complaint_start_time 与 complaint_end_time 同时存在才生效	2014-07-24 03:07:50
source	String	否	1	来源：1微信；2微信小程序；3支付宝；	1
institution_id	String	否	3	三方机构ID	152
merchant_order_no	String	否	18	鸿闻订单号	2014072300007148
complaint_no	String	否	28	投诉单号	2014072300007148

示例代码

php

<?php

$pay_params                = [];
$pay_params['mch_no']      = '鸿闻分配的商户编号';
$pay_params['method']      = 'trade.complaint.list';
$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(['size' => 1]);

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": [
    {
      "complaint_no": "200000020231209090135273738",
      "complaint_time": "2023-12-09 09:26:32",
      "complaint_detail": "不知什么兏因为何扣费申请退费",
      "complaint_state": "PROCESSED",
      "complaint_contact": "15248618245",
      "wechat_merchant_no": "605000072",
      "wechat_order_no": "4200002048202312044136883932",
      "merchant_order_no": "590176528542957568",
      "amount": "70.11",
      "bank_order_no": "5893097375231204",
      "trade_time": "2023-12-04 14:16:05",
      "complaint_media_dto_list": ""
    }
  ],
  "sign": "MhHpIJ/VD4YGqIorf/0CUe5Uvsx3iAajM9ZlyydA+aAQJqiDZyGdtoTogwtNdTfNMuNbAE2S9JfytqKeTOE9GvNyA16KhZJtZpRjRKP7/0d8QHRrtQ7i/nwfKBwkd7ZvygmbQSblol71Bzd+VZUwyGEdyNV7Tb2ZA1vjjSSwgxHT4KfnGIAPieDVTWggqMBaTOHfux0DUpUo6KSDaAdA7yWjpOqSFgyh7775sPEM2iSj71yF8EjmXyG7rrD876aG23Z7I5e6lf0mcixrfuiEqOR0WJdRYfnpR56n6WeY19v1v0I5DWrWqBEopyGJuaGAPh+Sv1UOp82EqPXXhGb07g=="
}

返回字段说明

名称	描述
complaint_no	投诉单号
complaint_time	投诉时间
complaint_detail	投诉内容
complaint_state	投诉状态
complaint_contact	投诉人联系方式
wechat_merchant_no	微信商户号
wechat_order_no	微信订单号
merchant_order_no	鸿闻订单号
amount	投诉金额
bank_order_no	银行单号
trade_time	交易时间
complaint_media_dto_list	图片
is_full_refunded	是否退款：1已退款；2未退款；
out_trade_no	商户订单号
source	来源：1 微信；2 微信小程序；3 支付宝；
institution	三方机构名称
institution_id	三方机构 ID

投诉状态说明

名称	描述
PENDING	待处理
PROCESSING	处理中
PROCESSED	处理完成

投诉记录查询 ​

投诉记录查询