淘宝天猫会员通接口开发文档

 
电子商务

一、品牌商家申请入驻

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

注意事项：
1 品牌商自己研发入驻审核通过以后创建应用。应用标签是--【商家品牌会员】；
2 如果为第三方ISV代开发，isv应该先创建--【新零售会员应用】。在商家申请入驻的时候，商家联系isv获取应用的AppKey，isv提供后台AppKey。

二、开发说明

名词解析

  • SPI（Service Provider Interface）：服务商提供接口，会员中心作为调用方。请求入参在request的body中，返回相应的json格式文本。注意：返回参数以该文档为准

  • TMC：消息通知，会员中心发起的消息通知，主要用于积分变更等重要消息的发送，有重试机制保证消息一定到达。

  • 飞行模式（由平台控制，商家无法进行关闭）

    • 飞行模式1.0(大促时开启):消费者入会请求到阿里平台，不会请求到服务商系统，即服务商是没有此消费者信息的，飞行模式入会后24小时内会进行10次数据回补

    • 飞行模式2.0(日常开启)：入会请求返回超时(目前查询要求是1.2s，写（注册，绑定）2s)会触发飞行模式入会，飞行模式入会后24小时内会进行10次数据回补

  • 手机号加密方法

    • 手机号加密方法 加密结果为MD5(MD5("tmall"+$content+$key))；加密后的字符串为 32 位小写。tmall 为固定字符串，key 为手机号加密密钥(会员中心开发者后台可见)、content 为需要加密的内容(这里是 moblie)。 代码实例： DigestUtils.md5Hex(DigestUtils.md5Hex("tmall" + "15089990091"+ "abcd")); 先给已存在的手机号做加密运算，然后和平台过来的入会请求里的手机号做匹配，能匹配上则说明线下已存在该手机号，绑定查询接口可返回可绑定

服饰商家开发详见: 会员中心系统接口文档

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

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

① qimen.alibaba.member.activate（会员激活）该接口为全新接口，只有在商家从官方版/定制版切换到会员通时，存量会员从店铺会员点击升级为存量会员时才会用到，详细字段可点击文档，奇门接入可点击文档进行查看

② tmall.mei.crm.member.bind.query（绑定查询）

③ tmall.mei.crm.bind（绑定）

④ tmall.mei.crm.member.register（注册）

如果是java开发，消息用长连接可获取，如果是php需要开发者主动调用接口获取，点击查看消息服务使用介绍，积分变更需订阅消息：tmall_mei_PointChange

1接口名称：tmall.mei.crm.member.sync，线下积分变动通知到阿里，保证线上线下积分一致，详见接口文档

2接口名称：taobao.tmc.messages.consume 消费消息,消息消费后，指针自动后移，下次调用自动获取到未消费过的消息，但是消费确认后的消息无法再次获取。

3接口名称：tmall.mei.crm.callback.point.change，告知阿里服务商系统处理是否成功的结果，一定要确认回调，否则积分变更流程会未完结，进行积分兑券/兑礼的积分会处于冻结中，无法正常使用。注：积分兑礼的礼品签收不代表积分变更流程的完结

4接口名称：taobao.tmc.messages.confirm 确认消息,获取消息后，如果不确认，消息服务会选择时机重发，重发次数由消息服务控制，如果消息3天内都没有被确认将会被删除。


会员通接口开发文档：https://open.taobao.com/docV3.htm?docId=108453&docType=1

 


有话要说