# 卡余额或权益查询

#### **接口用途**

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

#### **交易流程说明**

- 该交易发至中间件后，中间件不会直接请求易百后台，而是先点亮[MIS-POS](https://book.e-buy.com/link/391#bkmrk-mis-pos "安装于商户门店内的POS机具，提供活动执行辅助及兑换功能")，等待刷卡和输入密码，[MIS-POS](https://book.e-buy.com/link/391#bkmrk-mis-pos "安装于商户门店内的POS机具，提供活动执行辅助及兑换功能")上确认后，中间件收到卡和密码信息再请求易百后台进行处理。

#### **action**

- `balance`

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

<table id="bkmrk-%E5%AD%97%E6%AE%B5-%E7%B1%BB%E5%9E%8B-%E6%98%AF%E5%90%A6%E5%BF%85%E5%A1%AB-%E5%AD%97%E6%AE%B5%E6%84%8F%E4%B9%89-%E5%A4%87%E6%B3%A8-t"><thead><tr><th>字段</th><th>类型</th><th>是否必填</th><th>字段意义</th><th>备注</th></tr></thead><tbody><tr><td>traceNo</td><td>String</td><td>是</td><td>收银机流水号</td><td>不允许重复</td></tr><tr><td>activityProductNo</td><td>String</td><td>否</td><td>活动产品编号</td><td>卡BIN不明确时必填，易百分配</td></tr><tr><td>memberDetail</td><td>Object&lt;[memberDetail](https://book.e-buy.com/books/ebuy-cashier-middleware-api/page/559cb "memberDetail")&gt;</td><td>否</td><td>会员信息</td><td>会员交易时必填</td></tr></tbody></table>

#### **请求报文举例**

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

```

#### **返回参数，中间件===&gt;收银机**

<table id="bkmrk-%E5%AD%97%E6%AE%B5-%E7%B1%BB%E5%9E%8B-%E6%98%AF%E5%90%A6%E5%BF%85%E5%A1%AB-%E5%AD%97%E6%AE%B5%E6%84%8F%E4%B9%89-%E5%A4%87%E6%B3%A8-t-0"><thead><tr><th>字段</th><th>类型</th><th>是否必填</th><th>字段意义</th><th>备注</th></tr></thead><tbody><tr><td>traceNo</td><td>String</td><td>是</td><td>收银机流水号</td><td>不允许重复</td></tr><tr><td>orderNo</td><td>String</td><td>是</td><td>交易订单号</td><td>单位：元</td></tr><tr><td>transDate</td><td>String</td><td>是</td><td>交易时间</td><td>格式为：YYYYmmddHHMMSS</td></tr><tr><td>returnCode</td><td>String</td><td>是</td><td>返回码</td><td>00表示交易成功，其他表示失败</td></tr><tr><td>returnDesc</td><td>String</td><td>是</td><td>返回信息</td><td>交易结果描述或错误原因</td></tr><tr><td>rightsTimes</td><td>Integer</td><td>是</td><td>权益次数</td><td>返回可以享受的权益次数</td></tr><tr><td>moneyBalance</td><td>Price</td><td>是</td><td>现金余额</td><td>单位：元</td></tr><tr><td>pointBalance</td><td>Price</td><td>是</td><td>积分余额</td><td>单位：分</td></tr><tr><td>printDetail</td><td>Object&lt;[printDetail](https://book.e-buy.com/books/ebuy-cashier-middleware-api/page/310dc "printDetail")&gt;</td><td>否</td><td>打印信息</td><td>如需要在收银小票上打印信息时必填</td></tr><tr><td>memberDetail</td><td>Object&lt;[memberDetail](https://book.e-buy.com/books/ebuy-cashier-middleware-api/page/559cb "memberDetail")&gt;</td><td>否</td><td>会员信息</td><td>返回本次交易的会员信息</td></tr></tbody></table>

#### **返回报文举例**

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