微信平臺(tái)會(huì)員卡專區(qū)（二）

管理會(huì)員卡

拉取會(huì)員信息（積分查詢）接口

接口說(shuō)明

    支持開(kāi)發(fā)者根據(jù)card_id和Code查詢會(huì)員信息,包括激活資料、積分信息以及余額等信息。

接口調(diào)用請(qǐng)求說(shuō)明

HTTP請(qǐng)求方式: POSTURL:https://api.weixin.qq.com/card/membercard/userinfo/get?access_token=TOKEN

參數(shù)說(shuō)明

POST數(shù)據(jù)

{   "card_id": "pbLatjtZ7v1BG_ZnTjbW85GYc_E8",   "code": "916679873278"}

返回?cái)?shù)據(jù)

{
    "errcode": 0,
    "errmsg": "ok",
    "openid": "obLatjjwDolFjRRd3doGIdwNqRXw",
    "nickname": "Fourier",
    "membership_number": "316510891298",
    "bonus": 460,
    "sex": "MALE",
    "user_info": {
        "common_field_list": [
            {
                "name": "USER_FORM_INFO_FLAG_MOBILE",
                "value": "15521328888"
            },
            {
                "name": "USER_FORM_INFO_FLAG_NAME",
                "value": "微信"
            }
        ],
        "custom_field_list": []
    },
    "user_card_status": "NORMAL"
}

8.2 更改會(huì)員卡信息接口

接口說(shuō)明

    支持更改會(huì)員卡卡面信息以及卡券屬性信息。

接口調(diào)用請(qǐng)求說(shuō)明

HTTP請(qǐng)求方式: POSTURL:https://api.weixin.qq.com/card/update?access_token=TOKEN

參數(shù)說(shuō)明

POST數(shù)據(jù)

{
    "card_id": "ph_gmt7cUVrlRk8swPwx7aDyF-pg",
    "member_card": {
        "background_pic_url": "https://mmbiz.qlogo.cn/mmbiz/0?wx_fmt=jpeg",
        "base_info": {
            "logo_url": "http:\/\/www.supadmin.cn\/uploads\/allimg\/120216\/1_120216214725_1.jpg",
            "color": "Color010",
            "notice": "使用時(shí)向服務(wù)員出示此券",
            "service_phone": "020-88888888",
            "description": "不可與其他優(yōu)惠同享\n如需團(tuán)購(gòu)券發(fā)票，請(qǐng)?jiān)谙M(fèi)時(shí)向商戶提出\n店內(nèi)均可使用，僅限堂食\n餐前不可打包，餐后未吃完，可打包\n本團(tuán)購(gòu)券不限人數(shù)，建議2人使用，超過(guò)建議人數(shù)須另收醬料費(fèi)5元/位\n本單謝絕自帶酒水飲料",
            "location_id_list": [
                123,
                12321,
                345345
            ]
        },
        "bonus_cleared": "aaaaaaaaaaaaaa",
        "bonus_rules": "aaaaaaaaaaaaaa",
        "prerogative": "",
        "auto_activate": true,
        //也可以填寫wx_activate"activate_url"：""
    }
}

支持修改字段： 

base_info字段：

會(huì)員卡專屬字段修改：

特別注意，以下支持更新的字段不在基本信息base_info的結(jié)構(gòu)中。

返回?cái)?shù)據(jù)說(shuō)明

數(shù)據(jù)示例：

{   "errcode":0,   "errmsg":"ok",  "send_check"：true}

開(kāi)發(fā)者注意事項(xiàng)注

1. 更改卡券的部分字段后會(huì)重新提交審核，詳情見(jiàn)字段說(shuō)明，更新成功后可通過(guò)調(diào)用查看卡券詳情接口核查更新結(jié)果；

2. 僅填入需要更新的字段，許多開(kāi)發(fā)者在調(diào)用該接口時(shí)會(huì)填入brandname等不支持修改的字段，導(dǎo)致更新不成功。

3. 調(diào)用該接口后更改卡券信息后，請(qǐng)務(wù)必調(diào)用查看卡券詳情接口驗(yàn)證是否已成功更改。

8.3 設(shè)置跟隨推薦

功能介紹

    支持開(kāi)發(fā)者在積分變動(dòng)消息底部，配置卡券或設(shè)置跳轉(zhuǎn)外鏈URL，具體形式如下圖，可以是URL也可以是一張卡券。

開(kāi)發(fā)者注意事項(xiàng)

