# 实体卡权益积分兑换

### **接口用途**

- 银行积分兑换
- 银行积分兑换+现金支付
- 银行权益验证
- 银行权益验证+现金支付
- 会员卡消费

### **接口地址**

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

### **action**

- `cardRedemption` 网关查询当前卡号下允许参加的积分、权益活动列表
- `cardPoint` 网关查询当前卡号下允许参加的积分活动列表
- `cardAuth` 网关查询当前卡号下允许参加的权益活动列表

**请求参数，中件间===>易百后台**

<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: 142px;">字段</th><th style="width: 168px;">类型</th><th style="width: 83px;">是否必填</th><th style="width: 111px;">字段意义</th><th style="width: 305px;">备注</th></tr></thead><tbody><tr><td style="width: 142px;">traceNo</td><td style="width: 168px;">String</td><td style="width: 83px;">是</td><td style="width: 111px;">收银机流水号</td><td style="width: 305px;">不允许重复，必须以yyyyMMdd(当天)作为流水号开头+递增序列</td></tr><tr><td>onlineTid</td><td>String</td><td>否</td><td>线上对接使用的统一终端号</td><td>对接前需提前和易百技术沟通</td></tr><tr><td style="width: 142px;">totalAmount</td><td style="width: 168px;">Price</td><td style="width: 83px;">是</td><td style="width: 111px;">交易总金额</td><td style="width: 305px;">单位：元</td></tr><tr><td style="width: 142px;">pointAmount</td><td style="width: 168px;">Price</td><td style="width: 83px;">否</td><td style="width: 111px;">积分抵扣金额</td><td style="width: 305px;">单位：元，默认与totalAmount一致表示整单金额采用积分抵扣</td></tr><tr><td style="width: 142px;">orderSubject</td><td style="width: 168px;">String</td><td style="width: 83px;">否</td><td style="width: 111px;">订单标题</td><td style="width: 305px;">最长256</td></tr><tr><td style="width: 142px;">orderDescription</td><td style="width: 168px;">String</td><td style="width: 83px;">否</td><td style="width: 111px;">订单描述</td><td style="width: 305px;">最长256</td></tr><tr><td style="width: 142px;">undiscountAmount</td><td style="width: 168px;">Price</td><td style="width: 83px;">是</td><td style="width: 111px;">不可打折金额</td><td style="width: 305px;">单位：元</td></tr><tr><td style="width: 142px;">activityProductNo</td><td style="width: 168px;">String</td><td style="width: 83px;">否</td><td style="width: 111px;">活动产品编号</td><td style="width: 305px;">二次交互时填写</td></tr><tr><td style="width: 142px;">goodsDetail</td><td style="width: 168px;">List&lt;[goodsDetail](https://book.e-buy.com/books/e-buy-B6z/page/3def1 "goodsDetail")&gt;</td><td style="width: 83px;">是</td><td style="width: 111px;">产品明细</td><td style="width: 305px;">验证产品明细时必填</td></tr><tr><td style="width: 142px;">cardInfo</td><td style="width: 168px;">Object&lt;[cardInfo](https://book.e-buy.com/books/e-buy-B6z/page/6cdd6 "cardInfo")&gt;</td><td style="width: 83px;">是</td><td style="width: 111px;">卡信息</td><td style="width: 305px;"> </td></tr><tr><td style="width: 142px;">memberDetail</td><td style="width: 168px;">Object&lt;[memberDetail](https://book.e-buy.com/books/e-buy-B6z/page/9fc3d "memberDetail")&gt;</td><td style="width: 83px;">否</td><td style="width: 111px;">会员信息</td><td style="width: 305px;">会员支付时必填</td></tr><tr><td>extendData</td><td>Object</td><td>否</td><td>扩展信息</td><td>特殊场景填值需与易百技术沟通(目前只在星巴克商户用到透传goodsTag)</td></tr></tbody></table>

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

```
{
    "traceNo": "99000009100010101732123",
    "totalAmount": 40.8,
    "undiscountAmount": 0,
    "activityProductNo": "HDCP00000000001234",
    "goodsDetail": [
        {
            "goodsCategory": "001",
            "goodsId": "P00001",
            "goodsName": "牙膏",
            "price": 8,
            "quantity": 2,
            "rebateCode": "000"
        },
        {
            "goodsCategory": "101",
            "goodsId": "P00002",
            "goodsName": "洗发水",
            "price": 24.8,
            "quantity": 1,
            "rebateCode": "000"
        }
    ],
    "cardInfo": {
        "cardNo": "",
        "password": "",
        "valid": "",
        "track1": "",
        "track2": "",
        "track3": "",
        "cardSn": "",
        "icData": ""
    },
    "memberDetail": {
        "memberId": "M000001545",
        "memberName": "TONY",
        "grade": "1",
        "status": "1",
        "balance": 1000.00,
        "pointBalance": 30000
    }
}

```

