5.1会员卡查询

优质

小牛编辑

136浏览

2023-12-01

注意：平台已启用动态会员卡号，每次都会变化。需要记录会员卡号的场景，请使用接口返回参数中的mbno.

请求参数说明

参数	描述	必填	示例值	类型	最大长度
action	接口参数组	是		object
└action	需要调用的接口名称	是	mb_check	string
get	GET参数组，本组参数需要参与签名	是		object
└mbno	会员卡号（id、mbno、extid、phone、openid五个可选其中之一）	否	47302320	number
└id	会员卡id（id、mbno、extid、phone、openid五个可选其中之一）	否	4730232	number
└extid	会员卡内编码（id、mbno、extid、phone、openid五个可选其中之一）	否	47302320	number
└phone	会员手机号（id、mbno、extid、phone、openid五个可选其中之一）	否	47302320	number
└getlist	getlist=1,返回会员优惠券列表	否	1	number
└openid	使用公众号openid查询会员卡（id、mbno、extid、phone、openid五个可选其中之一）	否	o9gBSxJJlVsT6GZvwPVayMh49OfE	string

请求示例

{
	"action": {
		"action": "mb_check"
	},
	"get": {
		"mbno": "47302320",
		"id": "4730232",
		"extid": "47302320",
		"phone": "47302320",
		"getlist": "1",
		"openid": "o9gBSxJJlVsT6GZvwPVayMh49OfE"
	}
}

响应参数说明

参数	描述	必填	示例值	类型	最大长度
status	返回状态。接口成功时为1，出错为0	是	1	number
mbno	卡号	否	47302320	number
id	会员卡id	否	4730232	number
mbid	平台id	否	5759774	number
name	会员名称	否	雪碧	string
phone	手机号	否	15606132502	number
gender	性别（1是男的 0或2是女的或者M是男 F是女的）	否	1	number
birthday	生日	否	20181018	number
balance	会员卡余额	否	5785.99	number
points	积分余额	否	110	number
bns_balance	赠送金额	否	39999.39	number
subject	备注	否	666	number
state	卡状态（1=正常，-1=停用，-2=作废）	否	1	number
level	卡等级	否	4	number
level_name	卡等级名称	否	白金卡	string
credit	信用额度	否	0	number
card_no	实体卡号	否	90866	number
card_type	实体卡类型/折扣码	否	5	number
card_name	实体卡名称	否	1	number
card_balance	实体卡余额	否	1.00	number
type	类型	否	0=微卡，2=通卡，15=储值卡	number
card_points	实体卡积分	否	1	number
pt_ratio	积分抵扣金额（多少积分抵扣1元）	否	100:1	string
ext_info	卡备注	否	666	number
extid	卡内码	否	123456789012312345678	number
expiry_date	会员卡有效期	否	2020-09-10	string
src_msid	归属门店	否	6786	number
msid	接口调用门店	否	27071	number
mb_right		否		object
└recharge	是否启用储值功能（(0:不开启1:开启)）	否	0	number
└mc_price	是否享受会员价(0:不开启1:开启)	否	0	number
└rebate	是否享受优惠折扣(0:不开启1:开启)	否	0	number
└ratio	享受优惠折扣比例	否		string
└use_pt	是否启用积分(0:不开启1:开启)	否	1	number
└consumption	每消费多少元	否	10	number
└pt	获多少积分	否	1	number
└use_reward	是否启用返现(0:不开启1:开启)	否	1	number
└mc_consumption	每消费多少元	否	500	number
└mc_reward	返现多少元	否	1	number
colist		否		list
└store	券可用门店	否	全部	string
└name	券名称	否	彭老板的券	string
└coid	券id	否	27207625	number
└cono	券号	否	28*******395	string
└vdate	券使用有效期	否	20190723~20190822	string
└cash	金额（非0为金额券，0为实物券）	否	30.00	number
└time	券领用时间	否	2019-07-23 16:08:49	string
└price	券金额	否	0	number
└requireamt	满多少可用	否	100	number
└deid	券平台流水	否	28200	number
└info		是	这是券说明	string
└subject	备注	否	赠送	string
└accid	券平台id	否	4730232	number
└type	券类型	否	0	number
refId	推荐人卡号	否	1234567890	number
active	1是关注，-1是未关注	否	1	number
└card_createTime	开卡时间	否	2021-01-13 16:50:10	string
└renew_list	对应卡等级续费活动	否		list
└└amt	续费金额	否	2.00	number
└└expire	续费日期（单位：月）示例为：12个月	否	12	number

响应示例

{
  "status": "1",
  "mbno": "47302320",
  "id": "4730232",
  "mbid": "5759774",
  "name": "雪碧",
  "phone": "15606132502",
  "gender": "1",
  "birthday": "20181018",
  "balance": "5795.99",
  "points": "310",
  "bns_balance": "40009.39",
  "subject": "666",
  "state": "1",
  "level": "5",
  "level_name": "钻石卡1",
  "credit": "0",
  "card_no": "90866",
  "card_type": "5",
  "card_name": "1",
  "card_balance": "1.00",
  "type": 0,
  "card_points": "1",
  "pt_ratio": "100:1",
  "ext_info": 666,
  "refId": "1234567890",
  "active": "1",
  "extid": "123456789012312345678",
  "expiry_date": "2019-07-25",
  "src_msid": "6786",
  "mb_right": {
    "recharge": 0,
    "mc_price": 0,
    "rebate": 0,
    "ratio": "",
    "use_pt": 1,
    "consumption": "10",
    "pt": "1",
    "use_reward": 1,
    "mc_consumption": "500",
    "card_createTime": "2021-01-13 16:50:10",
    "renew_list": [
      {
        "amt": "2.00",
        "expire": 12
      }
    ],
    "mc_reward": "1"
  },
"colist": [
    {
      "store": "全部",
      "name": "彭老板的券",
      "coid": "27207625",
      "cono": "28*******395",
      "vdate": "20190723~20190822",
      "cash": "30.00",
      "time": "2019-07-23 16:08:49",
      "price": 0,
      "requireamt": "100",
      "deid": "28200",
      "info": "这是券说明",
      "subject": "赠送",
      "accid": "4730232",
      "type": "0"
    } ],
  "server_timestamp": 1566296953,
  "server_time": "2019-08-20 18:29:13",
  "server_name": "wx-task2.hz",
  "msid": "10021"
}