一、支持兩種類型的跟隨推薦配置

1. 廣告語(yǔ)+URL，支持商戶配置16個(gè)漢字長(zhǎng)度的文案，及點(diǎn)擊跳轉(zhuǎn)的鏈接。

2. 推薦卡券，支持商戶配置一個(gè)本公眾號(hào)下的卡券。

二、推薦位有效期控制

1. 廣告語(yǔ)+URL類型，支持商戶根據(jù)活動(dòng)期限自定義展示時(shí)間。

2. 推薦卡券類型，由微信后臺(tái)判斷卡券的有效性，當(dāng)卡券已過(guò)期、已被領(lǐng)完、已被置為失效會(huì)自動(dòng)下架展示。

8.3.1 設(shè)置跟隨推薦接口

接口說(shuō)明

    調(diào)用更新卡券信息接口將增推薦位字段 update到已成功通過(guò)審核的卡券。 同時(shí)支持在創(chuàng)建卡券時(shí)填入相應(yīng)字段。

接口詳情

接口調(diào)用請(qǐng)求說(shuō)明

http請(qǐng)求方式: POSThttps://api.weixin.qq.com/card/update?access_token=TOKEN

參數(shù)說(shuō)明

使用消息配置卡券

{
    "card_id": "ph_gmt7cUVrlRk8swPwx7aDyF-pg",
    "member_card": {
        "modify_msg_operation": {
            "card_cell": {
                "end_time": 1452724561,
                "card_id": "p1Pj9jr90_SQRaVqYI239Ka1erkI"
            }
        }
    }
}

使用消息配置URL

{
    "card_id": "ph_gmt7cUVrlRk8swPwx7aDyF-pg",
    "member_card": {
        "modify_msg_operation": {
            "url_cell": {
                "end_time": 1452724561,
                "text": "更多優(yōu)惠",
                "url": "www.qq.com"
            }
        }
    }
}

字段說(shuō)明

返回?cái)?shù)據(jù)

{   "errcode":0,   "errmsg":"ok" }

字段說(shuō)明

8.4 設(shè)置支付即會(huì)員

8.4.1 增加支付即會(huì)員規(guī)則接口

    開(kāi)通微信支付的商戶可以設(shè)置，用戶在微信支付后自動(dòng)為用戶發(fā)送一條領(lǐng)卡消息，用戶點(diǎn)擊消息即可領(lǐng)取會(huì)員卡。   

接口說(shuō)明

    支持商戶設(shè)置支付即會(huì)員的規(guī)則，可以區(qū)分時(shí)間段和金額區(qū)間發(fā)會(huì)員卡。

接口調(diào)用請(qǐng)求說(shuō)明

HTTP請(qǐng)求方式: POST
URL:https://api.weixin.qq.com/card/paygiftmembercard/add?access_token=TOKEN

參數(shù)說(shuō)明

POST數(shù)據(jù)

{
    "card_id": "xxxxxxxxa",
    "jump_url": "mp.weixin.qq.com/wiki",
    "mchid_list": [
        "123",
        "1234",
        "12345"
    ],
    "begin_time": 146324567,
    "end_time": 147234567,
    "min_cost": 1000,
    "max_cost": 10000000,
    "is_locked": true
}

字段說(shuō)明

返回?cái)?shù)據(jù)說(shuō)明

數(shù)據(jù)示例：

{
    "errcode": 0,
    "errmsg": "ok",
    "succ_list"：[
    "134xxxxxx"
    ],
    "fail_list"：[
        {
            "mchid": "xxxxx",
            "errcode": 0,
            "errmsg": "ok",
            "occupy_appid": "wxxxxxxxxxxx"
        },
        {
            "mchid": "xxxxx",
            "errcode": 0,
            "errmsg": "ok",
            "occupy_appid": "wxxxxxxxxxxx"
        }
    ]
}

開(kāi)發(fā)者注意事項(xiàng)注

