微信会员卡-创建会员卡接口post参数字段说明

任务需要创建微信会员卡功能,在此我只对会员post参数做介绍,比官方详细点点

{
    "card": {
        "card_type": "MEMBER_CARD",
        "member_card": {
            "background_pic_url": "https://mmbiz.qlogo.cn/mmbiz/",
            "base_info": {
                "logo_url": "http://mmbiz.qpic.cn/mmbiz/iaL1LJM1mF9aRKPZ/0",
                "brand_name": "景优科技",
                "code_type": "CODE_TYPE_TEXT",
                "title": "景优科技会员卡",
                "color": "Color01",
                "notice": "使用时向服务员出示此券",
                "service_phone": "020-88888888",
                "description": "不可与其他优惠同享",
                "date_info": {
                    "type": "DATE_TYPE_PERMANENT"
                },
                "sku": {
                    "quantity": 50000000
                },
                "get_limit": 1,
                "use_custom_code": false,
                "can_give_friend": false,
                "custom_url_name": "腾讯qq网址",
                "custom_url": "http://weixin.qq.com",
                "custom_url_sub_title": "6个汉字tips",
                "need_push_on_view": true
            },
            "advanced_info": {
                "use_condition": {
                    "accept_category": "鞋类",
                    "reject_category": "阿迪达斯",
                    "can_use_with_other_discount": true
                },
                "abstract": {
                    "abstract": "微信餐厅推出多种新季菜品,期待您的光临",
                    "icon_url_list": [
                        "http://mmbiz.qpic.cn/mmbiz/p98FjXy8LacgHxp3sJ3vn97bGLz0ib0Sfz1bjiaoOYA027iasqSG0sj   piby4vce3AtaPu6cIhBHkt6IjlkY9YnDsfw/0"
                    ]
                },
                "text_image_list": [
                    {
                        "image_url": "http://mmbiz.qpic.cn/mmbiz/p98FjXy8LacgHxp3sJ3vn97bGLz0ib0Sfz1bjiaoOYA027iasqSG0sjpiby4vce3AtaPu6cIhBHkt6IjlkY9YnDsfw/0",
                        "text": "此菜品精选食材,以独特的烹饪方法,最大程度地刺激食 客的味蕾"
                    },
                    {
                        "image_url": "http://mmbiz.qpic.cn/mmbiz/p98FjXy8LacgHxp3sJ3vn97bGLz0ib0Sfz1bjiaoOYA027iasqSG0sj piby4vce3AtaPu6cIhBHkt6IjlkY9YnDsfw/0",
                        "text": "此菜品迎合大众口味,老少皆宜,营养均衡"
                    }
                ],
                "time_limit": [
                    {
                        "type": "MONDAY",
                        "begin_hour": 0,
                        "end_hour": 10,
                        "begin_minute": 10,
                        "end_minute": 59
                    },
                    {
                        "type": "HOLIDAY"
                    }
                ],
                "business_service": [
                    "BIZ_SERVICE_FREE_WIFI",
                    "BIZ_SERVICE_WITH_PET",
                    "BIZ_SERVICE_FREE_PARK",
                    "BIZ_SERVICE_DELIVER"
                ]
            },
            "supply_bonus": false,
            "supply_balance": false,
            "prerogative": "test_prerogative",
            "auto_activate": true,
            "custom_field1": {
                "name_type": "FIELD_NAME_TYPE_LEVEL",
                "url": "http://www.qq.com"
            },
            "activate_url": "http://www.qq.com",
            "custom_cell1": {
                "name": "使用入口2",
                "tips": "激活后显示",
                "url": "http://www.qq.com"
            },
            "bonus_rule": {
                "cost_money_unit": 100,
                "increase_bonus": 1,
                "max_increase_bonus": 200,
                "init_increase_bonus": 10,
                "cost_bonus_unit": 5,
                "reduce_money": 100,
                "least_money_to_use_bonus": 1000,
                "max_reduce_bonus": 50
            },
            "discount": 10
        }
    }
}

 

wecaht:会员卡字段说明:黄色的代表可以不用填写

card_type    是    string    会员卡类型。



