# 卡余额或权益查询

### **接口用途**

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

### **接口地址**

- `https://ebuywebposp-test.e-buychina.com/ebuyweb-posp/api/balance`

### **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 style="width: 131px;">字段</th><th style="width: 166px;">类型</th><th style="width: 45px;">是否必填</th><th style="width: 141px;">字段意义</th><th style="width: 326px;">备注</th></tr></thead><tbody><tr><td style="width: 131px;">traceNo</td><td style="width: 166px;">String</td><td style="width: 45px;">是</td><td style="width: 141px;">收银机流水号</td><td style="width: 326px;">不允许重复,必须以yyyyMMdd(当天)作为流水号开头+递增序列</td></tr><tr><td>onlineTid</td><td>String</td><td>否</td><td>线上对接使用的统一终端号</td><td>对接前需提前和易百技术沟通</td></tr><tr><td style="width: 131px;">activityProductNo</td><td style="width: 166px;">String</td><td style="width: 45px;">否</td><td style="width: 141px;">活动产品编号</td><td style="width: 326px;">二次交互时填写</td></tr><tr><td style="width: 131px;">cardInfo</td><td style="width: 166px;">Object&lt;[cardInfo](https://book.e-buy.com/books/e-buy-B6z/page/6cdd6 "cardInfo")&gt;</td><td style="width: 45px;">是</td><td style="width: 141px;">卡信息</td><td style="width: 326px;"> </td></tr><tr><td style="width: 131px;">memberDetail</td><td style="width: 166px;">Object&lt;[memberDetail](https://book.e-buy.com/books/e-buy-B6z/page/9fc3d "memberDetail")&gt;</td><td style="width: 45px;">否</td><td style="width: 141px;">会员信息</td><td style="width: 326px;">会员交易时必填</td></tr></tbody></table>

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

```
{
    "traceNo": "99000009100010101732123",
    "activityProductNo": "HDCP00000000001236",
    "cardInfo": {
        "cardNo": "",
        "password": "",
        "valid": "",
        "track1": "",
        "track2": "",
        "track3": "",
        "cardSn": "",
        "icData": ""
    },
    "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 style="width: 116px;">字段</th><th style="width: 172px;">类型</th><th style="width: 53px;">是否必填</th><th style="width: 97px;">字段意义</th><th style="width: 371px;">备注</th></tr></thead><tbody><tr><td style="width: 116px;">traceNo</td><td style="width: 172px;">String</td><td style="width: 53px;">是</td><td style="width: 97px;">收银机流水号</td><td style="width: 371px;">不允许重复,必须以yyyyMMdd(当天)作为流水号开头+递增序列</td></tr><tr><td style="width: 116px;">orderNo</td><td style="width: 172px;">String</td><td style="width: 53px;">是</td><td style="width: 97px;">交易订单号</td><td style="width: 371px;">单位：元</td></tr><tr><td style="width: 116px;">transDate</td><td style="width: 172px;">String</td><td style="width: 53px;">是</td><td style="width: 97px;">交易时间</td><td style="width: 371px;">格式为：yyyyMMddHHmmss</td></tr><tr><td style="width: 116px;">returnCode</td><td style="width: 172px;">String</td><td style="width: 53px;">是</td><td style="width: 97px;">返回码</td><td style="width: 371px;">00表示交易成功，其他表示失败</td></tr><tr><td style="width: 116px;">returnDesc</td><td style="width: 172px;">String</td><td style="width: 53px;">是</td><td style="width: 97px;">返回信息</td><td style="width: 371px;">交易结果描述或错误原因</td></tr><tr><td style="width: 116px;">rightsTimes</td><td style="width: 172px;">Integer</td><td style="width: 53px;">是</td><td style="width: 97px;">权益次数</td><td style="width: 371px;">返回可以享受的权益次数</td></tr><tr><td style="width: 116px;">moneyBalance</td><td style="width: 172px;">Price</td><td style="width: 53px;">是</td><td style="width: 97px;">现金余额</td><td style="width: 371px;">单位：元</td></tr><tr><td style="width: 116px;">pointBalance</td><td style="width: 172px;">Price</td><td style="width: 53px;">是</td><td style="width: 97px;">积分余额</td><td style="width: 371px;">单位：分</td></tr><tr><td style="width: 116px;">printDetail</td><td style="width: 172px;">Object&lt;[printDetail](https://book.e-buy.com/books/e-buy-B6z/page/eed5a "printDetail")&gt;</td><td style="width: 53px;">否</td><td style="width: 97px;">打印信息</td><td style="width: 371px;">如需要在收银小票上打印信息时必填</td></tr><tr><td style="width: 116px;">memberDetail</td><td style="width: 172px;">Object&lt;[memberDetail](https://book.e-buy.com/books/e-buy-B6z/page/9fc3d "memberDetail")&gt;</td><td style="width: 53px;">否</td><td style="width: 97px;">会员信息</td><td style="width: 371px;">返回本次交易的会员信息</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.api-location-url.com/url",
        "qrCode2": "",
        "qrCode3": "",
        "barCode1": "12345679",
        "barCode2": "",
        "barCode3": ""
    },
    "memberDetail": {
        "memberId": "M000001545",
        "memberName": "TONY",
        "grade": "1",
        "status": "1",
        "balance": 1000.00,
        "pointBalance": 30000
    }
}
```