Skip to main content

卡余额或权益查询

接口用途

  • 银行卡积分余额查询
  • 银行卡余额查询
  • 银行卡权益次数查询
  • 预付费卡余额查询
  • 会员卡积分或余额查询

交易流程说明

  • 该交易发至中间件后，中间件不会直接请求易百后台，而是先点亮MIS-POS，等待刷卡和输入密码，MIS-POS上确认后，中间件收到卡和密码信息再请求易百后台进行处理。

action

  • balance

请求参数，收银机===>中间件

字段类型是否必填字段意义备注
traceNoString是收银机流水号不允许重复
activityProductNoString否活动产品编号卡BIN不明确时必填，易百分配
memberDetailObject<memberDetail>否会员信息会员交易时必填

请求报文举例

{
    "traceNo": "99000009100010101732123",
    "activityProductNo": "HDCP00000000001236",
    "memberDetail": {
        "memberId": "M000001545",
        "memberName": "TONY",
        "grade": "1",
        "status": "1",
        "balance": 1000.00,
        "pointBalance": 30000
    }
}

返回参数，中间件===>收银机

字段类型是否必填字段意义备注
traceNoString是收银机流水号不允许重复
orderNoString是交易订单号单位：元
transDateString是交易时间格式为：YYYYmmddHHMMSS
returnCodeString是返回码00表示交易成功，其他表示失败
returnDescString是返回信息交易结果描述或错误原因
rightsTimesInteger是权益次数返回可以享受的权益次数
moneyBalancePrice是现金余额单位：元
pointBalancePrice是积分余额单位：分
printDetailObject<printDetail>否打印信息如需要在收银小票上打印信息时必填
memberDetailObject<memberDetail>否会员信息返回本次交易的会员信息

返回报文举例

{
    "traceNo": "99000009100010101732123",
    "orderNo": "171698602301",
    "transDate": "20161231120533",
    "returnCode": "00",
    "returnDesc": "SUCCESS",
    "rightsTimes": 1,
    "moneyBalance": 40.8,
    "pointBalance": 40000,
    "printDetail": {
        "cardNo64": "622562****8888",
        "bank": "中信银行",
        "paymentOrderNo": "201612315689412157458787",
        "pointSale": "0",
        "qrCode1": "htt://www.xxx.com/url",
        "qrCode2": "",
        "qrCode3": "",
        "barCode1": "12345679",
        "barCode2": "",
        "barCode3": ""
    },
    "memberDetail": {
        "memberId": "M000001545",
        "memberName": "TONY",
        "grade": "1",
        "status": "1",
        "balance": 1000.00,
        "pointBalance": 30000
    }
}
Back to top