淘宝开放平台

登录
文档中心 > API类目 > 同城零售全渠道

qimen.alibaba.tcls.aelophy.member.card.create (会员卡创建)

调用商家CRM创建会员(开卡)

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
merchantCode String 必须 CSSJ 商家编码
mobile String 必须 15388888888 手机号
channelType String 可选 3 渠道类型。3：饿了么，2：美团，26：京东到家 31: 淘鲜达。表示用户开卡的渠道来源，仅用于记录。原则上同一手机号不同的渠道返回的卡号是一样的。
channelUserId String 可选 xxxx 渠道用户标识。
channelUserName String 可选 0 渠道用户名称。
amount Number 必须 0 开卡费用。免费卡传0
currency String 必须 CNY 币种。需符合ISO-4217标准。
attributes String 可选 {} 扩展字段
gender String 可选 male 性别。['male' or 'female' or 'unknown']
birthday String 可选 1993-10-20 00:00:00 生日

响应参数

名称 类型 示例值 描述
success Boolean true 处理是否成功
errCode String SUCCESS 返回码
errMsg String 成功 返回码说明
model MemberCardDTO 会员信息。
  • └ cardNum
  • String
  • 100001
  • 卡号。必填
  • └ cardName
  • String
  • 普卡
  • 卡片名称。非必填
  • └ startTime
  • String
  • 2021-11-29 08:40:00
  • 会员卡开始时间。非必填
  • └ endTime
  • String
  • 2099-11-29 08:40:00
  • 会员卡截止时间。长期有效传null。非必填
  • └ cardLevel
  • Number
  • 1
  • 会员卡等级。从1开始，每增加一级加1。非必填
  • └ cardLevelDesc
  • String
  • 高级会员
  • 会员等级描述。
  • └ attributes
  • String
  • {}
  • 扩展信息。非必填
  • └ newMember
  • Number
  • 是否新客
  • 1：新客。需要实现方根据开卡渠道做好幂等逻辑。

请求示例

{"birthday":"1993-10-20 00:00:00","merchantCode":"CSSJ","amount":0,"gender":"male","channelUserId":"xxxx","mobile":"15388888888","channelUserName":"0","channelType":"3","currency":"CNY","attributes":"{}"}

响应示例

{
    "success":true,
    "errCode":"SUCCESS",
    "errMsg":"成功",
    "model":{
        "cardNum":"100001",
        "cardName":"普卡",
        "startTime":"2021-11-29 08:40:00",
        "endTime":"2099-11-29 08:40:00",
        "cardLevel":1,
        "cardLevelDesc":"高级会员",
        "attributes":"{}",
        "newMember":是否新客
    }
}

验签示例

{"success":"不等于true","errCode":"sign-check-failure","errMsg":"Illegal request"}

错误码解释

错误码 错误描述 解决方案

API工具

错误码查询工具 SDK下载

FAQ

有用( 0 ) 我要提问
返回
顶部