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

应用场景

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

接口链接

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

是否需要证书

请求参数

字段名 变量名 必填 类型 示例值 描述
商户号 mch_id String(32) 1230000109 银行服务商的商户号

随机字符串

nonce_str

String(32)

5K8264ILTKCH16CQ2502SI8ZNMTM67VS

随机字符串,不长于32位

签名 sign String(32) C380BEC2BFD727A4B6845133519F3AD6 通过签名算法计算得出的签名值,详见签名生成算法
签名类型 sign_type String(32) HMAC-SHA256 签名类型
开始时间 begin_time String(32) 2017-07-29 格式:yyyy-mm-dd HH:MM:SS, 支持只传日期,不带时间
结束时间 end_time String(32) 2017-07-29 格式:yyyy-mm-dd HH:MM:SS, 支持只传日期,不带时间
注:
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) 5K8264ILTKCH16CQ2502SI8ZNMTM67VS SUCCESS/FAIL
处理信息 result_msg String(32) C380BEC2BFD727A4B6845133519F3AD6 结果信息描述。处理成功,错误原因提示等
错误代码 err_code String(32) INVALID_REQUEST 错误代码
错误代码描述 err_code_des String(128) 商户号信息有误,请检查修改后重试 结果信息描述
签名 sign String(32) 5K8264ILTKCH16CQ2502SI8ZNMTM67VS 微信返回的签名,详见签名生成算法
随机字符串 nonce_str String(32) 5K8264ILTKCH16CQ2502SI8ZNMTM67VS 微信返回的随机字符串

正常响应包格式如下:
• 第一行展示总记录数,第二行开始展示每一条记录。
• 每行记录,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天, 移交微信处理,`已处理
`2017-06-25 16:43:01,`1355146002,`ABC公司,`其他,整改 限期 1天,`已处理
`2017-06-25 16:43:01,`1355146002,`ABC公司,`其他,整改 限期 1天,`已处理

错误列表:

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