违规记录查询

更新时间：2024.11.18

应用场景

方便银行服务商查询特约商户违规记录

接口链接

URL地址：https://api.mch.weixin.qq.com/risk/getviolation

是否需要证书

是

请求参数

字段名	变量名	必填	类型	示例值	描述
商户号	mch_id	是	String(32)	1230000110	银行服务商、从业机构、渠道商的商户号
随机字符串	nonce_str	是	String(32)	5K8264ILTKCH16CQ2502SI8ZNMTM67VS	随机字符串，不长于32位
签名	sign	是	String(32)	C380BEC2BFD727A4B6845133519F3AD6	通过签名算法计算得出的签名值，详见签名生成算法
签名类型	sign_type	是	String(32)	HMAC-SHA256	签名类型
开始时间	begin_time	是	String(32)	2020-05-11 10:10:00	格式：yyyy-mm-dd HH:MM:SS 结束时间和开始时间的区间不超过30天，超出后会返回失败
结束时间	end_time	是	String(32)	2020-05-11 10:10:00	格式：yyyy-mm-dd HH:MM:SS 结束时间和开始时间的区间不超过30天，超出后会返回失败
页码	page_index	是	String(10)	1	当前查询的具体分页页码
每页返回的数量	page_size	是	String(10)	10	该参数可设置每页返回内容的最大条数，最大不超过50
违规记录数据格式	violation_records_format	是	String(10)	csv	csv：返回数据包是文本格式，使用逗号分隔 json：返回的violation_records字段是json格式，详见返回参数

注意

商户简称长度为中文字符个数，其他均为字节数；
参数值用XML转义或加CDATA标签用于说明数据不被XML解析器解析。

示例：

1<xml>
2<mch_id>123456</mch_id>
3<nonce_str>5087e0xessefellkg</nonce_str>
4<sign>xxxxxx</sign>
5<sign_type>HMAC-SHA256</sign_type>
6<begin_time>2017-07-02 0:0:0</begin_time>
7<end_time>2017-07-29 23:59:59</end_time>
8</xml>

返回结果

失败的时候返回以下字段：

字段名	变量名	必填	类型	示例值	描述
返回状态码	return_code	是	String(16)	SUCCESS	SUCCESS/FAIL 此字段是通信标识，非交易标识，交易是否成功需要查看result_code来判断
返回信息	return_msg	否	String(128)	签名失败	返回信息，如非空，为错误原因签名失败参数格式校验错误
错误代码	err_code	否	String(32)	INVALID_REQUEST	错误代码
错误代码描述	err_code_des	否	String(128)	商户号信息有误，请检查修改后重试	结果信息描述

示例：

1<xml>
2<return_code><![CDATA[FAIL]]></return_code>
3<return_msg><![CDATA[INVALID_REQUEST]]></return_msg>
4</xml>

以下字段在return_code为SUCCESS的时候有返回

字段名	变量名	必填	类型	示例值	描述
处理结果	result_code	是	String(32)	FAIL	SUCCESS/FAIL
处理信息	result_msg	是	String(32)	参数错误	结果信息描述。处理成功，错误原因提示等
错误代码	err_code	否	String(32)	INVALID_REQUEST	错误代码
错误代码描述	err_code_des	否	String(128)	商户号信息有误，请检查修改后重试	结果信息描述
违规记录数据	violation_records	否	String(1024)	{"total_size":1,"violation_records":[{"company_name":"ABC公司","handle_method":"刷单欺诈,整改限期 2天","handle_state":"超时未处理","illegal_type":"其他","punish_time":"2018-07-24 20:12:25","sub_mch_id":"1900012891"}]}	json格式。 total_size：记录总数 violation_records： company_name：公司名称 handle_method：处理方式 handle_state：处理状态 punish_time：处罚时间 sub_mch_id：违规子商户号

当violation_records_format为csv时响应包格式如下：

第一行展示总记录数，第二行开始展示每一条记录。
每行记录，csv格式显示每列数据，依次为“处罚时间”，“商户号”， “公司名称”， “处理方式”， “处理状态”，“最后处理时间”（注意：这个字段只有在状态为待处理时有返回）
每列记录，以`开始，即标准键盘1左边键的字符

Total: 30
`2017-06-27 19:06:41,`1373027702,`ABC公司,`刷单欺诈,整改限期 2天,`已处理
`2017-06-25 16:43:01,`1373027702,`ABC公司,`其他,整改限期 1天,已处理
`2017-06-27 19:06:41,`1373027702,`ABC公司,`刷单欺诈,整改限期 2天,`已处理
`2017-06-25 19:06:41,`1373027702,`ABC公司,`诱导支付,整改限期 2天,`超时未处理
`2017-06-25 19:06:41,`1373027702,`ABC公司,`跨类目（涉嫌资质）,整改限期 2天,`已处理
`2017-06-25 19:06:41,`1373027702,`ABC公司,`跨类目（涉嫌资质）,整改限期 2天,`已处理
`2017-06-25 19:06:41,`1373027702,`ABC公司,`跨类目（涉嫌资质）,整改限期 2天,`已处理

当violation_records为Json格式数据时，记录内容类似于：

1{
2    "total_size" : 40,
3    "violation_records" : [
4        {
5            "punish_time":"2017-06-27 19:06:41",
6            "sub_mch_id": 1234,
7            "company_name": "ABC公司",
8            "illegal_type": "刷单欺诈", 
9            "handle_method":"整改",
10            "handle_state":"已处理",
11            "deadline":"2017-07-27 23:59:59"                //待处理状态时才会有这个字段
12        },
13        {
14            "punish_time":"2017-06-27 20:16:01",
15            "sub_mch_id": 1234,
16            "company_name": "ABC公司",
17            "illegal_type": "其他", 
18            "handle_method":"整改 限期2天",
19            "handle_state":"已处理"                         //无deadline字段
20        },
21        {...},                                             //后续数据类似，不再展开
22        {...},
23        {...},
24        ... ...
25    ]
26}

错误码

错误码	名称	描述	解决方案
SYSTEM_ERROR	系统错误	微信支付内部错误	重试或反馈
AUTH_ERROR	权限错误	当前用户无权访问	开通权限后访问
PARAM_ERROR	参数错误	必需参数没有填写或非法	请对照上述参数列表填写
SIGN_ERROR	签名错误	验签失败	核对签名
CERT_ERROR	证书错误	api证书验证失败	核对证书
INPUT_FORMAT_ERROR	输入数据格式错误	xml格式非法	校验xml格式

文档是否有帮助

更多支持

开发文档(商户)开发文档(V2版)开发者社区微信开放平台微信公众平台腾讯客服