微信优惠券 朋友的券专区

接口上传获取图片获得链接，填写非CDN链接会报错，并在此填入。建议图片尺寸像素850*350是text_image_list图文列表，显示在详情内页，优惠券券开发者须至少传入一组图文列表是image_url图片链接，必须调用上传图片接口上传图片获得链接，并在此填入，否则报错是text图文描述，5000字以内是business_service商家服务类型：BIZ_SERVICE_DELIVER 外卖服务；BIZ_SERVICE_FREE_PARK 停车位；BIZ_SERVICE_WITH_PET 可带宠物；BIZ_SERVICE_FREE_WIFI 免费wifi，可多选否time_limit使用时段限制否type限制类型枚举值：支持填入MONDAY 周一 TUESDAY 周二 WEDNESDAY 周三 THURSDAY 周四 FRIDAY 周五 SATURDAY 周六 SUNDAY 周日 HOLIDAY 假期通用 此处只控制显示，不控制实际使用逻辑，不填默认不显示否begin_hour当前type类型下的起始时间（小时），如当前结构体内填写了MONDAY，此处填写了10，则此处表示周一 10:00可用否begin_minute当前type类型下的起始时间（分钟），如当前结构体内填写了MONDAY，begin_hour填写10，此处填写了59，则此处表示周一 10:59可用否end_hour当前type类型下的结束时间（小时），如当前结构体内填写了MONDAY，此处填写了20，则此处表示周一 10:00-20:00可用否end_minute当前type类型下的结束时间（分钟），如当前结构体内填写了MONDAY，begin_hour填写10，此处填写了59，则此处表示周一 10:59-00:59可用否consume_share_self_num核销后送券的数量，可设置核销后送本卡券的数量，限制传入1张，与consume_share_card_list字段互斥否consume_share_card_list核销后赠送其他卡券的列表，与consume_share_self_num字段互斥否card_id核销后赠送的其他卡券card_id，目前仅支持填入一个共享券card_id，此处必须填入共享券否num核销后赠送的该card_id数目，目前仅支持填1否share_friends是否支持分享给朋友使用，填写true优惠券才可被共享是注意事项：1.门槛字段用于拼接标题以及券面的优惠说明，请开发者务必按照要求选择填写，以免造成不必要的麻烦。 2.填入时间限制字段（time_limit）,只控制显示，不控制实际使用逻辑，不填默认不显示。返回数据{  "errcode": 0,  "errmsg": "ok",  "card_id": "pbLatjtQrAGz1Iaz08qB_H3NSBrc" }字段说明字段名说明错误码错误码，0为正常，40071为格式错误，请对比JSON示例排查错误errmsg错误信息card_id卡券id审核事件推送生成的卡券通过审核时，微信会把这个事件推送到开发者填写的URL。 点击查看卡券事件推送机制朋友的券支持买单同普通卡券一样，朋友的券一样支持微信快速买单，开通了微信支付的商户可以为朋友的券开通买单，便捷收银。帮助错误码错误码说明排错指引40079有效期错误须将有效期设置为90天以内40141图片url错误须使用将图片上传至CDN后获得的url41025缺少location_list创建的JSON中须填入location_list(即poi_id，门店id)42001token过期重新获取最新的token调用接口，若有多个调用源，需要统一管理token47001创建JSON结构错误针对报错信息提示的位置对比示例排查更多错误码，请见卡券全局错误码常见问题1.为什么朋友的券不能在创建的时候填入库存？朋友的券库存机制与普通券不同，开发者须先创建卡券后，到MP（商户后台）用券点充值库存，不支持在创建的时候填入库存。2.为什么朋友的券只能创建三个月时长的卡券？朋友的券不同于普通卡券，有很强的时效性和活动性，为了保证用户的券列表能常来常新，我们约定，每个商户最多只能创建时长不超过三个月（90天)的卡券。3.卡券过期了券点会退吗？若卡券过期时，card_id内尚有库存，我们会将库存折合券点退回商户的账户，周期为T+1（隔日退回）。配置库存、充值券点该部分介绍开发者怎样为card_id配置库存以及充值、管理账号的券点。接口说明创建朋友的券成功后，开发者可以通过接口为card_id配置库存，不同于普通券的是，朋友的券库存须使用券点（什么是券点？）兑换，券点分为免费券点和付费券点，免费券点由微信平台赠送产生，而付费券点由开发者充值产生。接口调用流程API列表步骤API名称用途API属性1开通券点账户接口            开通券点账户库存接口2对优惠券批价接口            获取对当前card_id充值一定量的库存所耗费的券点总额库存接口3查询券点余额接口            查询账户内券点是否可以支付本次批价的库存充值库存接口4确认兑换库存接口            确认充值库存库存接口5充值券点接口           使用微信支付充值账户内的券点充值接口6查询订单详情接口            查询某次充值订单的状态充值接口6查询流水详情接口            查询库存、券点订单的状态管理接口API详情该部分主要介绍库存、券点接口的调用方法和传递参数。开通券点账户接口本接口用于开发者为当前appid开通券点账户并获得免费券点奖励接口调用请求说明HTTP请求方式: GET https://api.weixin.qq.com/card/pay/activate?access_token=ACCESS_TOKEN返回数据示例{"errcode": 0, "errmsg": "ok", "reward": 200}返回数据示例参数名描述errcode错误码errmsg错误信息reward奖励券点数量，以元为单位，微信卡券对每一个新开通券点账户的商户奖励200个券点，点击查看券点规则什么是券点？            对优惠券批价本接口用于提前查询本次新增库存需要多少券点接口调用请求说明HTTP请求方式: POST https://api.weixin.qq.com/card/pay/getpayprice?access_token=ACCESS_TOKEN参数说明参数是否必须说明POST数据是Json数据access_token是调用接口凭证POST数据{"card_id": "pbLatjpQxxxxxxxxCEV_cLTwoB7yU", "quantity": "1"}请求参数说明参数名必填类型示例值描述card_id是string(32)pFS7Fjg8kV1IdDz01r4SQwMkuCKc需要来配置库存的card_idquantity是int100本次需要兑换的库存数目返回数据示例{    "errcode": 0,    "errmsg": "ok",    "order_id": "P9zzllX2VJ5NgiF9kFVarX7bc8r-ms_5Dy091evc2eIuxtZvZobeomE1p9Dw8v7lFBhqKM4YgrZa54uuWhf3hw7KquEOfmx5FplGKRIf7Ag5Ww-YdxP-KeT6LeJBttb1xpY0Uf7g8DNHrbUyHopolqfUqPBBLDEmB7Z-91I8",    "price": "0.2",    "free_coin": "0.2",    "pay_coin": "0"}参数名描述errcode错误码errmsg错误信息order_id本次批价的订单号，用于下面的确认充值库存接口，仅对当前订单有效且仅可以使用一次，60s内可用于兑换库存。price本次需要支付的券点总额度free_coin本次需要支