淘宝开放平台

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

qimen.alibaba.tcls.aelophy.member.identify (同城会员查询)

平台线上根据手机号或卡号查询线下会员

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
merchantCode String 必须 CSSJ 商家编码
identifyType String 必须 cardNum 识别类型。cardNum卡号,mobile手机号,magneticCard磁卡二轨信息。其中手机号和卡号必须要支持
identifyCode String 必须 15388888888 识别码。与识别类型对应
attributes String 可选 {} 参数可选，因为会员是商家纬度，作为统计或者其他要求，会传商家的自有的店铺id，key storeId

响应参数

名称 类型 示例值 描述
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
  • 高级会员
  • 会员等级描述。非必填
  • └ cardStatusDesc
  • String
  • 使用中
  • 卡状态描述 ['使用中' or '已挂失' or '已作废' or '已补发卡' or '已退卡' or '已冻结' or '未激活' or '已坏卡登记' or '已销毁' or '已制卡' or '已发卡' or '已核对' or '已回收' or '空卡' or '异常' or '已损卡']
  • └ points
  • String
  • 0
  • 会员积分，数字类型。非必填
  • └ memberId
  • String
  • xxxxx
  • 会员id。
  • └ name
  • String
  • 张三
  • 会员名称。非必填
  • └ gender
  • String
  • male
  • 性别。['male' or 'female' or 'unknown']。非必填
  • └ address
  • String
  • 浙江省杭州市余杭区
  • 家庭住址。非必填
  • └ mobile
  • String
  • 16388888888
  • 手机号码。必填
  • └ email
  • String
  • xxx.xxx@alibaba.com
  • 邮箱。非必填
  • └ birthday
  • String
  • 1993-10-20 00:00:00
  • 生日。非必填
  • └ province
  • String
  • 浙江省
  • （会员注册）省。非必填
  • └ city
  • String
  • 杭州市
  • （会员注册）市。非必填
  • └ district
  • String
  • 余杭区
  • （会员注册）区。非必填
  • └ lastUpdateTime
  • String
  • 2021-11-29 08:40:00
  • 最后更新时间。非必填
  • └ identityType
  • String
  • idCard
  • 证件类型 idCard：身份证、passport：护照、militaryCard：军人证、others：其他。非必填
  • └ identityNum
  • String
  • xxx
  • 证件号码。非必填
  • └ cardBalance
  • String
  • 0
  • 会员卡余额。非必填
  • └ cardBalanceCurrency
  • String
  • CNY
  • 会员储值账户币种 需符合ISO-4217标准。非必填
  • └ attributes
  • String
  • {}
  • 扩展信息。非必填
  • └ tips
  • String
  • {}
  • 会员提醒。非必填

请求示例

{"merchantCode":"CSSJ","attributes":"{}","identifyCode":"15388888888","identifyType":"cardNum"}

响应示例

{
    "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":"高级会员",
        "cardStatusDesc":"使用中",
        "points":"0",
        "memberId":"xxxxx",
        "name":"张三",
        "gender":"male",
        "address":"浙江省杭州市余杭区",
        "mobile":"16388888888",
        "email":"xxx.xxx@alibaba.com",
        "birthday":"1993-10-20 00:00:00",
        "province":"浙江省",
        "city":"杭州市",
        "district":"余杭区",
        "lastUpdateTime":"2021-11-29 08:40:00",
        "identityType":"idCard",
        "identityNum":"xxx",
        "cardBalance":"0",
        "cardBalanceCurrency":"CNY",
        "attributes":"{}",
        "tips":"{}"
    }
}

验签示例

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

错误码解释

错误码 错误描述 解决方案

API工具

错误码查询工具 SDK下载

FAQ

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