5.1会员卡查询

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

20240820(新增)mbno支持使用支付条形码查询,交易。支持支付通道微信官方、微信特约、随行付天阙

  请求参数说明

参数描述必填示例值类型最大长度
action接口参数组object
└action需要调用的接口名称mb_checkstring
getGET参数组,本组参数需要参与签名object
└mbno会员卡号(id、mbno、extid、phone、openid五个可选其中之一)47302320number
└id会员卡id(id、mbno、extid、phone、openid五个可选其中之一)4730232number
└extid 会员卡内编码(id、mbno、extid、phone、openid五个可选其中之一)47302320number
└phone会员手机号(id、mbno、extid、phone、openid五个可选其中之一)47302320number
└getlistgetlist=1,返回会员优惠券列表(券数量最多返回100)1number
└openid使用公众号openid查询会员卡(id、mbno、extid、phone、openid五个可选其中之一) o9gBSxJJlVsT6GZvwPVayMh49OfEstring
└merge必须和getlist一起调用。merge=1,(券数量最多返回500并且券分组展示)1number
└coPage优惠券分页查询( 不传则默认为1:单页固定500条)1number
└getBindQr获取通卡绑卡二维码,仅通卡时有效(1=获取,0=不获取)0number

 请求示例

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

  响应参数说明

参数描述必填示例值类型最大长度
status返回状态。接口成功时为11number
mbno卡号47302320number
id会员卡id4730232number
mbid平台id5759774number
name会员名称雪碧string
phone手机号15606132502number
gender性别 (1是男的 0或2是女的 或者M是男 F是女的)1number
birthday生日20181018number
balance会员卡余额5785.99number
points积分余额110number
bns_balance赠送金额39999.39number
subject备注666number
state卡状态(1=正常,-1=停用,-2=作废)1number
level卡等级4number
level_name卡等级名称白金卡string
credit信用额度0number
card_no实体卡号90866number
card_type实体卡类型/折扣码5number
card_name实体卡名称1number
card_balance实体卡余额1.00number
type类型0=微卡,2=通卡,15=储值卡number
card_points实体卡积分1number
pt_ratio积分抵扣金额(多少积分抵扣1元)100:1string
ext_info卡备注666number
extid卡内码123456789012312345678number
expiry_date会员卡有效期2020-09-10string
src_msid归属门店6786number
msid接口调用门店27071number
mb_rightobject
└recharge是否启用储值功能((0:不开启1:开启))0number
└mc_price是否享受会员价(0:不开启1:开启)0number
└rebate是否享受优惠折扣(0:不开启1:开启)0number
└ratio享受优惠折扣比例string
└use_pt是否启用积分(0:不开启1:开启)1number
└consumption每消费多少元10number
└pt获多少积分1number
└use_reward是否启用返现(0:不开启1:开启)1number
└mc_consumption每消费多少元500number
└mc_reward返现多少元1number
colistlist
└store券可用门店全部string
└name券名称彭老板的券string
└coid券id27207625number
└cono券号28*******395string
└vdate券使用有效期20190723~20190822string
└cash金额(非0为金额券,0为实物券)30.00number
└time券领用时间2019-07-23 16:08:49string
└price券金额0number
└requireamt满多少可用100number
└deid券平台流水28200number
└info券说明这是券说明string
└subject备注赠送string
└accid券平台id4730232number
└type券类型0number
refId推荐人卡号1234567890number
active1是关注,0是未关注1number
└card_createTime开卡时间2021-01-13 16:50:10string
└renew_list对应卡等级续费活动list
└└amt续费金额2.00number
└└expire续费日期(单位:月)示例为:12个月12number
└arName签单名称(团餐账户定制)苏州果盘string
└arMaxAmt签单最大抵扣金额(团餐账户定制)100number
└arMaxCount签单最大抵扣次数(团餐账户定制)10number
└usedAmt已使用签单金额(团餐账户定制)0number
└usedCount已使用签单次数(团餐账户定制)0number
└arId签单账户id100021number
└arFixedAmt签单单次固定额度(团餐账户定制)15number
invoice_balance可开票余额395.00number
bind_qr通卡绑定二维码(仅通卡时返回)https://mc-4124.hz.dc78.cn/Member/register.html?p=gpcs&bindToken=8ce5557a**************ce121ecfcstring

 响应示例