1. 會(huì)員卡領(lǐng)卡消息針對(duì)單個(gè)新用戶僅發(fā)送一次，若該用戶已經(jīng)接收或者已經(jīng)領(lǐng)取過(guò)會(huì)員卡則不會(huì)重復(fù)發(fā)送；

  2. 通過(guò)該規(guī)則設(shè)置的card_id的制券appid必須和當(dāng)前mch_id的主體appid一致，否則報(bào)錯(cuò)72001；

  3.僅支持會(huì)員卡類型的卡券，否則報(bào)錯(cuò)：72003；

  4.設(shè)置支付即會(huì)員時(shí)，須確認(rèn)調(diào)用接口的appid和當(dāng)前card_id主體一致，以及appid與mchid有綁定關(guān)系，否則報(bào)錯(cuò)：72002；

  5.須保證mchid之前沒(méi)有被其他appid設(shè)置過(guò)，否則報(bào)錯(cuò)72004；

  6.單次僅限設(shè)置100個(gè)mchid，若超過(guò)100個(gè)請(qǐng)多次調(diào)用本接口。

8.4.2 刪除支付即會(huì)員規(guī)則接口

  刪除之前已經(jīng)設(shè)置的支付即會(huì)員規(guī)則。

接口說(shuō)明

    支持商戶設(shè)置支付即會(huì)員的規(guī)則，可以區(qū)分時(shí)間段和金額區(qū)間發(fā)會(huì)員卡。

接口調(diào)用請(qǐng)求說(shuō)明

HTTP請(qǐng)求方式: POST
URL:https://api.weixin.qq.com/card/paygiftmembercard/delete?access_token=TOKEN

參數(shù)說(shuō)明

POST數(shù)據(jù)

{
    "card_id": "xxxxxxxxa",
    "mchid_list": [
        123,
        1234,
        12345
    ]
}

字段說(shuō)明

返回?cái)?shù)據(jù)說(shuō)明

數(shù)據(jù)示例：

{
    "errcode": 0,
    "errmsg": "ok",
    "succ_list"：[
        {
            "mchid": "xxxxx",
            "errcode": 0,
            "errmsg": "ok",
            "occupy_appid": "wxxxxxxxxxxx"
        },
        {
            "mchid": "xxxxx",
            "errcode": 0,
            "errmsg": "ok",
            "occupy_appid": "wxxxxxxxxxxx"
        }
    ],
    "fail_list"：[
        {
            "mchid": "xxxxx",
            "errcode": 0,
            "errmsg": "ok",
            "occupy_appid": "wxxxxxxxxxxx"
        },
        {
            "mchid": "xxxxx",
            "errcode": 0,
            "errmsg": "ok",
            "occupy_appid": "wxxxxxxxxxxx"
        }
    ]
}

8.4.3 查詢商戶號(hào)支付即會(huì)員規(guī)則接口

接口說(shuō)明

    可以查詢某個(gè)商戶號(hào)是否支持支付即會(huì)員功能

接口調(diào)用請(qǐng)求說(shuō)明

HTTP請(qǐng)求方式: POST
URL:https://api.weixin.qq.com/card/paygiftmembercard/get?access_token=TOKEN

參數(shù)說(shuō)明

POST數(shù)據(jù)

{"mchid":"xxxxxxxx"}

字段說(shuō)明

返回?cái)?shù)據(jù)說(shuō)明

數(shù)據(jù)示例：

{
    "errcode": 0,
    "errmsg": ok,
    "card_id": "xxxxxxxxxxxxxxxxxx",
    "occupy_appid": "wxxxxxxxxxxx",
    "is_locked": true
}

8.5 設(shè)置會(huì)員卡拉出微信支付刷卡界面

通過(guò)接口創(chuàng)建支持刷卡類型的會(huì)員卡，用戶點(diǎn)擊快速買單后即可拉出刷卡界面進(jìn)行支付。以下為示意圖：

8.5.1 創(chuàng)建會(huì)員卡支持微信支付刷卡

 商戶可以創(chuàng)建一張會(huì)員卡支持微信支付刷卡，須在創(chuàng)建會(huì)員卡接口的JSON中加入以下字段：

{
     "card": {
         "card_type": "MEMBER_CARD",
         "member_card": {
             "base_info": {
                 "pay_info":
                 {
                         "swipe_card":
                         {
                 
                            "is_swipe_card":true
                         }
                        }
                      }
         }
     }
 }

8.5.2 更新會(huì)員卡支持微信支付刷卡

商戶可以更新已有會(huì)員卡支持微信支付刷卡，須在更新會(huì)員卡接口的JSON中加入以下字段：

{
    "card_id": "ph_gmt7cUVrlRk8swPwx7aDyF-pg",
    "member_card": {
             "base_info": {
                 "pay_info":
                 {
                         "swipe_card":
                         {
                 
                            "is_swipe_card":true
                         }
                        }
                      }
     }
 }