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

文档中心 > 品牌会员中心

会员通淘外跨端入会接口文档

更新时间:2021/08/19 访问次数:10350

业务介绍

会员通1.0产品实现了品牌会员身份识别的打通,但是会员入会之后仍无法实现多个渠道的会员身份建立,还需要在不同的场景下去引导用户完成多次绑定。外域入会接口,可以帮助品牌实现多端多场景的一键入会。

产品方案

image

接入门槛

品牌要求

  • 必须开通有淘宝/天猫店铺
  • 必须开通店铺会员能力并支持0元入会
  • 必须完成会员通1.0的接入

    ISV要求

  • 需为开放平台授权服务商
  • 需要完成会员通保密协议签署

    TOP接口文档

    1.发送短信验证码

    接口:taobao.crm.member.sms.code.send
    请求参数
名称 类型 必须 示例值 描述
mobile String true 150xxxx1672 手机号

响应参数

名称 类型 示例值 描述
       

错误码说明

错误码 错误信息 解决方案
isv.invalid-parameter 非法参数  
isv.error-msm-sign 短信签名获取异常  
isv.send-too-many-times 达到当天发送上限  
isv.error_mobile_exist_risk 手机号存在风险  
isv.invalid-parameter-mobile 无效的手机号  
isp.system-error 系统异常  

2.校验短信验证码

接口:taobao.crm.member.sms.code.check
请求参数

名称 类型 必须 示例值 描述
mobile String true 150xxxx1672 手机号
code String true 123654 验证码

响应参数

名称 类型 示例值 描述
       

错误码说明

错误码 错误信息 解决方案
isv.invalid-parameter 非法参数  
isv.error-validate-code 校验失败  
isv.error-too-many-times 失败次数达到上限  
isv.validate_code_no_exist 尚未发送验证码  
isv.error_mobile_exist_risk 手机号存在风险  
isv.invalid-parameter-mobile 无效的手机号  
isp.system-error 系统异常  

3.入会接口

(需要在发送短信验证码后15分钟内(且用户验证成功)请求入会接口)
接口:taobao.crm.member.sms.join
请求参数

名称 类型 必须 示例值 描述
mobile String true 150xxxx1672 手机号
ip String false 11.22.33.44 C端ip地址
ext_info String false “{"birthday":"1990-09-01","province":"ZheJiang","babyBirthday":"2020-09-01","city":"HangZhou","sex":"1","name":"zhangsan","storeId":"123456","employeeNo":"999","email":"test1234@163.com\"} 入会采集信息

注意:扩展信息是json结构的字符串,键和值都是String类型。且key必须在给定的范围,超过范围的信息将不会被采集

ext_info里面可采集的信息如下

获取信息 字段名称 示例 必填
姓名 name “zhangsan”
性别 sex “1”:? 表示男性
“2”:? 表示女性
生日 birthday “1990-09-01”
宝宝生日 babyBirthday “2020-09-01”
省份 province “ZheJiang”
城市 city “HangZhou”
邮箱 email xxx@qq.com
门店ID storeId “300001”
导购ID employeeNo “123456”

门店ID和导购ID涉及到后续人群运营以及后续分佣,线下入会场景建议添加
1、门店ID:
-通过阿里接口维护门店信息,需填写自用门店编码;接口可参考:门店创建接口
-需要isv通过接口做一层自用门店编码转阿里内部门店ID的转化:接口可参考:门店信息查询接口
-该参数需传入阿里内部门店ID
2、导购ID:
-在新零售工作台维护导购员工信息,必须包括 员工工号
-该参数传入外部员工工号即可
响应参数

名称 类型 示例值 描述

错误码说明

错误码 错误信息 解决方案
isv.invalid-parameter 参数错误  
isv.invalid-parameter-mobile 无效手机号  
isv.already-member 已入会  
isv.bind-by-other 手机号已绑定  
isv.flight-mode 飞行模式状态  
isv.mobile-has-no-user 手机号没有对应的淘宝账号  
isv.error_mobile_not_check 手机号未进行校验  
isv.join-too-many-times 入会操作太频繁  
isp.system-error 系统服务异常  

FAQ

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