微信投诉API文档

2024-09-07 20:48:00 bone

签名方法

  • 获取所有post 请求内容,不包括字节类型参数,如文件、字节流,剔除 sign 字段,剔除值为空的参数;
  • 按照第一个字符的键值 ASCII 码递增排序(字母升序排序),如果遇到相同字符则按照第二个字符的键值 ASCII 码递增排序,以此类推;
  • 将排序后的参数与其对应值,组合成 参数=参数值 的格式,并且把这些参数用 & 字符连接起来,此时生成的字符串为待签名字符串。

必填参数说明

M = 必填
O = 非必填
C= 条件必填

公共请求参数

所有请求都必须添加公共参数。
变量名必填限制类型说明
mchidM-String商户号
appidO-String应用APPID
methodM-String接口名称
charsetM-String编码格式,请求使用的编码格式,如utf-8,gbk,gb2312等
sign_typeM-String签名方法,目前仅支持RSA2
timestampM-String请求时间,请传入当前请求时间的时间戳
versionM-String版本号,调用的接口版本,固定为:1.0
biz_contentM-String业务参数集合,json格式,最大长度不限,除公共参数外所有业务参数都必须放在这个参数中传递。如果不带参数。请传"{}"
signM-String商户请求参数的签名串

请求地址

请联系平台方获取,地址后缀请添加/
请求地址拼接method
如使用交易下单接口:
如请求地址为:https://zf.xonb.com
拼接后为:https://zf.xonb.com/index/ComplaintQuery

1、商户微信投诉信息查询接口

1.1接口说明

查询微信投诉列表的相关信息。(每个商户每天请求数量有限制,限定:100次/天)

1.2请求方式

POST

1.3接口名称

method = index/ComplaintQuery

1.4业务参数

公共请求参数内的biz_content业务参数集合,json格式,如果不带参数,请传 "{}",
变量名必填限制类型说明
limitO-string返回投诉信息数量。默认为100,数值不能超过1000条
startO-string投诉时间范围中开始时间
endO-string投诉时间范围中结束时间

1.5返回参数

变量名必填限制类型说明
codeMstring返回状态码1 - 成功,非1 - 失败
msgCstring返回错误信息
dataMstring业务返回参数,请查看下方具体参数
data参数表
变量名必填限制类型说明
idMstring投诉号
complaint_idMstring微信投诉单号
complaint_timeMstring投诉时间
complaint_detailMstring投诉内容
complaint_stateMstring投诉状态:投诉单状态,PENDING:待处理,PROCESSING:处理中,PROCESSED:已处理完成'
complainted_mchidMstring微信商户号
payer_phoneMstring投诉人电话
complaint_media_listCstring投诉相关附件信息
transaction_idMstring流水号
out_trade_noMstring订单号
amountMstring订单金额
complaint_full_refundedMstring投诉单是否已全额退款
incoming_user_responseMstring是否有待回复的用户留言
typeMstring接收模式
payment_channel_list_idMstring渠道号id
problem_descriptionMstring问题描述
user_complaint_timesMstring用户投诉次数
problem_typeMstring问题类型
apply_refund_amountMstring申请退款金额
mer_nameMstring被诉的商户名称
mchidMstring微信商户号(从业机构号)