新增活动发券商户号API

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


商户创建活动后,可以通过该接口增加支付有礼的发券商户号,用于管理活动。

接口说明

适用对象:微信支付商户 服务商 渠道商

请求URL:https://api.mch.weixin.qq.com/v3/marketing/paygiftactivity/activities/{activity_id}/merchants/add

请求方式:POST

接口规则:https://wechatpay-api.gitbook.io/wechatpay-api-v3


path指该参数为路径参数

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

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


请求参数

参数名 变量 类型[长度限制] 必填 描述
活动id activity_id string[1,20] path活动id
示例值:10028001
发券商户号 merchant_id_list array body 新增到活动中的发券商户号列表
特殊规则:最小字符长度为8,最大为15
条目个数限制:[1,500]
示例值:10000022,10000023
商户请求单号 add_request_no string[1,128] body 商户创建批次凭据号(格式:商户id+日期+流水号),商户侧需保持唯一性,可包含英文字母,数字,|,_,*,-等内容,不允许出现其他不合法符号。
示例值:100002322019090134234sfdf

请求示例


{
  "merchant_id_list" : [ "100123456", "100123457" ],
  "add_request_no" : "100002322019090134234sfdf"
}
    
{
JAVA示例代码
}
    

返回参数

参数名 变量 类型[长度限制] 必填 描述
活动id activity_id string[1,20] 活动id
示例值:126002309
+ 校验失败的发券商户号 invalid_merchant_id_list array 未通过规则校验的发券商户号列表
参数名 变量 类型[长度限制] 必填 描述
商户号 mchid string[8,15] 商户号
示例值:1001234567
无效原因 invalid_reason string[1,512] 活动参与商户校验失败的原因
示例值:商户与活动创建方不具备父子关系
添加时间 add_time string[1,32] 成功添加发券商户号的时间,遵循rfc3339标准格式,格式为YYYY-MM-DDTHH:mm:ss+TIMEZONE,YYYY-MM-DD表示年月日,T出现在字符串中,表示time元素的开头,HH:mm:ss表示时分秒,TIMEZONE表示时区(+08:00表示东八区时间,领先UTC 8小时,即北京时间)。例如:2015-05-20T13:29:35+08:00表示,北京时间2015年5月20日13点29分35秒。
示例值:2015-05-20T13:29:35+08:00

返回示例


{
  "activity_id" : "1001234567",
  "invalid_merchant_id_list" : [ {
    "mchid" : "1001234567",
    "invalid_reason" : "商户与活动创建方不具备父子关系"
  }, {
    "mchid" : "1001234567",
    "invalid_reason" : "商户与活动创建方不具备父子关系"
  } ],
  "add_time" : "2015-05-20T13:29:35+08:00"
}

    http://2323weixin.qq.com
                                

错误码公共错误码

状态码 错误码 描述 解决方案
500 SYSTEM_ERROR 系统错误 请使用相同参数稍后重新调用
400 PARAM_ERROR 参数错误 根据错误提示,传入正确参数
403 NO_AUTH 商户未被授权 登录商户平台核对,传入正确信息
429 FREQUENCY_LIMITED 频率超限 请求量不要超过接口调用频率限制
400 INVALID_REQUEST 请求参数符合参数格式,但不符合业务规则 根据错误提示,传入符合业务规则的参数
400 MCH_NOT_EXISTS 商户号不存在 请确认发券商户号信息是否有误
404 RESOURCE_NOT_EXISTS 资源不存在或无可用 请确认资源均存在且可用
400 APPID_MCHID_NOT_MATCH appid与mchid不匹配 请确认appid是否正确填写
401 SIGN_ERROR 签名错误或签名信息不完整 登录商户平台核对,传入正确信息
400 PARAM_ERROR 创建活动参数错误,请联系技术支持 根据错误提示,传入正确参数
400 INVALID_REQUEST 查询活动详情结果为空,请确认活动id是否正确 请确认活动id是否正确
403 RULELIMIT 上一次修改还未完成,请稍后重试 请稍后重试
403 RULELIMIT 活动不在运行中,不允许再进行修改 活动不在运行中,不允许再进行修改
403 RULELIMIT 所有的曝光商户号均校验失败,请再次检查 发券商户号校验失败,请核实是否满足同品牌等规则
400 INVALID_REQUEST 发券商户号校验失败,请核实是否满足同品牌等规则 发券商户号校验失败,请核实是否满足同品牌等规则
400 INVALID_REQUEST 发券商户号非奖品的同品牌商户号 发券商户号校验失败,请核实是否满足同品牌等规则
400 INVALID_REQUEST 券归属商户或发券商户非同品牌 发券商户号校验失败,请核实是否满足同品牌等规则
400 INVALID_REQUEST 创建方商户与发券商户非同品牌 发券商户号校验失败,请核实是否满足同品牌等规则
400 PARAM_ERROR 活动曝光商户的同品牌商户中需要至少存在一个与创建方商户具备父子关系 发券商户号校验失败,请核实是否满足同品牌等规则
403 RULELIMIT 并发修改,请稍后再试 请稍后重试

版本说明

关闭
V1.0
2020年06月09日
1. 新增活动发券商户号API接口上线

技术咨询

反馈有奖