创建商户违规通知回调地址

更新时间:2023.05.09

从业机构/服务商/渠道商调用该接口设置商户违规通知回调地址,开启违规通知,当子商户被处罚或拦截时,微信支付会通过回调地址通知从业机构/服务商/渠道商。

# 接口说明

支持商户:
【普通服务商】【从业机构(银行)】【从业机构(支付机构)】【渠道商】
请求方式:
【POST】/v3/merchant-risk-manage/violation-notifications
请求域名:
【主域名】
https://api.mch.weixin.qq.com
使用该域名将访问就近的接入点
【备域名】
https://api2.mch.weixin.qq.com
使用该域名将访问异地的接入点 ,指引点击查看

# 请求参数

    Header HTTP头参数
  • Authorization 必填 string
    请参考 签名认证 生成认证信息
  • Accept 必填 string
    请设置为 application/json
  • Content-Type 必填 string
    请设置为 application/json
    Body 包体参数
  • notify_url 选填 string(256)
    【通知地址】 异步接收微信支付处罚/拦截子商户通知的回调地址,通知url必须为外网可访问的url,不能携带参数。 公网域名必须为https,如果是走专线接入,使用专线NAT IP或者私有回调域名可使用http

请求示例

POST

# 应答参数

    200OK
  • notify_url 选填 string(256)
    【通知地址】 异步接收微信支付处罚/拦截子商户通知的回调地址,通知url必须为外网可访问的url,不能携带参数。 公网域名必须为https,如果是走专线接入,使用专线NAT IP或者私有回调域名可使用http

应答示例

200 OK

# 错误码

# 公共错误码

状态码 错误码 描述 解决方案
400 PARAM_ERROR 参数错误 请根据错误提示正确传入参数
400 INVALID_REQUEST HTTP 请求不符合微信支付 APIv3 接口规则 请参阅 接口规则
401 SIGN_ERROR 验证不通过 请参阅 签名常见问题
500 SYSTEM_ERROR 系统异常,请稍后重试 请稍后重试

# 业务错误码

状态码 错误码 描述 解决方案
400 INVALID_REQUEST 请求参数符合参数格式,但不符合业务规则 根据错误提示,传入正确参数
403 NO_AUTH 商户信息不合法 登录商户平台核对,传入正确信息
409 ALREADY_EXISTS 商户已经设置过回调地址 请使用查询API确认回调地址是否正确,若需要修改请使用更新API
429 FREQUENCY_LIMITED 频率超限 请求量不要超过接口调用频率限制
500 SYSTEM_ERROR 系统错误 5开头的状态码都为系统问题,请使用相同参数 稍后重新调用
反馈
咨询
目录