会员卡专区（二）

8 管理会员卡

8.1 拉取会员信息（积分查询）接口

接口说明

    支持开发者根据card_id和Code查询会员信息,包括激活资料、积分信息以及余额等信息。

接口调用请求说明

HTTP请求方式: POSTURL:https://api.weixin.qq.com/card/membercard/userinfo/get?access_token=TOKEN

参数说明

POST数据

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

返回数据

{
    "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 更改会员卡信息接口

接口说明

    支持更改会员卡卡面信息以及卡券属性信息。

接口调用请求说明

HTTP请求方式: POSTURL:https://api.weixin.qq.com/card/update?access_token=TOKEN

参数说明

POST数据

{
    "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": "使用时向服务员出示此券",
            "service_phone": "020-88888888",
            "description": "不可与其他优惠同享\n如需团购券发票，请在消费时向商户提出\n店内均可使用，仅限堂食\n餐前不可打包，餐后未吃完，可打包\n本团购券不限人数，建议2人使用，超过建议人数须另收酱料费5元/位\n本单谢绝自带酒水饮料",
            "location_id_list": [
                123,
                12321,
                345345
            ]
        },
        "bonus_cleared": "aaaaaaaaaaaaaa",
        "bonus_rules": "aaaaaaaaaaaaaa",
        "prerogative": "",
        "auto_activate": true,
        //也可以填写wx_activate"activate_url"：""
    }
}

支持修改字段： 

base_info字段：

会员卡专属字段修改：

特别注意，以下支持更新的字段不在基本信息base_info的结构中。

返回数据说明

数据示例：

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

开发者注意事项注

1. 更改卡券的部分字段后会重新提交审核，详情见字段说明，更新成功后可通过调用查看卡券详情接口核查更新结果；

2. 仅填入需要更新的字段，许多开发者在调用该接口时会填入brandname等不支持修改的字段，导致更新不成功。

3. 调用该接口后更改卡券信息后，请务必调用查看卡券详情接口验证是否已成功更改。

8.3 设置跟随推荐

功能介绍

    支持开发者在积分变动消息底部，配置卡券或设置跳转外链URL，具体形式如下图，可以是URL也可以是一张卡券。

开发者注意事项

一、支持两种类型的跟随推荐配置

1. 广告语+URL，支持商户配置16个汉字长度的文案，及点击跳转的链接。

2. 推荐卡券，支持商户配置一个本公众号下的卡券。

二、推荐位有效期控制

1. 广告语+URL类型，支持商户根据活动期限自定义展示时间。

2. 推荐卡券类型，由微信后台判断卡券的有效性，当卡券已过期、已被领完、已被置为失效会自动下架展示。

8.3.1 设置跟随推荐接口

接口说明

    调用更新卡券信息接口将增推荐位字段 update到已成功通过审核的卡券。 同时支持在创建卡券时填入相应字段。

接口详情

接口调用请求说明

http请求方式: POSThttps://api.weixin.qq.com/card/update?access_token=TOKEN

参数说明

使用消息配置卡券

{
    "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": "更多优惠",
                "url": "www.qq.com"
            }
        }
    }
}

字段说明

返回数据

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

字段说明

8.4 设置支付即会员

8.4.1 增加支付即会员规则接口

    开通微信支付的商户可以设置，用户在微信支付后自动为用户发送一条领卡消息，用户点击消息即可领取会员卡。   

接口说明

    支持商户设置支付即会员的规则，可以区分时间段和金额区间发会员卡。

接口调用请求说明

HTTP请求方式: POST
URL:https://api.weixin.qq.com/card/paygiftmembercard/add?access_token=TOKEN

参数说明

POST数据

{
    "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
}

字段说明

返回数据说明

数据示例：

{
    "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"
        }
    ]
}

开发者注意事项注

1. 会员卡领卡消息针对单个新用户仅发送一次，若该用户已经接收或者已经领取过会员卡则不会重复发送；

  2. 通过该规则设置的card_id的制券appid必须和当前mch_id的主体appid一致，否则报错72001；

  3.仅支持会员卡类型的卡券，否则报错：72003；

  4.设置支付即会员时，须确认调用接口的appid和当前card_id主体一致，以及appid与mchid有绑定关系，否则报错：72002；

  5.须保证mchid之前没有被其他appid设置过，否则报错72004；

  6.单次仅限设置100个mchid，若超过100个请多次调用本接口。

8.4.2 删除支付即会员规则接口

  删除之前已经设置的支付即会员规则。

接口说明

    支持商户设置支付即会员的规则，可以区分时间段和金额区间发会员卡。

接口调用请求说明

HTTP请求方式: POST
URL:https://api.weixin.qq.com/card/paygiftmembercard/delete?access_token=TOKEN

参数说明

POST数据

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

字段说明

返回数据说明

数据示例：

{
    "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 查询商户号支付即会员规则接口

接口说明

    可以查询某个商户号是否支持支付即会员功能

接口调用请求说明

HTTP请求方式: POST
URL:https://api.weixin.qq.com/card/paygiftmembercard/get?access_token=TOKEN

参数说明

POST数据

{"mchid":"xxxxxxxx"}

字段说明

返回数据说明

数据示例：

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

8.5 设置会员卡拉出微信支付刷卡界面

通过接口创建支持刷卡类型的会员卡，用户点击快速买单后即可拉出刷卡界面进行支付。以下为示意图：

8.5.1 创建会员卡支持微信支付刷卡

 商户可以创建一张会员卡支持微信支付刷卡，须在创建会员卡接口的JSON中加入以下字段：

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

8.5.2 更新会员卡支持微信支付刷卡

商户可以更新已有会员卡支持微信支付刷卡，须在更新会员卡接口的JSON中加入以下字段：

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