注意:以下文档只适用于TOP接口,请谨慎使用!

文档中心 > 品牌会员中心

一、背景

会员通品牌商拥有线下门店且开通支付宝支付的商家实现以下接口升级后

将拥有线下运营的场景通道,例如线下会员招募、会员付款核销等。

二、前端展现

三、品牌商家申请入驻

品牌商品牌会员入驻中心,点击创建应用,在新开页面提交开发者信息。
【企业资质】请上传企业执照副本图片;
【请填写选用的APPKEY 】如果接入方式为自己研发,请填写无,审核同意后需进行创建应用,应用创建成功后自动赋予【品牌会员基础包】(SPI场景组)和【品牌会员积分包】(API权限包)的权限;如果为第三方ISV代开发,联系isv获取应用的AppKey,如果isv应用分前后台,请填写后台AppKey。
ISV无线开放平台
1、开发帐号必须为卖家帐号或者企业资质的帐号。如果是ISV代开发,则ISV需要经过企业资质认证或者由商家申请权限。
2、审核通过后: 应用由ISV提供,【品牌会员基础包】(SPI场景组)和【品牌会员积分包】(API权限包)的权限自动赋予给ISV的应用。

注意事项:
1 品牌商自己研发入驻审核通过以后创建应用。应用标签是--【商家品牌会员】;
2 如果为第三方ISV代开发,isv应该先创建--【无线互动应用】,互动应用分为前台key和后台key。在商家申请入驻的时候,商家联系isv获取应用的AppKey,isv提供后台AppKey。

四、开发说明

demo:点击查看开发接口详见: 会员中心系统接口文档

开发测试过程中商家相关操作见:会员中心-开发者后台(操作说明:点击查看)。

会员入会流程

①②③为SPI接口,开发者根据接口实现返回json数据即可

tmall.mei.crm.member.bind.query

tmall.mei.crm.bind

tmall.mei.crm.member.register

会员积分变动流程

如果是java开发,消息用长连接可获取,如果是php需要开发者主动获取

②接口名称:tmall.mei.crm.callback.point.change

④接口名称:tmall.mei.crm.member.sync

注意:会员除了手机号是否可以有其他信息,目前天梭项目是没有其他扩展信息,730后可以给到生日(待补充)信息,如果是日常会员通的接入可以通过跳转h5页面来做完善会员信息,h5的页面必须要购买聚石塔机器部署到EWS环境,才能生成手淘认可的链接

EWS的接入点击查看,h5页面的配置如下图所示,配置链接点击查看,官方入会页面和h5之间映射关系可以通过混淆nick做映射关系,例如:SPI给的明文Nick通过接口taobao.mixnick.get获取混淆nick,和h5页面通过tida接口获取到的混淆nick做匹配映射关系

SPI调试

点击开放平台【控制台】相关应用的【应用管理】>【API服务提供】,选择【品牌会员基础包】进入开发,如下图所示。

进入开发填写相关相关环境,开发者填写测试url,系统实现接收处理。

SPI详细了解见:SPI服务接入文档.

积分兑换消息

1、订阅消息


如上图所示,在页面的右侧查找名为:tmall_mei_PointChange的消息,确认是否已订阅,如未订阅,点击【订阅】。

2、实现接收消息

消息服务使用介绍
注意:如果是SDK接收消息,消息会默认确认,如果是api接收消息,要调用确认接口确认消息。消息确认后消息才不在发送,如果不确认消息会继续发送直到消息失效。

3、接收消息后回调API

消息接收以后,开发者系统会做相应会员积分变更处理。积分变更后要通过 API 接口 tmall.mei.crm.callback.point.change 积分变更回调 接口发起该调用返回业务处理结果。该回调无须立刻处理, 暂无失效时间。等业务确认完毕后,再进行回调即可,但一定要确认回调,否则系统会一直补发消息。
注意:用户付款成功之后的积分变更扣减消息会发送给品牌方处理,品牌方如 果对消息消费过慢,如果此时商家的订单已经是已发货阶段,则取消订单会失败。 请品牌方系统及时的消费积分变更消息并向会员中心系统确认该消息。

API调用方法详解

五、测试平台(开发者后台)

操作说明

测试平台地址:

