# 银行卡收单

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

- 该交易发至中间件后，中间件不会直接请求易百后台，而是先点亮[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**

- `cardPayment`

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

<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: 165px;">字段</th><th style="width: 197px;">类型</th><th style="width: 81px;">是否必填</th><th style="width: 137px;">字段意义</th><th style="width: 229px;">备注</th></tr></thead><tbody><tr><td style="width: 165px;">traceNo</td><td style="width: 197px;">String</td><td style="width: 81px;">是</td><td style="width: 137px;">收银机流水号</td><td style="width: 229px;">不允许重复，建议YYYYmmddHHMMSS+10位流水号</td></tr><tr><td style="width: 165px;">totalAmount</td><td style="width: 197px;">Price</td><td style="width: 81px;">是</td><td style="width: 137px;">交易总金额</td><td style="width: 229px;">单位：元</td></tr><tr><td style="width: 165px;">undiscountAmount</td><td style="width: 197px;">Price</td><td style="width: 81px;">是</td><td style="width: 137px;">不可打折金额</td><td style="width: 229px;">单位：元</td></tr><tr><td style="width: 165px;">acquirer</td><td style="width: 197px;">String</td><td style="width: 81px;">是</td><td style="width: 137px;">收单机构</td><td style="width: 229px;">如：citicCashpay表示中信收单</td></tr><tr><td style="width: 165px;">goodsDetail</td><td style="width: 197px;">List&lt;[goodsDetail](https://book.e-buy.com/books/ebuy-cashier-middleware-api/page/a0a08 "goodsDetail")&gt;</td><td style="width: 81px;">是</td><td style="width: 137px;">产品明细</td><td style="width: 229px;">验证产品明细时必填</td></tr><tr><td style="width: 165px;">memberDetail</td><td style="width: 197px;">Object&lt;[memberDetail](https://book.e-buy.com/books/ebuy-cashier-middleware-api/page/559cb "memberDetail")&gt;</td><td style="width: 81px;">否</td><td style="width: 137px;">会员信息</td><td style="width: 229px;">会员支付时必填</td></tr></tbody></table>

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

```
{
    "traceNo": "99000009100010101732123",
    "totalAmount": 40.8,
    "undiscountAmount": 0,
    "acquirer": "citicCashpay",
    "goodsDetail": [
        {
            "goodsCategory": "001",
            "goodsId": "P00001",
            "goodsName": "牙膏",
            "price": 8,
            "quantity": 2,
            "rebateCode": "000"
        },
        {
            "goodsCategory": "101",
            "goodsId": "P00002",
            "goodsName": "洗发水",
            "price": 24.8,
            "quantity": 1,
            "rebateCode": "000"
        }
    ],
    "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: 152px;">字段</th><th style="width: 172px;">类型</th><th style="width: 50px;">是否必填</th><th style="width: 129px;">字段意义</th><th style="width: 306px;">备注</th></tr></thead><tbody><tr><td style="width: 152px;">traceNo</td><td style="width: 172px;">String</td><td style="width: 50px;">是</td><td style="width: 129px;">收银机流水号</td><td style="width: 306px;">不允许重复</td></tr><tr><td style="width: 152px;">orderNo</td><td style="width: 172px;">String</td><td style="width: 50px;">是</td><td style="width: 129px;">交易订单号</td><td style="width: 306px;">易百生成</td></tr><tr><td style="width: 152px;">transDate</td><td style="width: 172px;">String</td><td style="width: 50px;">是</td><td style="width: 129px;">交易时间</td><td style="width: 306px;">格式为：YYYYmmddHHMMSS</td></tr><tr><td style="width: 152px;">returnCode</td><td style="width: 172px;">String</td><td style="width: 50px;">是</td><td style="width: 129px;">返回码</td><td style="width: 306px;">00表示交易成功，其他表示失败</td></tr><tr><td style="width: 152px;">returnDesc</td><td style="width: 172px;">String</td><td style="width: 50px;">是</td><td style="width: 129px;">返回信息</td><td style="width: 306px;">交易结果描述或错误原因</td></tr><tr><td style="width: 152px;">paidAmount</td><td style="width: 172px;">Price</td><td style="width: 50px;">是</td><td style="width: 129px;">支付成功总金额</td><td style="width: 306px;">面值，单位：元</td></tr><tr><td style="width: 152px;">receiptAmount</td><td style="width: 172px;">Price</td><td style="width: 50px;">否</td><td style="width: 129px;">商户实收金额</td><td style="width: 306px;">净值，单位：元</td></tr><tr><td style="width: 152px;">invoiceAmount</td><td style="width: 172px;">Price</td><td style="width: 50px;">否</td><td style="width: 129px;">商户开票金额</td><td style="width: 306px;">单位：元</td></tr><tr><td style="width: 152px;">exchangeRate</td><td style="width: 172px;">Number(8,6)</td><td style="width: 50px;">否</td><td style="width: 129px;">汇率</td><td style="width: 306px;">1外币等于多少人民币</td></tr><tr><td style="width: 152px;">currency</td><td style="width: 172px;">String</td><td style="width: 50px;">否</td><td style="width: 129px;">货币类型</td><td style="width: 306px;">例如:CNY</td></tr><tr><td style="width: 152px;">discountCode</td><td style="width: 172px;">String</td><td style="width: 50px;">否</td><td style="width: 129px;">折扣编码</td><td style="width: 306px;">由收银机分配，用于入账计折扣类型，如：2016120102|10.00表示折扣10元</td></tr><tr><td style="width: 152px;">discountNum</td><td style="width: 172px;">Number</td><td style="width: 50px;">否</td><td style="width: 129px;">固定金额折扣数量</td><td style="width: 306px;">用于入账计折扣类型的数量</td></tr><tr><td style="width: 152px;">tenderCode</td><td style="width: 172px;">String</td><td style="width: 50px;">否</td><td style="width: 129px;">支付方式编码</td><td style="width: 306px;">由收银机分配，用于入账计支付方式，如：2016120101|20.00表示支付20元</td></tr><tr><td style="width: 152px;">activityProductNo</td><td style="width: 172px;">String</td><td style="width: 50px;">否</td><td style="width: 129px;">活动产品编号</td><td style="width: 306px;"> </td></tr><tr><td style="width: 152px;">activityProductName</td><td style="width: 172px;">String</td><td style="width: 50px;">否</td><td style="width: 129px;">活动产品名称</td><td style="width: 306px;"> </td></tr><tr><td style="width: 152px;">needSameCard</td><td style="width: 172px;">Boolean</td><td style="width: 50px;">否</td><td style="width: 129px;">同一张卡支付</td><td style="width: 306px;">如满额立减类活动，需要同一张银行卡支付剩余金额</td></tr><tr><td style="width: 152px;">goodsDetail</td><td style="width: 172px;">List&lt;[goodsDetail](https://book.e-buy.com/books/ebuy-cashier-middleware-api/page/a0a08 "goodsDetail")&gt;</td><td style="width: 50px;">否</td><td style="width: 129px;">折抵产品明细</td><td style="width: 306px;">返回后台已抵扣成功的产品明细</td></tr><tr><td style="width: 152px;">fundChannel</td><td style="width: 172px;">List&lt;[fundChannel](https://book.e-buy.com/books/ebuy-cashier-middleware-api/page/e00da "fundChannel")&gt;</td><td style="width: 50px;">否</td><td style="width: 129px;">资金渠道</td><td style="width: 306px;"> </td></tr><tr><td style="width: 152px;">printDetail</td><td style="width: 172px;">Object&lt;[printDetail](https://book.e-buy.com/books/ebuy-cashier-middleware-api/page/310dc "printDetail")&gt;</td><td style="width: 50px;">否</td><td style="width: 129px;">打印信息</td><td style="width: 306px;">如需要在收银小票上打印信息时必填</td></tr><tr><td style="width: 152px;">memberDetail</td><td style="width: 172px;">Object&lt;[memberDetail](https://book.e-buy.com/books/ebuy-cashier-middleware-api/page/559cb "memberDetail")&gt;</td><td style="width: 50px;">否</td><td style="width: 129px;">会员信息</td><td style="width: 306px;">返回本次交易的会员信息</td></tr><tr><td style="width: 152px;">paymentExtra</td><td style="width: 172px;">Object&lt;[paymentDetail](https://book.e-buy.com/books/ebuy-cashier-middleware-api/page/b53b3 "payMentDetail")&gt;</td><td style="width: 50px;">否</td><td style="width: 129px;">收单信息</td><td style="width: 306px;">返回本次交易的收单信息</td></tr></tbody></table>

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

```
{
    "traceNo": "9900000910001011920150201", 
    "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": "00000000089349", 
    "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, 
        "pointBalance": 30000
    }, 
    "voucherDetail": [
        {
            "voucherId": "001", 
            "voucherName": "现金优惠券", 
            "voucherType": "现金", 
            "voucherCode": "123456789", 
            "channelAmount": "20.8"
        }, 
        {
            "voucherId": "002", 
            "voucherName": "买一赠一优惠券", 
            "voucherType": "买赠", 
            "voucherCode": "1232136781", 
            "channelAmount": "20.8"
        }
    ], 
    "paymentExtra": {
        "acqId": "0100", 
        "issuerId": "0200", 
        "cardType": "0001", 
        "cardOrgan": false, 
        "pan": "622562****8888", 
        "aid": "A000000333010101"
    }
}

```

<footer class="page-footer" id="bkmrk-"></footer>