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

文档中心 > 品牌会员中心

一、应用申请 

1、“商家品牌会员中心”标签申请需要哪些资质

 

二、会员注册、绑定

 

1、手机加密密钥从哪儿得到?如何加密?

手机号加密方法

加密结果为MD5(MD5("tmall"+$content+$key));加密后的字符串为 32 位小写。tmall 为固定字符串,key 为手机号加密密钥(会员中心开发者后台、测试平台可见)、content 为需要加密的内容(这里是 moblie)。

代码实例: DigestUtils.md5Hex(DigestUtils.md5Hex("tmall" + "15089990091"+ "abcd"));

2、会员h5页面信息是否有限制?

h5页面暂无限制,但页面代码需部署在聚石塔,并且使用EWS(运维工具,主要生成域名,只有EWS生成的域名手淘才认可,域名格式*.ews.m.japapp.com),聚石塔接入流程:点击查看,EWS接入流程:点击查看

3、会员入会页面报“系统繁忙”

a.检查下会员通应用spi服提供中 spi是否上线,可参考://open.taobao.com/docs/doc.htm?spm=a219a.7629140.0.0.KvYhuT&treeId=18&articleId=103182&docType=1#s6

b.考虑请求是否是超时导致的,如果请求超过3s表示超时

c.服务商查看自己的日志看下会员等级和会员积分是否有返回

d.可以给下nick,时间点,手机号 ,商家店铺名称给技术小二排查

6、会员入会页面报“喵~您还不是该品牌会员,不能绑定(或注册)~” 错误信息如下图

a.商家的会员等级返回无效,需商家排查是否次会员的等级在客户运营平台没有设置

b.检查注册和绑定接口返回的member信息是否正确,严格按照接口的返回示例格式开发  接口文档:点击进入

三、SPI使用

1、SPI实现方法

SPI的实现方法和API不同,SPI没有SDK,只需要按照阿里的接口文档根据入参信息实现商家的逻辑按照接口文档的出参格式返回即可

2、SPI调用失败怎么定位?

一般Remote service error是因为SPI测试地址未正确生效导致会员中心调用接口失败。通过SPI提供的测试工具进行联调与提供URL服务的机器,成功后提交测试地址。并在会员中心开发者后台重新进行调试。

四、积分

1、 积分变更如何理解,如何与线下的积分同步?

用户进行积分消耗或增加积分的场景,例如“积分兑换礼品”、“积分兑换优惠券”

线上发起:①会发消息通知品牌商做积分增减确认,②会员中心会根据确认的消息进行扣减或增加积分。

线下发起:同时当用户在线下获得积分或者使用积分后,品牌商需调用同步接口同步给阿里平台,tmall.mei.crm.member.sync 

2、如何确认会员中心发来的积分兑换消息?

如果是java开发,消息用长连接可获取(通过sdk接受),如果是php需要开发者主动获取(通过api接收):

消息服务使用介绍://open.taobao.com/docs/doc.htm.htm?spm=a219a.7629140.0.0.gwjIxO &treeId=1&articleId=101663&docType=1

前提是要确认是否订阅消息:tmall_mei_pointchange,消息订阅方案详见上面文档链接

3、tmall.mei.crm.member.sync 接口报参数错误

a.查下version参数是否正确,version强烈建议用时间戳!不管是测试还是正式调用接口的时候,只要调用该接口,并且本次version比上次的值大,系统就会自动记录,如果在测试的时候输入9999999类似这种随意的数据,系统也会记录,之后报错”失效的版本”,就是因为传入的version比9999999小,所以强烈建议用时间戳!!!

b.查看会员等级在客户运营平台是否设置会员等级

4、积分兑券用哪个接口

不用做开发,直接商家运营去客户运营平台去装修即可,

5、积分兑礼用哪个接口

不用做开发,直接商家运营去客户运营平台去装修即可

 6、会员卡详情页显示 积分锁定 问题

阿里方向商家系统推送了积分变更消息,商家没有调用tmall.mei.crm.callback.point.change接口返回业务处理结果。