https://bvip.tmall.com/crm-settings/memberTest.htm?spm=a219a.7629140.0.0.f0SW1D

 

首先能进入测试平台页面,需要商家在“客户运营平台”设置开发者信息,开发者账号填写服务商登录开放平台的账号,否则开发者进入到测试平台页面

并且在页面上填入商家账号nick(注意不是开发者账号,是开发者账号登录测试平台,在如下页面填写商家nick账号)

进入测试平台如下图所示:注意有个手机加密密钥是用来明文变密码加密算法的key

SPI AppKey
请填写提供SPI服务的应用AppKey,通常为第一步创建应用的AppKey

消息通知AppKey
消息接收应用的AppKey,若不使用积分兑换功能可不填写。通常为第一步创建应用的AppKey
应用(SPI)创建者账号
仅拥有混淆nick权限且开发积分兑换功能用户使用,该账号用于混淆nick加密,不能修改,如有问题请联系小二。如该字段为空,请填写SPI AppKey保存后刷新页面。

测试地址配置

在开放平台控制台点击应用管理,选择的appkey进入API 服务提供页面,在点击进入开发测试,可配置SPI地址,配置好后点击进入测试,提交测试, 点击完成测试可以配置SPI上线后的url地址如下图所示:

 

注意:测试平台其中一项“调用测试地址”先勾选,勾选上代表SPI调用的你在TOP填写的SPI测试地址,如果不勾选代表SPI调用的你在TOP填写的SPI线上地址

开放平台的测试通过只是代表SPI的URL能访问,不代表SPI返回数据的准确性,在测试平台测试的是SPI返回数据是否正确的测试

测试场景说明

测试平台的接口测试比开发者的接口多,是由于测试平台是按照测试场景来做的测试,例如

其中的“绑定-->解绑-->绑定”测试的是某个消费者绑定后在解绑在绑定的场景,实质是测试的绑定接口

基本功能会员注册等

以SPI(Service Provider Interface)的方式实现的,即会员中心将绑卡,注册等信息通spi接口传给开发者,开发者实现相关逻辑。文档参见:会员中心系统接口文档



开发者后台会员通相关功能测试完毕,发布上线。正式上线需要勾选去掉。

兑换功能

目前有礼品兑换和优惠券兑换,之后会拓展兑换场景,如签到获取积分,抽奖拿积分等等,开发者使用消息通知来接收(兑换的消息),然后调用API,告知是否兑换成功。

 

 

六、设置会员卡面信息

设置会员卡界面等其他信息设置参考手册:
会员中心商家操作说明书

商家操作视频

优秀案例展示

七、发布上线

打开开放平台首页,点击控制台,找到相关应用,点【概览】点击【提交发布上线】。这个与功能无关,可提前操作。

SPI发布上线

1)SPI测试后需增加线上SPI地址,如下图所示

2)在开放平台申请发布SPI如下图所示

3)保证所有接口测试通过后,点击测试平台页面上的“发布上线”按钮

注意:如果没有测试通过就上线,消费者在淘宝下单后都收到消息提醒入会,进入到入会页面点击绑卡会报错,所以一定要测试通过后在点击发布上线

八、开发资料及链接

  • 接口文档点击查看,商家操作文档点击查看
  • 会员中心-开发者后台
  • SPI服务接入文档
  • 消息服务使用介绍
  • API调用方法详解
  • SPI校验调用
  • 程序逻辑上的处理是在http入口处先做签名校验,保证接口调用方只能是淘宝,保证接口的安全性。当然,如果你能以其他方式保证接口的安全性,不做校验亦可,不做强制要求。
    引入SignTool.java和encryptUtil.java以及io包,加密串为相关应用的AppSecret(非沙箱AppSecret),签名的测试可在SPI开发中测试。
    然后,实现接收接口相关逻辑处理。
    示例代码:

    String body = SignTool.getBody(request); // 由于是流类型读取,只能调用一次,后面的body使用body字符串
    if(!SpiUtils.checkSign4TextRequest(request, body, "04925a6333e62f8ce4cb576a314743d2")) {
     return {\"bindable\":\"false\",\"bind_code\":\"\"
    }
    }
    //业务处理 todo

 

FAQ

关于此文档暂时还没有FAQ
返回
顶部