银行特约商户违规信息查询API

应用场景

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

接口链接

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格式,详见返回参数

注:
1.商户简称长度为中文字符个数,其他均为字节数
2.参数值用XML转义或加CDATA标签用于说明数据不被XML解析器解析。
示例:

<xml>
<mch_id>123456</mch_id>
<nonce_str>5087e0xessefellkg</nonce_str>
<sign>xxxxxx</sign>
<sign_type>HMAC-SHA256</sign_type>
<begin_time>2017-07-02 0:0:0</begin_time>
<end_time>2017-07-29 23:59:59</end_time>
</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) 商户号信息有误,请检查修改后重试 结果信息描述
示例:

<xml>
<return_code><![CDATA[FAIL]]></return_code>
<return_msg><![CDATA[INVALID_REQUEST]]></return_msg>
</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格式数据时,记录内容类似于:

{
    "total_size" : 40,
    "violation_records" : [
        {
            "punish_time":"2017-06-27 19:06:41",
            "sub_mch_id": 1234,
            "company_name": "ABC公司",
            "illegal_type": "刷单欺诈", 
            "handle_method":"整改",
            "handle_state":"已处理",
            "deadline":"2017-07-27 23:59:59"                //待处理状态时才会有这个字段
        },
        {
            "punish_time":"2017-06-27 20:16:01",
            "sub_mch_id": 1234,
            "company_name": "ABC公司",
            "illegal_type": "其他", 
            "handle_method":"整改 限期2天",
            "handle_state":"已处理"                         //无deadline字段
        },
        {...},                                             //后续数据类似,不再展开
        {...},
        {...},
        ... ...
    ]
}

错误列表:

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