查询商家券事件通知地址API

最新更新时间:2019.12.20 版本说明


通过调用此接口可查询设置的通知URL。

注意:

• 仅可以查询由请求商户号设置的商家券通知url

接口说明

适用对象:直连商户 服务商 渠道商

请求URL:https://api.mch.weixin.qq.com/v3/marketing/busifavor/callbacks

请求方式:GET

接口规则:https://pay.weixin.qq.com/wiki/doc/apiv3/wechatpay/wechatpay-1.shtml


path 指该参数为路径参数

query 指该参数需在请求URL传参

body 指该参数需在请求JSON传参


请求参数

参数名 变量 类型[长度限制] 必填 描述
商户号 mchid string[8,15] query 微信支付商户的商户号,由微信支付生成并下发,不填默认查询调用方商户的通知URL。
示例值:10000098

请求示例


https://api.mch.weixin.qq.com/v3/marketing/busifavor/callbacks?mchid=10000098
    
{
JAVA示例代码
}
    

返回参数

参数名 变量 类型[长度限制] 必填 描述
通知URL地址 notify_url string[10,256] 商户提供的用于接收商家券事件通知的url地址,必须支持https。
示例值:https://pay.weixin.qq.com
商户号 mchid string[8,15] 微信支付商户的商户号,由微信支付生成并下发。
示例值:10000098

返回示例



{
  "mchid": "10000098",
  "notify_url": "https://pay.weixin.qq.com"
}

    http://2323weixin.qq.com
                                

错误码公共错误码

状态码 错误码 描述 解决方案
400 PARAM_ERROR 参数错误 查看具体错误信息,调整参数
400 SYSTEM_ERROR 系统错误 请使用相同参数稍后重新调用
400 RESOURCE_ALREADY_EXISTS 批次已存在 查看out_request_no字段是否重复使用
券已被其他订单核销 请通过查询券API确认券是否已被其他订单核销
404 RESOURCE_NOT_EXISTS 查询的资源不存在 请检查查询资源的对应id是否填写正确
403 NOAUTH 无权限 查看具体错误信息,确认是否有权限
400 APPID_MCHID_NOT_MATCH appid与请求方商户无关联关系 appid与请求方商户不匹配,请确认appid与请求方商户是否有关联关系
400 MCH_NOT_EXISTS 商户号不存在 请确认传入的商户号是否正确
404 USER_NOT_EXISTS openid不正确 请确认传入的openid是否正确
500 SYSTEM_ERROR 系统失败 多为网络超时引起,重试
429 FREQUENCY_LIMITED 频率限制 调用太频繁,请降低调用接口频率
403 RULELIMIT 券不在有效期 请确认券是否能在当前时间核销
400 INVALID_REQUEST 发券模式不合法 请更换支持预上传code的批次后重试
上传的自定义code已达上限 请更换一个新的批次后重试

版本说明

关闭
V1.0
2019年12月20日
1. 查询商家券事件通知地址接口上线

技术咨询

文档反馈