微信會員卡-創建會員卡接口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就是九折。

 

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