基础支付
JSAPI支付
APP支付
H5支付
Native支付
小程序支付
合单支付
付款码支付
经营能力
微信支付分(免确认模式)
微信支付分(免确认预授权模式)
微信支付分(需确认模式)
微信支付分(公共API)
微信先享卡
支付即服务
行业方案
智慧商圈
营销工具
代金券
商家券
委托营销
消费卡
支付有礼
小程序发券插件
H5发券
图片上传(营销专用)
现金红包
资金应用
付款
分账
风险合规
消费者投诉2.0
其他能力
清关报关
图片上传
视频上传

发放消费卡API

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


商户通过调用本接口向用户发放消费卡,用户领到卡的同时会领取到一批代金券,消费卡会自动放入卡包中。

注意:

• 调用该接口前,需要在微信支付商户平台创建“消费卡”,获得card_id。

• 此功能仅向指定邀约商户开放,如有需要请联系微信支付运营经理。

接口说明

适用对象:直连商户

请求URL:https://api.mch.weixin.qq.com/v3/marketing/busifavor/coupons/{card_id}/send

请求方式:POST


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

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

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


请求参数

参数名 变量 类型[长度限制] 必填 描述
消费卡ID card_id string[1,28] path 消费卡ID,即card_id。card_id获取方法请参见《接入前准备》配置应用中的创建消费卡。
示例值:pIJMr5MMiIkO_93VtPyIiEk2DZ4w
消费卡归属appid appid string[1,18] query 消费卡card_id 归属appid,需与api调用方商户号有M-A绑定关系,需和创建消费卡信息中填入的归属appid一致。入参中的用户openid也需用此appid生成。
示例值:wxc0b84a53ed8e8d29
用户openid openid string[1,28] query 待发卡用户的openid,需为消费卡归属appid生成的openid。
示例值:obLatjhnqgy2syxrXVM3MJirbkdI
商户单据号 out_request_no string[1,32] query 商户此次发放凭据号。推荐使用大小写字母和数字,不同添加请求发放凭据号不同,商户侧需保证同一发券请求的out_request_no和send_time的唯一性。
示例值:oTYhjfdsahnssddj_0136
请求发卡时间 send_time string[1,32] query 单次请求发卡时间,消费卡在商户系统的实际发放时间,为东八区标准时间(UTC+8)。商户需保证同一次请求的out_request_no和send_time唯一。由于系统限制,暂不支持传入早于当前时间24小时以上的时间进行发券请求。
示例值:2019-12-31T13:29:35.120+08:00

请求示例


{
  "send_time": "2019-12-31T13:29:35.120+08:00",
  "openid": "obLatjhnqgy2syxrXVM3MJirbkdI",
  "appid": "wxc0b84a53ed8e8d29",
  "out_request_no": "oTYhjfdsahnssddj_0136"
}
    
{
JAVA示例代码
}
    

返回参数

参数名 变量 类型[长度限制] 必填 描述
消费卡code card_code string[1,15] 发卡成功后,每个用户在每个card_id下会分配一个唯一code。
示例值:198555211279

返回示例


{
  "card_code" : "198555211279"
}                               

    http://2323weixin.qq.com
                                

错误码公共错误码

状态码 错误码 描述 解决方案
400 PARAM_ERROR 请求参数错误 请按照API文档检查并更换参数后重试
400 PARAM_ERROR 发券时间早于当前时间24h 请更换当前时间24h内的send_time
500 SYSTEM_ERROR 系统失败 消费卡插入用户卡包失败,请稍后使用原订单号重试
400 INVALID_REQUEST 用户领卡数目超过限额 用户已领取消费卡数目超过card_id“用户可领个数”限制,请更换其他用户
400 INVALID_REQUEST 用户或该用户的其他微信号领取消费卡数目已超过当前活动限制 用户本人或同一用户的其他微信号(绑定了同一个实名用户银行卡的微信)已领取过消费卡,请更换其他用户发券
400 INVALID_REQUEST 商户未创建过该消费卡活动 商户id未开通消费卡发放权限,或card_id与商户id不匹配,请确认后重试
400 INVALID_REQUEST 消费卡库存已发完 消费卡card_id发放总个数已发完,请更换其他card_id发券
400 INVALID_REQUEST 消费卡card_id已过期 消费卡card_id已过期,请更换后重试
400 INVALID_REQUEST 消费卡card_id状态失效 消费卡card_id状态失效,请核实后重试


文档调研

技术咨询

反馈有奖