最新更新时间：2020.05.12 版本说明
商户通过调用本接口向用户发放消费卡，用户领到卡的同时会领取到一批代金券，消费卡会自动放入卡包中。
• 调用该接口前，需要在微信支付商户平台创建“消费卡”，获得card_id。
• 此功能仅向指定邀约商户开放，如有需要请联系微信支付运营经理。
适用对象：直连商户
请求URL：https://api.mch.weixin.qq.com/v3/marketing/busifavor/coupons/{card_id}/send
请求方式：POST
path指该参数为路径参数
query指该参数需在请求URL传参
body指该参数需在请求JSON传参
| 参数名 | 变量 | 类型[长度限制] | 必填 | 描述 |
|---|---|---|---|---|
| 消费卡ID | card_id | string[1,28] | 是 | path
消费卡ID，即card_id。card_id获取方法请参见《接入前准备》配置应用中的创建消费卡。 示例值：pIJMr5MMiIkO_93VtPyIiEk2DZ4w |
| 消费卡归属appid | appid | string[1,18] | 是 | body 消费卡card_id 归属appid，需与api调用方商户号有M-A绑定关系，需和创建消费卡信息中填入的归属appid一致。入参中的用户openid也需用此appid生成。 示例值：wxc0b84a53ed8e8d29 |
| 用户openid | openid | string[1,28] | 是 | body 待发卡用户的openid，需为消费卡归属appid生成的openid。 示例值：obLatjhnqgy2syxrXVM3MJirbkdI |
| 商户单据号 | out_request_no | string[1,32] | 是 | body 商户此次发放凭据号。推荐使用大小写字母和数字，不同添加请求发放凭据号不同，商户侧需保证同一发券请求的out_request_no和send_time的唯一性。 示例值：oTYhjfdsahnssddj_0136 |
| 请求发卡时间 | send_time | string[1,32] | 是 | body 单次请求发卡时间，消费卡在商户系统的实际发放时间，为东八区标准时间（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"
}
| 参数名 | 变量 | 类型[长度限制] | 必填 | 描述 |
|---|---|---|---|---|
| 消费卡code | card_code | string[1,15] | 是 | 发卡成功后，每个用户在每个card_id下会分配一个唯一code。 示例值：198555211279 |
{
"card_code" : "198555211279"
} | 状态码 | 错误码 | 描述 | 解决方案 |
|---|---|---|---|
| 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状态失效，请核实后重试 |