**返回参数，易百后台===&gt;中件间**

- 可能返回[活动产品选项](https://book.e-buy.com/books/e-buy-B6z/page/5b8ad-xEt "活动产品选项")，需要进行选择

<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: 153px;">字段</th><th style="width: 167px;">类型</th><th style="width: 48px;">是否必填</th><th style="width: 131px;">字段意义</th><th style="width: 310px;">备注</th></tr></thead><tbody><tr><td style="width: 153px;">traceNo</td><td style="width: 167px;">String</td><td style="width: 48px;">是</td><td style="width: 131px;">收银机流水号</td><td style="width: 310px;">不允许重复</td></tr><tr><td style="width: 153px;">orderNo</td><td style="width: 167px;">String</td><td style="width: 48px;">是</td><td style="width: 131px;">交易订单号</td><td style="width: 310px;">易百生成</td></tr><tr><td style="width: 153px;">transDate</td><td style="width: 167px;">String</td><td style="width: 48px;">是</td><td style="width: 131px;">交易时间</td><td style="width: 310px;">格式为：yyyyMMddHHmmss</td></tr><tr><td style="width: 153px;">returnCode</td><td style="width: 167px;">String</td><td style="width: 48px;">是</td><td style="width: 131px;">返回码</td><td style="width: 310px;">00表示交易成功，其他表示失败</td></tr><tr><td style="width: 153px;">returnDesc</td><td style="width: 167px;">String</td><td style="width: 48px;">是</td><td style="width: 131px;">返回信息</td><td style="width: 310px;">交易结果描述或错误原因</td></tr><tr><td style="width: 153px;">paidAmount</td><td style="width: 167px;">Price</td><td style="width: 48px;">是</td><td style="width: 131px;">支付成功总金额</td><td style="width: 310px;">面值，单位：元</td></tr><tr><td style="width: 153px;">receiptAmount</td><td style="width: 167px;">Price</td><td style="width: 48px;">否</td><td style="width: 131px;">商户实收金额</td><td style="width: 310px;">净值，单位：元</td></tr><tr><td style="width: 153px;">invoiceAmount</td><td style="width: 167px;">Price</td><td style="width: 48px;">否</td><td style="width: 131px;">商户开票金额</td><td style="width: 310px;">单位：元</td></tr><tr><td style="width: 153px;">exchangeRate</td><td style="width: 167px;">Number(8,6)</td><td style="width: 48px;">否</td><td style="width: 131px;">汇率</td><td style="width: 310px;">1外币等于多少人民币</td></tr><tr><td style="width: 153px;">currency</td><td style="width: 167px;">String</td><td style="width: 48px;">否</td><td style="width: 131px;">货币类型</td><td style="width: 310px;">例如:CNY</td></tr><tr><td style="width: 153px;">discountCode</td><td style="width: 167px;">String</td><td style="width: 48px;">否</td><td style="width: 131px;">折扣编码</td><td style="width: 310px;">由收银机分配，用于入账计折扣类型</td></tr><tr><td style="width: 153px;">discountNum</td><td style="width: 167px;">Number</td><td style="width: 48px;">否</td><td style="width: 131px;">固定金额折扣数量</td><td style="width: 310px;">用于入账计折扣类型的数量</td></tr><tr><td style="width: 153px;">tenderCode</td><td style="width: 167px;">String</td><td style="width: 48px;">否</td><td style="width: 131px;">支付方式编码</td><td style="width: 310px;">由收银机分配，用于入账计支付方式</td></tr><tr><td style="width: 153px;">activityProductNo</td><td style="width: 167px;">String</td><td style="width: 48px;">否</td><td style="width: 131px;">活动产品编号</td><td style="width: 310px;"> </td></tr><tr><td style="width: 153px;">activityProductName</td><td style="width: 167px;">String</td><td style="width: 48px;">否</td><td style="width: 131px;">活动产品名称</td><td style="width: 310px;"> </td></tr><tr><td style="width: 153px;">needSameCard</td><td style="width: 167px;">Boolean</td><td style="width: 48px;">否</td><td style="width: 131px;">同一张卡支付</td><td style="width: 310px;">如满额立减类活动，需要同一张银行卡支付剩余金额</td></tr><tr><td style="width: 153px;">goodsDetail</td><td style="width: 167px;">List&lt;[goodsDetail](https://book.e-buy.com/books/e-buy-B6z/page/3def1 "goodsDetail")&gt;</td><td style="width: 48px;">否</td><td style="width: 131px;">折抵产品明细</td><td style="width: 310px;">返回后台已抵扣成功的产品明细</td></tr><tr><td style="width: 153px;">fundChannel</td><td style="width: 167px;">List&lt;[fundChannel](https://book.e-buy.com/books/e-buy-B6z/page/14bfa "fundChannel")&gt;</td><td style="width: 48px;">否</td><td style="width: 131px;">资金渠道</td><td style="width: 310px;"> </td></tr><tr><td style="width: 153px;">printDetail</td><td style="width: 167px;">Object&lt;[printDetail](https://book.e-buy.com/books/e-buy-B6z/page/eed5a "printDetail")&gt;</td><td style="width: 48px;">否</td><td style="width: 131px;">打印信息</td><td style="width: 310px;">如需要在收银小票上打印信息时必填</td></tr><tr><td style="width: 153px;">cardInfo</td><td style="width: 167px;">Object&lt;[cardInfo](https://book.e-buy.com/books/e-buy-B6z/page/6cdd6 "cardInfo")&gt;</td><td style="width: 48px;">否</td><td style="width: 131px;">卡信息</td><td style="width: 310px;">如果是IC卡，需要返回IC卡数据信息，用于IC卡检验</td></tr><tr><td style="width: 153px;">memberDetail</td><td style="width: 167px;">Object&lt;[memberDetail](https://book.e-buy.com/books/e-buy-B6z/page/9fc3d "memberDetail")&gt;</td><td style="width: 48px;">否</td><td style="width: 131px;">会员信息</td><td style="width: 310px;">返回本次交易的会员信息</td></tr><tr><td style="width: 153px;">voucherDetail</td><td style="width: 167px;">List&lt;[voucherDetail](https://book.e-buy.com/books/e-buy-B6z/page/8f855 "voucherDetail")&gt;</td><td style="width: 48px;">否</td><td style="width: 131px;">优惠券信息</td><td style="width: 310px;">返回本次交易的优惠券信息</td></tr><tr><td style="width: 153px;">purchaseOrder</td><td style="width: 167px;">List&lt;[purchaseOrder](https://book.e-buy.com/books/e-buy-B6z/page/218a0)&gt;</td><td style="width: 48px;">否</td><td style="width: 131px;">收单签购单信息</td><td style="width: 310px;">[签购单信息](https://book.e-buy.com/books/e-buy-B6z/page/218a0)</td></tr><tr><td style="width: 153px;">remainAmount</td><td style="width: 167px;">Number</td><td style="width: 48px;">否</td><td style="width: 131px;">消费后卡余额</td><td style="width: 310px;">单位：元</td></tr></tbody></table>

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

```
{
    "traceNo": "99000009100010101732123",
    "orderNo": "171698602301",
    "transDate": "20161231120533",
    "returnCode": "00",
    "returnDesc": "SUCCESS",
    "paidAmount": 40.8,
    "receiptAmount": 40.8,
    "invoiceAmount": 40.8,
    "exchangeRate": 6.0939,
    "currency": "CNY",
    "discountCode": "0001",
    "discountNum": 20,
    "tenderCode": "8001",
    "activityProductNo": "2016123101",
    "activityProductName": "中信365权益",
    "needSameCard": true,
    "goodsDetail": [
        {
            "goodsCategory": "001",
            "goodsId": "P00001",
            "goodsName": "牙膏",
            "price": 8,
            "quantity": 2,
            "rebateCode": "000",
            "activityNo": "2016123101",
            "memo": "100123456789"
        },
        {
            "goodsCategory": "101",
            "goodsId": "P00002",
            "goodsName": "洗发水",
            "price": 24.8,
            "quantity": 1,
            "rebateCode": "000",
            "activityNo": "2016123101",
            "memo": "100123456789"
        }
    ],
    "fundChannel": [
        {
            "channelNo": "001",
            "channelName": "用户实付现金",
            "channelAmount": "20.8"
        },
        {
            "channelNo": "002",
            "channelName": "用户积分支付",
            "channelAmount": "20"
        }
    ],
    "printDetail": {
        "cardNo64": "622562****8888",
        "bank": "中信银行",
        "paymentOrderNo": "201612315689412157458787",
        "pointSale": "20000",
        "qrCode1": "htt://www.api-location-url.com/url",
        "qrCode2": "",
        "qrCode3": "",
        "barCode1": "12345679",
        "barCode2": "",
        "barCode3": ""
    },
    "cardInfo": {
        "cardNo": "",
        "password": "",
        "valid": "",
        "track1": "",
        "track2": "",
        "track3": "",
        "cardSn": "",
        "icData": ""
    },
    "memberDetail": {
        "memberId": "M000001545",
        "memberName": "TONY",
        "grade": "1",
        "status": "1",
        "balance": 1000.00,
        "pointBalance": 30000
    },
    "voucherDetail": [
        {
            "voucherId": "001",
            "voucherName": "现金优惠券",
            "voucherType": "现金",
            "voucherCode": "123456789",
            "channelAmount": "20.8"
        },
        {
            "voucherId": "002",
            "voucherName": "买一赠一优惠券",
            "voucherType": "买赠",
            "voucherCode": "1232136781",
            "channelAmount": "20.8"
        }
    ]
}
```