# 银行卡收单

- **接口用途**
    
    
    - 银行卡收单
    - 预付费卡消费
    
    **接口地址**
    
    
    - `https://ebuywebposp-test.e-buychina.com/ebuyweb-posp/api/cardPayment`
    
    **action**
    
    
    - `cardPayment`
    
    **请求参数，中件间===>易百后台**
    
    <table><thead><tr><th style="width: 137px;">字段</th><th style="width: 166px;">类型</th><th style="width: 45px;">是否必填</th><th style="width: 102px;">字段意义</th><th style="width: 317px;">备注</th></tr></thead><tbody><tr><td style="width: 137px;">traceNo</td><td style="width: 166px;">String</td><td style="width: 45px;">是</td><td style="width: 102px;">收银机流水号</td><td style="width: 317px;">不允许重复，必须以yyyyMMdd(当天)作为流水号开头+递增序列</td></tr><tr><td>onlineTid</td><td>String</td><td>否</td><td>线上对接使用的统一终端号</td><td>对接前需提前和易百技术沟通</td></tr><tr><td style="width: 137px;">totalAmount</td><td style="width: 166px;">Price</td><td style="width: 45px;">是</td><td style="width: 102px;">交易总金额</td><td style="width: 317px;">单位：元</td></tr><tr><td style="width: 137px;">undiscountAmount</td><td style="width: 166px;">Price</td><td style="width: 45px;">是</td><td style="width: 102px;">不可打折金额</td><td style="width: 317px;">单位：元</td></tr><tr><td style="width: 137px;">activityProductNo</td><td style="width: 166px;">String</td><td style="width: 45px;">否</td><td style="width: 102px;">活动产品编号</td><td style="width: 317px;">二次交互时填写</td></tr><tr><td style="width: 137px;">orderSubject</td><td style="width: 166px;">String</td><td style="width: 45px;">否</td><td style="width: 102px;">订单标题</td><td style="width: 317px;">最长256</td></tr><tr><td style="width: 137px;">orderDescription</td><td style="width: 166px;">String</td><td style="width: 45px;">否</td><td style="width: 102px;">订单描述</td><td style="width: 317px;">最长256</td></tr><tr><td style="width: 137px;">acquirer</td><td style="width: 166px;">String</td><td style="width: 45px;">是</td><td style="width: 102px;">收单机构</td><td style="width: 317px;">如：citicCashpay表示中信收单</td></tr><tr><td style="width: 137px;">request8583</td><td style="width: 166px;">String</td><td style="width: 45px;">否</td><td style="width: 102px;">请求报文HEX</td><td style="width: 317px;">[MIS-POS](https://book.e-buy.com/link/104#bkmrk-mis-pos "安装于商户门店内的POS机具，提供活动执行辅助及兑换功能")灌其他机构密钥，需要组包并填写该域</td></tr><tr><td style="width: 137px;">goodsDetail</td><td style="width: 166px;">List&lt;[goodsDetail](https://book.e-buy.com/books/e-buy-B6z/page/3def1 "goodsDetail")&gt;</td><td style="width: 45px;">是</td><td style="width: 102px;">产品明细</td><td style="width: 317px;">验证产品明细时必填</td></tr><tr><td style="width: 137px;">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: 102px;">卡信息</td><td style="width: 317px;"> </td></tr><tr><td style="width: 137px;">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: 102px;">会员信息</td><td style="width: 317px;">会员支付时必填</td></tr></tbody></table>
    
    **请求报文举例**
    
    ```
    {
        "traceNo": "9900000910001011820150201",
        "totalAmount": 40.8,
        "undiscountAmount": 0,
        "activityProductNo": "HDCP00000000001234",
        "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"
            }
        ],
        "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 style="height: 1215px;"><thead><tr style="height: 45px;"><th style="height: 45px; width: 127px;">字段</th><th style="height: 45px; width: 156px;">类型</th><th style="height: 45px; width: 50px;">是否必填</th><th style="height: 45px; width: 133px;">字段意义</th><th style="height: 45px; width: 299px;">备注</th></tr></thead><tbody><tr style="height: 31px;"><td style="height: 31px; width: 127px;">traceNo</td><td style="height: 31px; width: 156px;">String</td><td style="height: 31px; width: 50px;">是</td><td style="height: 31px; width: 133px;">收银机流水号</td><td style="height: 31px; width: 299px;">不允许重复,必须以yyyyMMdd(当天)作为流水号开头+递增序列</td></tr><tr style="height: 29px;"><td style="height: 29px; width: 127px;">orderNo</td><td style="height: 29px; width: 156px;">String</td><td style="height: 29px; width: 50px;">是</td><td style="height: 29px; width: 133px;">交易订单号</td><td style="height: 29px; width: 299px;">易百生成</td></tr><tr style="height: 29px;"><td style="height: 29px; width: 127px;">transDate</td><td style="height: 29px; width: 156px;">String</td><td style="height: 29px; width: 50px;">是</td><td style="height: 29px; width: 133px;">交易时间</td><td style="height: 29px; width: 299px;">格式为：yyyyMMddHHmmss</td></tr><tr style="height: 29px;"><td style="height: 29px; width: 127px;">returnCode</td><td style="height: 29px; width: 156px;">String</td><td style="height: 29px; width: 50px;">是</td><td style="height: 29px; width: 133px;">返回码</td><td style="height: 29px; width: 299px;">00表示交易成功，其他表示失败</td></tr><tr style="height: 29px;"><td style="height: 29px; width: 127px;">returnDesc</td><td style="height: 29px; width: 156px;">String</td><td style="height: 29px; width: 50px;">是</td><td style="height: 29px; width: 133px;">返回信息</td><td style="height: 29px; width: 299px;">交易结果描述或错误原因</td></tr><tr style="height: 45px;"><td style="height: 45px; width: 127px;">paidAmount</td><td style="height: 45px; width: 156px;">Price</td><td style="height: 45px; width: 50px;">是</td><td style="height: 45px; width: 133px;">支付成功总金额</td><td style="height: 45px; width: 299px;">面值，单位：元</td></tr><tr style="height: 45px;"><td style="height: 45px; width: 127px;">receiptAmount</td><td style="height: 45px; width: 156px;">Price</td><td style="height: 45px; width: 50px;">否</td><td style="height: 45px; width: 133px;">商户实收金额</td><td style="height: 45px; width: 299px;">净值，单位：元</td></tr><tr style="height: 45px;"><td style="height: 45px; width: 127px;">invoiceAmount</td><td style="height: 45px; width: 156px;">Price</td><td style="height: 45px; width: 50px;">否</td><td style="height: 45px; width: 133px;">商户开票金额</td><td style="height: 45px; width: 299px;">单位：元</td></tr><tr style="height: 29px;"><td style="height: 29px; width: 127px;">exchangeRate</td><td style="height: 29px; width: 156px;">Number(8,6)</td><td style="height: 29px; width: 50px;">否</td><td style="height: 29px; width: 133px;">汇率</td><td style="height: 29px; width: 299px;">1外币等于多少人民币</td></tr><tr style="height: 29px;"><td style="height: 29px; width: 127px;">currency</td><td style="height: 29px; width: 156px;">String</td><td style="height: 29px; width: 50px;">否</td><td style="height: 29px; width: 133px;">货币类型</td><td style="height: 29px; width: 299px;">例如:CNY</td></tr><tr style="height: 29px;"><td style="height: 29px; width: 127px;">discountCode</td><td style="height: 29px; width: 156px;">String</td><td style="height: 29px; width: 50px;">否</td><td style="height: 29px; width: 133px;">折扣编码</td><td style="height: 29px; width: 299px;">由收银机分配，用于入账计折扣类型</td></tr><tr style="height: 45px;"><td style="height: 45px; width: 127px;">discountNum</td><td style="height: 45px; width: 156px;">Number</td><td style="height: 45px; width: 50px;">否</td><td style="height: 45px; width: 133px;">固定金额折扣数量</td><td style="height: 45px; width: 299px;">用于入账计折扣类型的数量</td></tr><tr style="height: 45px;"><td style="height: 45px; width: 127px;">tenderCode</td><td style="height: 45px; width: 156px;">String</td><td style="height: 45px; width: 50px;">否</td><td style="height: 45px; width: 133px;">支付方式编码</td><td style="height: 45px; width: 299px;">由收银机分配，用于入账计支付方式</td></tr><tr style="height: 45px;"><td style="height: 45px; width: 127px;">activityProductNo</td><td style="height: 45px; width: 156px;">String</td><td style="height: 45px; width: 50px;">否</td><td style="height: 45px; width: 133px;">活动产品编号</td><td style="height: 45px; width: 299px;"> </td></tr><tr style="height: 45px;"><td style="height: 45px; width: 127px;">activityProductName</td><td style="height: 45px; width: 156px;">String</td><td style="height: 45px; width: 50px;">否</td><td style="height: 45px; width: 133px;">活动产品名称</td><td style="height: 45px; width: 299px;"> </td></tr><tr style="height: 45px;"><td style="height: 45px; width: 127px;">needSameCard</td><td style="height: 45px; width: 156px;">Boolean</td><td style="height: 45px; width: 50px;">否</td><td style="height: 45px; width: 133px;">同一张卡支付</td><td style="height: 45px; width: 299px;">如满额立减类活动，需要同一张银行卡支付剩余金额</td></tr><tr style="height: 51px;"><td style="height: 51px; width: 127px;">response8583</td><td style="height: 51px; width: 156px;">String</td><td style="height: 51px; width: 50px;">否</td><td style="height: 51px; width: 133px;">返回报文HEX</td><td style="height: 51px; width: 299px;">[MIS-POS](https://book.e-buy.com/link/104#bkmrk-mis-pos "安装于商户门店内的POS机具，提供活动执行辅助及兑换功能")灌其他机构密钥，后台透传该域。（部分收单业务占用此字段下发pos指令）</td></tr><tr style="height: 51px;"><td style="height: 51px; width: 127px;">goodsDetail</td><td style="height: 51px; width: 156px;">List&lt;[goodsDetail](https://book.e-buy.com/books/e-buy-B6z/page/3def1 "goodsDetail")&gt;</td><td style="height: 51px; width: 50px;">否</td><td style="height: 51px; width: 133px;">折抵产品明细</td><td style="height: 51px; width: 299px;">返回后台已抵扣成功的产品明细</td></tr><tr style="height: 57px;"><td style="height: 57px; width: 127px;">fundChannel</td><td style="height: 57px; width: 156px;">List&lt;[fundChannel](https://book.e-buy.com/books/e-buy-B6z/page/14bfa "fundChannel")&gt;</td><td style="height: 57px; width: 50px;">否</td><td style="height: 57px; width: 133px;">资金渠道</td><td style="height: 57px; width: 299px;"> </td></tr><tr style="height: 57px;"><td style="height: 57px; width: 127px;">printDetail</td><td style="height: 57px; width: 156px;">Object&lt;[printDetail](https://book.e-buy.com/books/e-buy-B6z/page/eed5a "printDetail")&gt;</td><td style="height: 57px; width: 50px;">否</td><td style="height: 57px; width: 133px;">打印信息</td><td style="height: 57px; width: 299px;">如需要在收银小票上打印信息时必填</td></tr><tr style="height: 51px;"><td style="height: 51px; width: 127px;">cardInfo</td><td style="height: 51px; width: 156px;">Object&lt;[cardInfo](https://book.e-buy.com/books/e-buy-B6z/page/6cdd6 "cardInfo")&gt;</td><td style="height: 51px; width: 50px;">否</td><td style="height: 51px; width: 133px;">卡信息</td><td style="height: 51px; width: 299px;">如果是IC卡，需要返回IC卡数据信息，用于IC卡检验</td></tr><tr style="height: 57px;"><td style="height: 57px; width: 127px;">memberDetail</td><td style="height: 57px; width: 156px;">Object&lt;[memberDetail](https://book.e-buy.com/books/e-buy-B6z/page/9fc3d "memberDetail")&gt;</td><td style="height: 57px; width: 50px;">否</td><td style="height: 57px; width: 133px;">会员信息</td><td style="height: 57px; width: 299px;">返回本次交易的会员信息</td></tr><tr style="height: 57px;"><td style="height: 57px; width: 127px;">voucherDetail</td><td style="height: 57px; width: 156px;">List&lt;[voucherDetail](https://book.e-buy.com/books/e-buy-B6z/page/8f855 "voucherDetail")&gt;</td><td style="height: 57px; width: 50px;">否</td><td style="height: 57px; width: 133px;">优惠券信息</td><td style="height: 57px; width: 299px;">返回本次交易的优惠券信息</td></tr><tr style="height: 48px;"><td style="height: 48px; width: 127px;">cashBank</td><td style="height: 48px; width: 156px;">String</td><td style="height: 48px; width: 50px;">否</td><td style="height: 48px; width: 133px;">收单机构编号</td><td style="height: 48px; width: 299px;">收单机构编号，详情参考[收单标识说明](https://book.e-buy.com/books/e-buy-B6z/page/821fa)</td></tr><tr style="height: 45px;"><td style="height: 45px; width: 127px;">cashOrderNo</td><td style="height: 45px; width: 156px;">String</td><td style="height: 45px; width: 50px;">否</td><td style="height: 45px; width: 133px;">收单机构订单号</td><td style="height: 45px; width: 299px;">反交易时下发</td></tr><tr style="height: 45px;"><td style="height: 45px; width: 127px;">cashAmount</td><td style="height: 45px; width: 156px;">Price</td><td style="height: 45px; width: 50px;">否</td><td style="height: 45px; width: 133px;">收单实际金额</td><td style="height: 45px; width: 299px;">pos机请求收单机构时使用的金额</td></tr><tr style="height: 57px;"><td style="height: 57px; width: 127px;">purchaseOrder</td><td style="height: 57px; width: 156px;">List&lt;[purchaseOrder](https://book.e-buy.com/books/e-buy-B6z/page/218a0)&gt;</td><td style="height: 57px; width: 50px;">否</td><td style="height: 57px; width: 133px;">收单签购单内容</td><td style="height: 57px; width: 299px;">[签购单信息](https://book.e-buy.com/books/e-buy-B6z/page/218a0)</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.00,
            "pointBalance": 30000
        },
        "voucherDetail": [
            {
                "voucherId": "001",
                "voucherName": "现金优惠券",
                "voucherType": "现金",
                "voucherCode": "123456789",
                "channelAmount": "20.8"
            },
            {
                "voucherId": "002",
                "voucherName": "买一赠一优惠券",
                "voucherType": "买赠",
                "voucherCode": "1232136781",
                "channelAmount": "20.8"
            }
        ]
    }
    ```