五、会员识别

1、会员识别接口是哪个

tmall.mei.crm.member.getbypaycode,详见://open.taobao.com/docs/api.htm?spm=a219a.7629065.0.0.qV3LD9&apiId=30027&scopeId=12640

2、会员识别接口可以得到什么信息

根据付款码可以拿到消费者的nick和混淆手机号,如果在扫码之前,顾客已经在淘宝绑定过品牌的会员,那扫码后传给商家系统的是明文手机号。反之如果顾客没有加入过该品牌的会员,接口传给商家的是密文手机号。

3、tmall.mei.crm.member.getbypaycode接口返回参数为空

需开发者确认appkey是否有“会员码身份识别“权限包,如下图所示:

4.tmall.mei.crm.member.getbypaycode接口报错

调用会员通的接口,返回错误码信息Invalid signature,这个错误是因为请求参数没有带sessionkey。在淘宝开放平台里能够查到接口的文档,如图:

当接口下方写着【需要授权】的时候,请求入参里面必须带上sessionkey,sessionkey申请地址://open.taobao.com/apitools/sessionPage.htm?spm=a219a.7386781.3.30.OpSTRo,测试阶段的sessionkey有效时长一般为1天,应用上线后和应用的订购时长有关

六、测试

1、开发完成之后如何测试接口功能?

       开发完了之后可以通过测试平台(开发者后台)进行验收,测试平台地址:https://bvip.tmall.com/crm-settings/memberTest.htm?spm=a219a.7629140.0.0.Z4rcUs  

2、测试平台SPI测试出现如下错误

{"error_response":{"code":61,"msg":"spi inernal error","sub_code":"isp.route-error","sub_msg":"无法找到调用路由关系","request_id":"qm3ood94rixv"}}

请确认SPI是否申请发布,如下图所示:

 3、在测试后台测试绑定接口的时候,为什么会返回绑定查询错误

底层逻辑是:先调用绑定查询来确定该会员是否可以绑定,只有当接口返回可绑定,才会去调用绑定接口

4、出现下图中的错误

阿里需要经过24小时清理该账号下会员通之前的会员数据,如果经过24小时还报这个错误,联系阿里小二进行解决。

5、品牌号装修时遇到下图的提示:

可能的原因有:1、会员中心-开发者后台未测试通过并且发布上线 2、将登陆的br账号nick告知小二,小二查询该br账号是否开通了会员能力

七、其他

1、有个品牌有多家旗舰店,现在都要接入会员通系统,多家旗舰店会员通需要打通,也就是说我在A店铺绑定会员后,B店铺就直接是会员,不需要再次绑定。后端商家CRM系统都已打通,前端tmall旗舰店该如何设置?

多个旗舰店入会页面装修都用一个入会页面,这样既可实现此种场景

2、一个服务商帮多个商家做会员系统是不是要申请多个应用?能否只申请一个?

2个解决方案

1)做一个应用,让他自己根据卖家nick去区分每个商家的spi地址,调用不同的接口,不通商家的就都配置一个,比如a地址,a地址在通过卖家的nick去做不同的转发

2)做多个应用,每个应用SPI地址都单独配置

3、开发完会员通后,如何模拟顾客去门店扫码入会这个场景,二维码在哪里生成?

二维码在【全渠道中心】---【门店码】生成。扫生成的二维码即可进入会员卡绑卡页面,模拟消费者入会的流程。

 

八、服务商切换

1、确认数据是否可以过渡

     提前要商家确认之前服务商的数据是否能导出给新的服务商。

2、确认切换时间

商家和服务商需要确定切换时间,切换期间阿里不会下架前端入会页面,消费者在切换期间会出现不能入会的报错,需要商家做好应对,建议切换时间放在晚上下班后入会低峰。

3、新服务商开发上线

新服务商进入开发者后台,更换新的服务商会员应用的appkey,测试联调通过即可(更换appkey后线上会员的入会直接会读新的appkey的接口)。

FAQ

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