创建会员卡 · 开发文档

## **创建会员卡接口** 支持开发者调用该接口创建会员卡，并获取card\_id，用于投放。调用该接口前，请开发者详读创建卡券接口部分[上传图片接口](http://mp.weixin.qq.com/wiki?t=resource/res_main&id=mp1451025056&token=&lang=zh_CN&anchor=2.3)、[首页](https://developers.weixin.qq.com/doc/offiaccount/Getting_Started/Overview)部分，快速录入会员卡卡面必要信息 ~~~[api] post:https://test.yunsoyi.cn/api/customer/user/userCreateMemberCard *store_id#门店id *terminal_type#创建类型(weChat-微信；aliPay-支付宝) *logo_url#券的商户logo，建议像素为300*300 *brand_name#商户名字,字数上限为12个汉字 *code_type#Code展示类型("CODE_TYPE_TEXT" 文本 "CODE_TYPE_BARCODE" 一维码 "CODE_TYPE_QRCODE" 二维码 "CODE_TYPE_ONLY_QRCODE" 仅显示二维码 "CODE_TYPE_ONLY_BARCODE" 仅显示一维码 "CODE_TYPE_NONE" 不显示任何码型 ) *title#卡券名，字数上限为9个汉字 (建议涵盖卡券属性、服务及金额) *color#券颜色。按色彩规范标注填写Color010-Color100 *notice#卡券使用提醒，字数上限为16个汉字 *description#卡券使用说明，字数上限为1024个汉字 *type#使用时间的类型,支持:固定时长有效类型(DATE_TYPE_FIX_TERM); 固定日期有效类型(DATE_TYPE_FIX_TIME_RANGE);永久有效类型(DATE_TYPE_PERMANENT) *int:quantity#卡券库存的数量，不支持填写0，上限为100000000 *int:supply_bonus#是否显示积分(1-开启,0-关闭;积分相关字段均为必填;若开启则后续不可以被关闭) *int:supply_balance#是否支持储值(0-不支持;1-支持;若支持，则储值相关字段均为必填；若开启支持则后续不可以被关闭。该字段须开通储值功能后方可使用) *prerogative#会员卡特权说明,限制1024汉字 background_pic_url#商家自定义会员卡背景图，须先调用上传图片接口将背景图上传至CDN，否则报错，卡面设计请遵循微信会员卡自定义背景设计规范 service_phone#客服电话 int:get_limit#每人可领券的数量限制，建议会员卡每人限领一张 location_id_list_lon#门店位置经度。调用 POI门店管理接口获取门店位置ID location_id_list_lat#门店位置纬度。调用 POI门店管理接口获取门店位置ID custom_url_name#自定义跳转外链的入口名字 custom_url#自定义跳转的URL custom_url_sub_title#显示在入口右侧的提示语 promotion_url_name#营销场景的自定义入口名称 promotion_url#入口跳转外链的地址链接 accept_category#指定可用的商品类目，仅用于代金券类型，填入后将在券面拼写适用于xxx reject_category#指定不可用的商品类目，仅用于代金券类型，填入后将在券面拼写不适用于xxxx int:can_use_with_other_discount#不可以与其他类型共享门槛，0时系统将在使用须知里拼写“不可与其他优惠共享”，填写1时系统将在使用须知里拼写“可与其他优惠共享”，默认为1 abstract#封面摘要简介,8个汉子以内 icon_url_list#封面图片列表，仅支持填入一个封面图片链接，上传图片接口上传获取图片获得链接，填写非CDN链接会报错，并在此填入。建议图片尺寸像素850*350 json:text_image_list={"image_url": "http://mmbiz.qpic.cn/mmbiz/p98FjXy8LacgHxp3sJ3vn97bGLz0ib0Sfz1bjiaoOYA027iasqSG0sjpiby4vce3AtaPu6cIhBHkt6IjlkY9YnDsfw/0","text": "此菜品精选食材，以独特的烹饪方法，最大程度地刺激食客的味蕾"}#JSON结构，图文列表，显示在详情内页，优惠券券开发者须至少传入一组图文列表(image_url图片链接，必须调用上传图片接口上传图片获得链接，并在此填入，否则报错;text图文描述) json:time_limit={"type": "MONDAY","begin_hour":0,"end_hour":10,"begin_minute":10, "end_minute":59}#JSON结构使用时段限制，包含以下字段:type限制类型枚举值：支持填入 MONDAY 周一 TUESDAY 周二 WEDNESDAY 周三 THURSDAY 周四 FRIDAY 周五 SATURDAY 周六 SUNDAY 周日此处只控制显示，不控制实际使用逻辑，不填默认不显示;begin_hour,int,当前type类型下的起始时间（小时），如当前结构体内填写了MONDAY，此处填写了10，则此处表示周一 10:00可用;begin_minute,int,当前type类型下的起始时间（分钟），如当前结构体内填写了MONDAY， begin_hour填写10，此处填写了59，则此处表示周一 10:59可用;end_hour,int,当前type类型下的结束时间（小时），如当前结构体内填写了MONDAY，此处填写了20，则此处表示周一 10:00-20:00可用;end_minute,否,int,当前type类型下的结束时间（分钟），如当前结构体内填写了MONDAY， begin_hour填写10，此处填写了59，则此处表示周一 10:59-00:59可用 business_service=BIZ_SERVICE_FREE_WIFI,BIZ_SERVICE_WITH_PET,BIZ_SERVICE_FREE_PARK,BIZ_SERVICE_DELIVER#商家服务类型： BIZ_SERVICE_DELIVER 外卖服务； BIZ_SERVICE_FREE_PARK 停车位； BIZ_SERVICE_WITH_PET 可带宠物； BIZ_SERVICE_FREE_WIFI 免费wifi,多个用,隔开 int:auto_activate=1#设置为1时用户领取会员卡后系统自动将其激活，无需调用激活接口，详情见自动激活 name_type#会员信息类目半自定义名称，当开发者变更这类类目信息的value值时可以选择触发系统模板消息通知用户。 FIELD_NAME_TYPE_LEVEL 等级 FIELD_NAME_TYPE_COUPON 优惠券 FIELD_NAME_TYPE_STAMP 印花 FIELD_NAME_TYPE_DISCOUNT 折扣 FIELD_NAME_TYPE_ACHIEVEMEN 成就 FIELD_NAME_TYPE_MILEAGE 里程 FIELD_NAME_TYPE_SET_POINTS 集点 FIELD_NAME_TYPE_TIMS 次数 url#会员信息类目自定义名称，当开发者变更这类类目信息的value值时,不会触发系统模板消息通知用户 activate_url#激活会员卡的url json:custom_cell1#json格式，自定义会员信息类目，会员卡激活后显示({"name": "使用入口2","tips": "激活后显示","url": "http://www.qq.com"} ),name,是,string(15),入口名称。tips,是,string(18),入口右侧提示语，6个汉字内。url,是,string(128),入口跳转链接 int:cost_money_unit#消费金额,以分为单位 int:increase_bonus#对应增加的积分 int:max_increase_bonus#用户单次可获取的积分上限 int:init_increase_bonus#初始设置积分 int:cost_bonus_unit#每使用X积分 int:reduce_money#抵扣xx元，（这里以分为单位） int:least_money_to_use_bonus#抵扣条件，满xx元（这里以分为单位）可用 int:max_reduce_bonus#抵扣条件，单笔最多使用xx积分 int:discount#折扣，该会员卡享受的折扣优惠,填10就是九折 <<< success { "status": 1, "message": "ok", "data": [ "errcode":0, "errmsg":"ok", "card_id":"pxHuEuNhCy6ZXQ0NuzZS2ZRl3YpU" ] } <<< error ~~~