【会员相关接口】场景二：会员信息同步场景

主帖>【会员相关接口】八大场景接口对接说明

场景描述：

买家在微商城购物时，商家想要买家享受到一些会员权益，比如包邮、折扣、送积分等，如何在微商城创建对应权益的会员卡并发放给客户？如何通过接口实现外部系统会员信息和有赞的打通？

——微商城后台-客户-会员卡-会员卡管理，可选择无门槛会员卡、按规则发放的会员卡或需购买的会员卡形式创建会员卡，此处以无门槛会员卡为例进行说明；

——微商城后台-客户-客户管理，在客户信息的最右边，点击设置会员卡即可给会员发放会员卡；

——选择对应的会员卡进行保存即可；

——也可以在会员卡界面点击“发卡”，让用户点击链接或扫码领卡；

——通过哪个接口可以在微商城创建会员卡？

（1）商家创建会员卡：youzan.scrm.card.create

（2）链接地址：https://www.youzanyun.com/apilist/detail/group_scrm/crm_advanced/youzan.scrm.card.create ；

（3）重要字段说明：

》》grant_condition：领取条件，目前支持三种规则设置，amount_limit：累积消费金额（单位是分），points_limit：累积获取积分，trade_limit：累积下单成功笔数，达成任一条件即可领取会员卡；

》》level：规则卡的等级，当会员卡类型设置为规则卡时才需要设置；

》》type：权益类型，1:包邮，2:折扣，3:送现金券，4：送积分；

》》discount：折扣权益字段，折数 ，1表示0.01折，10标识0.1折，以此类推，范围选择：1-100（权益type为2时必传）；

》》points：积分权益字段，开卡赠送的积分数量（权益type为4时必传）；

（4）调用格式，通过（2）中链接访问后：

（5）HTTP调用示例：

（6）JAVA调用示例：

YZClient client = new DefaultYZClient(newToken("token")); //new Sign(appKey, appSecret)

YouzanScrmCardCreateParams youzanScrmCardCreateParams = newYouzanScrmCardCreateParams();

youzanScrmCardCreateParams.setCardCreate("{"activate_mode":0,"card_type":1,"color_code":"#55bd47","is_allow_share":true,"term_days":365,"term_type":3,"sync_weixin_mode":0,"rights":[{"is_available":true,"type":1} ],"description":"","name":"terr"}");

YouzanScrmCardCreate youzanScrmCardCreate = newYouzanScrmCardCreate();

youzanScrmCardCreate.setAPIParams(youzanScrmCardCreateParams);

YouzanScrmCardCreateResult result =client.invoke(youzanScrmCardCreate);

——通过哪个接口可以查看商家在微商城中已经创建好的会员卡有哪些？

（1）获取商家会员卡列表：youzan.scrm.card.list

（2）链接地址：https://www.youzanyun.com/apilist/detail/group_scrm/crm_advanced/youzan.scrm.card.list ；

（3）重要字段说明：

》》page：页码，设置需要拉取的页码，返回结果中，默认每页会显示30张会员卡的基本信息；

一般商家创建的会员卡类型不会很多，因此此接口为了调用了方便性，只设置了“页码”入参，商家在调用接口时可不传参，直接调用即可；

（4）调用格式，通过（2）中链接访问后：

（5）HTTP调用示例：

（6）JAVA调用示例：

YZClient client = new DefaultYZClient(newToken("token")); //new Sign(appKey, appSecret)

YouzanScrmCardListParams youzanScrmCardListParams = newYouzanScrmCardListParams();

youzanScrmCardListParams.setPage(1L);

YouzanScrmCardList youzanScrmCardList = newYouzanScrmCardList();

youzanScrmCardList.setAPIParams(youzanScrmCardListParams);

YouzanScrmCardListResult result =client.invoke(youzanScrmCardList);

——通过哪个接口可以将商家创建好的会员卡发放给指定客户？

（1）给用户发放会员卡：youzan.scrm.customer.card.grant

（2）链接地址：https://www.youzanyun.com/apilist/detail/group_scrm/crm_advanced/youzan.scrm.customer.card.grant ；

（3）重要字段说明：

》》card_alias：商家会员卡的唯一标识，通过上面讲过的接口“获取商家会员卡列表：youzan.scrm.card.list”可以获取到；

》》fans_type：粉丝类型，自有粉丝: fans_type = 1，用于标识粉丝的来源渠道，非必须；

》》fans_id：粉丝ID，从各渠道进入微商城后，粉丝在微商城中的唯一ID，如果没有写0，mobile/fans_id/open_user_id 三选一传入；

》》mobile：手机号，如果用户主动绑定了手机号，或是直接通过手机号注册的方式进入微商城，后台会优先以手机号作为用户标识；如果没有写0，mobile/fans_id/open_user_id 三选一传入；

》》open_user_id：三方用户ID，此ID只出现在APPSDK开店业务场景中，在登录态打通过程中，三方将open_user_id传给有赞，作为三方APP用户在微商城中的用户标识；如果没有写0，mobile/fans_id/open_user_id 三选一传入；

（4）调用格式，通过（2）中链接访问后：

（5）HTTP调用示例：

（6）JAVA调用示例：

YZClient client = new DefaultYZClient(newToken("token")); //new Sign(appKey, appSecret)

YouzanScrmCustomerCardGrantParams youzanScrmCustomerCardGrantParams= new YouzanScrmCustomerCardGrantParams();

youzanScrmCustomerCardGrantParams.setCardAlias("Y3nqeqfe1g9kxh");

youzanScrmCustomerCardGrantParams.setMobile("15088886668");

youzanScrmCustomerCardGrantParams.setFansId(0L);

youzanScrmCustomerCardGrantParams.setFansType(0L);

YouzanScrmCustomerCardGrant youzanScrmCustomerCardGrant =new YouzanScrmCustomerCardGrant();

youzanScrmCustomerCardGrant.setAPIParams(youzanScrmCustomerCardGrantParams);

YouzanScrmCustomerCardGrantResult result =client.invoke(youzanScrmCustomerCardGrant);

主帖>【会员相关接口】八大场景接口对接说明