{
  "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",
    "arId": "100021",
    "arName": "苏州果盘",
    "arMaxAmt": "100",
    "arFixedAmt": "15",
    "arMaxCount": "10",
    "usedAmt": 0,
    "usedCount": 0,
    "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"
    } ],
  "bind_qr": "https://mc-4124.hz.dc78.cn/Member/register.html?p=gpcs&bindToken=8ce5557a**************ce121ecfc",
  "invoice_balance": "395.00",
  "server_timestamp": 1566296953,
  "server_time": "2019-08-20 18:29:13",
  "server_name": "wx-task2.hz",
  "msid": "10021"
}

未增加merge=1时返回

{

  "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"
}



增加:merge=1时返回
{
  "status": "1",
  "mbno": "190200511",
  "id": "19020051",
  "mbid": "5759774",
  "name": "、",
  "phone": "156000000000",
  "gender": "1",
  "birthday": "20210917",
  "balance": "85",
  "points": "301",
  "bns_balance": "85.00",
  "subject": "",
  "state": "1",
  "level": "2",
  "level_name": "银卡",
  "credit": "0",
  "card_no": "",
  "card_type": "",
  "card_name": "",
  "card_balance": "0.00",
  "type": "0",
  "card_points": "0",
  "pt_ratio": "10:1",
  "card_createTime": "2021-09-17 09:59:58",
  "refId": "",
  "active": "1",
  "ext_info": "",
  "extid": "",
  "expiry_date": "",
  "src_msid": 0,
  "mb_right": {
    "recharge": 1,
    "mc_price": 1,
    "rebate": 0,
    "ratio": "",
    "use_pt": 1,
    "consumption": "1",
    "pt": "1",
    "use_reward": 0,
    "mc_consumption": "",
    "mc_reward": ""
  },
  "face": "",
  "ms_can_use": 1,
  "count": "16", (客人全部券数量)
  "qty": "15", (客人当前返回的可用券数量)
  "colist": [
    {
      "list": {
        "store": "全部",
        "name": "雪碧316",
        "vdate": "20210826~20210925",
        "cash": "10.00",
        "time": "2021-08-26 10:03:35",
        "price": "0.00",
        "requireamt": "200",
        "deid": "58878",
        "info": "11",
        "subject": "商城购买优惠券[1](1000070522)",
        "accid": "19020051",
        "type": "0",
        "tp": "通用"
      },
      "qty": "2" (对应券类型数量)
    },
    {
      "list": {
        "store": "全部",
        "name": "雪碧0730",
        "vdate": "20210730~20210930",
        "cash": "10.00",
        "time": "2021-08-31 09:53:35",
        "price": "0.00",
        "requireamt": "0",
        "deid": "66240",
        "info": "1",
        "subject": "会员等级升级奖励-1",
        "accid": "19020051",
        "type": "0",
        "tp": "通用"
      },
      "qty": "11" (对应券类型数量)
    },
    {
      "list": {
        "store": "全部",
        "name": "个一样",
        "vdate": "20210831~20210930",
        "cash": "10.00",
        "time": "2021-09-02 16:33:01",
        "price": "0.00",
        "requireamt": "100",
        "deid": "67728",
        "info": "444",
        "subject": "",
        "accid": "19020051",
        "type": "0",
        "tp": "通用"
      },
      "qty": "2"
    }
  ],
  "rpc_time": "793.81ms",
  "rpc_request_time": "14:39:20",
  "rpc_time_consuming": "875.463ms",
  "request_time": "14:39:20.153",
  "server_timestamp": 1632379161,
  "server_time": "2021-09-23 14:39:21",
  "server_name": "wx-task2.hz",
  "duration": "965ms",
  "msid": "10021"
}