#########卡面的基本信息字段########
base_info    是    JSON    基本的卡券数据,见下表,所有卡券类型通用。
        logo_url    是    string(128)    卡券的商户logo,建议像素为300*300。
        code_type    是    string(16)    Code展示类型, "CODE_TYPE_TEXT" 文本 "CODE_TYPE_BARCODE" 一维码  "CODE_TYPE_QRCODE" 二维码 "CODE_TYPE_ONLY_QRCODE" 仅显示二维码 "CODE_TYPE_ONLY_BARCODE" 仅显示一维码 "CODE_TYPE_NONE" 不显示任何码型
        brand_name    是    string    商户名字,字数上限为12个汉字。
        title    是    string    卡券名,字数上限为9个汉字 (建议涵盖卡券属性、服务及金额)。
        color    是    string    券颜色。按色彩规范标注填写Color010-Color100
        notice    是    string    卡券使用提醒,字数上限为16个汉字。
        service_phone    否    string(24)    客服电话
        description    是    string    卡券使用说明,字数上限为1024个汉字。 //显示在详情使用须知模块中
        sku    是    JSON    商品信息。
                  quantity    是    int    卡券库存的数量,不支持填写0,上限为100000000。
        date_info    是    JSON    使用日期,有效期的信息。
                  type    是    string    使用时间的类型 支持固定时长有效类型 固定日期有效类型 永久有效类型( DATE_TYPE_PERMANENT)
        get_limit    否    int    每人可领券的数量限制,建议会员卡每人限领一张
        use_custom _code    否    bool    是否自定义Code码(页面显示的card_id)。填写true或false,默认为false 通常自有优惠码系统的开发者选择自定义Code码,详情见 是否自定义code
        can_give _friend    否    bool    卡券是否可转赠给他人,默认为true 
        custom_url _name    否    string(15)    自定义跳转外链的入口名字。 
        custom_url    否    string(128)    自定义跳转的URL。 可定义本地接口
        custom_url _sub_title    否    string(18)    显示在入口右侧的提示语。//对custom_url _name/custom_url的说明
        need_push_on _view    否    bool    填写true为用户点击进入会员卡时推送事件,默认为false。详情见 进入会员卡事件推送


prerogative    是    strin g(3072)    会员卡特权说明,限制1024汉字。####字段内容显示在详情页面
supply_bonus    是    bool    显示积分,填写true或false,如填写true,积分相关字段均为必 填 若设置为true则后续不可以被关闭。
supply_balance    是    bool    是否支持储值,填写true或false。如填写true,储值相关字段均为必 填 若设置为true则后续不可以被关闭。该字段须开通储值功能后方可使用, 详情见: 获取特殊权限
activate_url    否    string(128)    激活会员卡的url。
auto_activate    否    bool    设置为true时用户领取会员卡后系统自动将其激活,无需调用激活接口,详情见 自动激活 。
custom_field1 /2/3   否    JSON结构    自定义会员信息类目,会员卡激活后显示,包含name_type (name) 和url字段 ****显示在卡面的积分/优惠券/等级等信息....
        name_type    否    string(24)    会员信息类目半自定义名称,当开发者变更这类类目信息的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    否    string(128)    点击类目跳转外链url ****可以自定义查看各种信息的接口路径
custom_cell1    否    JSON结构    自定义会员信息类目,会员卡激活后显示。 ******自定义单元
        name    是    string(15)    入口名称。
        tips    是    string(18)    入口右侧提示语,6个汉字内。
        url        是    string(128)    入口跳转链接。
  


     
##########会员卡详情字段#############        
advanced_info    否    JSON结构    创建优惠券特有的高级字段      卡卷或者会员卡高级信息字段  会员卡详情字段    
        *****设置这三个参数是的在会员详情使用说明是自动配置--此卡优惠不参与其他优惠******
        use_condition    否    JSON结构    使用门槛(条件)字段,若不填写使用条件则在券面拼写 :无最低消费限制,全场通用,不限品类;并在使用说明显示: 可与其他优惠共享
                "accept_category": "鞋类",
               "reject_category": "阿迪达斯",
               "can_use_with_other_discount": true 
        abstract    否    JSON结构    封面摘要结构体名称   //配置此字段可以设计封面显示的内容
               abstract    否    string(24 )    封面摘要简介。
               icon_url_list    否    string(128 )    封面图片列表,仅支持填入一 个封面图片链接, 上传图片接口 上传获取图片获得链接,填写 非CDN链接会报错,并在此填入。 建议图片尺寸像素850*350
        text_image_list    否    JSON结构    图文列表,显示在详情内页 ,优惠券券开发者须至少传入 一组图文列表
               image_url    否    string(128 )    图片链接,必须调用 上传图片接口 上传图片获得链接,并在此填入, 否则报错
               text    否    string(512 )    图文描述   
        ******说明此会员卡使用时段*******
        time_limit    否    JSON结构    使用时段限制,包含以下字段
                type    否    string(24)    限制类型枚举值:支持填入 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    否    arry    商家服务类型: BIZ_SERVICE_DELIVER 外卖服务; BIZ_SERVICE_FREE_PARK 停车位; BIZ_SERVICE_WITH_PET 可带宠物; BIZ_SERVICE_FREE_WIFI 免费wifi, 可多选    



*******会员卡中特权说明 积分规则********
bonus_rule    否    JSON结构    积分规则 。
        cost_money_unit    否    int    消费金额。以分为单位。
        increase_bonus    否    int    对应增加的积分
        max_increase _bonus    否    int    用户单次可获取的积分上限。
        init_increase _bonus    否    int    初始设置积分
        cost_bonus_unit    否    int    每次使用N积分配合reduce_money字段。
        reduce_money    否    int    抵扣xx元,(这里以分为单位)
        least_moneyto use_bonus    否    int    抵扣条件,满xx元(这里以分为单位)可用。
        max_reduce _bonus    否    int    抵扣条件,单笔最多使用xx积分。
discount    否    int    折扣,该会员卡享受的折扣优惠,填10就是九折。

 

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章