接口描述:

  • 查询会员基本信息和优惠券列表, 根据OpenId和支付金额

接口版本:

版本号 制定人 制定日期 修订日期
1.0.0 马腾飞 2019-09-30 2019-09-30

请求URL:

  • 商户接口URL:/api/member/memberInfoAndCoupons

请求方式:

  • GET
  • POST

请求参数:

参数名 是否必须 类型 说明
wxOpenId String 会员微信openId
payAmount String 会员需支付金额,单位:元, 当参数不为null将金额作为条件判断优惠券是否可用

返回参数说明:

参数名 类型 说明
code int 0
msg string success
data json 会员和优惠券信息

返回数据说明:

参数名 类型 说明
memberId Long 会员ID
memberNo String 会员卡号
memberName String 会员名称
tel String 手机号
sex int 性别:0-未知 1-男 2-女
birthday string 会员生日
balance Long 会员账户余额, 单位:分
points Long 会员可用积分
receiveCouponList Array 用户优惠券列表, 详见下表

优惠券列表说明:

参数名 类型 说明
couponId Long 优惠券ID
couponNo String 优惠券核销码
couponName String 优惠券名称
couponColor String 优惠券颜色
logoImgPath string logo地址
payAmountLimit Long 使用优惠券最低消费金额,单位:分
couponAmount Long 优惠金额,单位:分
couponDesc String 优惠信息格式化文字
validateEnd String 有效期至
usableFlag boolean 是否可用
unUsableMsg String 优惠券不可用描述信息(当usableFlag = false时 存在该字段)

返回示例:

{
  "code": 0,
  "msg": "success",
  "data": {
    "birthday": "1990-08-18",
    "memberNo": "WW00001",
    "balance": 10000,
    "sex": 1,
    "memberName": "张丹",
    "tel": "13300012311",
    "receiveCouponList": [
      {
        "couponName": "活动促销",
        "couponAmount": 100,
        "couponDesc": "满100.00元减1.00元",
        "couponNo": "FIDFJfdOFDJOUYj23424sdfFPDV",
        "validateEnd": "2019-10-02 15:08:04",
        "logoImgPath": "http://abc.com/123.jpg",
        "payAmountLimit": 10000,
        "usableFlag": false,
        "couponId": 1,
        "unUsableMsg": "适用门店不满足条件",
        "couponColor": "#fff000"
      }
    ],
    "memberId": 1,
    "points": 20
  }
}

备注:

当会员不存在时, 返回结果为空数据 {} , 如下:

{
  "code": 0,
  "msg": "success",
  "data": {}
}

-

文档更新时间: 2021-10-25 18:06   作者:刘正阳