# 交易类接口列表



# 银行卡收单

- **接口用途**
    
    
    - 银行卡收单
    - 预付费卡消费
    
    **接口地址**
    
    
    - `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"
            }
        ]
    }
    ```

# 实体卡权益积分兑换

### **接口用途**

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

### **接口地址**

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

### **action**

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

**请求参数，中件间===&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"><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/eccbc "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"
        }
    ]
}
```

# 二维码支付或兑换

<div id="bkmrk-%E6%8E%A5%E5%8F%A3%E7%94%A8%E9%80%94"><div>**接口用途**</div></div><div id="bkmrk-%E6%94%AF%E4%BB%98%E5%AE%9D%E6%94%AF%E4%BB%98-%E5%BE%AE%E4%BF%A1%E8%A2%AB%E6%89%AB%E6%94%AF%E4%BB%98-%E9%93%B6%E8%A1%8C%E4%BA%8C%E7%BB%B4%E7%A0%81%E6%94%AF%E4%BB%98"><div><div><div><div>- 支付宝支付
- 微信被扫支付
- 银行二维码支付(工行、中行、中信、浦发等)
- 银行二维码积分兑换(工行、中行、中信、浦发等)
- 银联立码付
- 百度支付
- 翼支付
- 其他二维码支付
- 电子凭证核销：产品券/代金券/折扣券/买N赠M券/立减券
- 外卖或自助点单订单码自动上屏

</div></div></div></div></div>### **接口地址**

<div id="bkmrk-https%3A%2F%2Febuywebposp-"><div><div><div><div>- `https://ebuywebposp-test.e-buychina.com/ebuyweb-posp/api/qrcodeSale`

</div></div></div></div></div>### **action**

<div id="bkmrk-qrcodesale"><div><div><div><div>- `qrcodeSale`

</div></div></div></div></div>**请求参数，中件间===&gt;易百后台**

<div 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"><table style="width: 809px; height: 440px;"><thead><tr style="height: 46px;"><th style="width: 139px; height: 46px;">字段</th><th style="width: 167px; height: 46px;">类型</th><th style="width: 59px; height: 46px;">是否必填</th><th style="width: 113px; height: 46px;">字段意义</th><th style="width: 331px; height: 46px;">备注</th></tr></thead><tbody><tr style="height: 46px;"><td style="width: 139px; height: 46px;">traceNo</td><td style="width: 167px; height: 46px;">String(40)</td><td style="width: 59px; height: 46px;">是</td><td style="width: 113px; height: 46px;">收银机流水号</td><td style="width: 331px; height: 46px;">不允许重复，必须以yyyyMMdd(当天)作为流水号开头+递增序列</td></tr><tr><td style="width: 139px;">onlineTid</td><td style="width: 167px;">String</td><td style="width: 59px;">否</td><td style="width: 113px;">线上对接使用的统一终端号</td><td style="width: 331px;">对接前需提前和易百技术沟通</td></tr><tr style="height: 29px;"><td style="width: 139px; height: 29px;">totalAmount</td><td style="width: 167px; height: 29px;">Price</td><td style="width: 59px; height: 29px;">是</td><td style="width: 113px; height: 29px;">交易总金额</td><td style="width: 331px; height: 29px;">单位：元</td></tr><tr style="height: 29px;"><td style="width: 139px; height: 29px;">undiscountAmount</td><td style="width: 167px; height: 29px;">Price</td><td style="width: 59px; height: 29px;">是</td><td style="width: 113px; height: 29px;">不可打折金额</td><td style="width: 331px; height: 29px;">单位：元 如无此金额时可填0</td></tr><tr style="height: 46px;"><td style="width: 139px; height: 46px;">verifyType</td><td style="width: 167px; height: 46px;">String</td><td style="width: 59px; height: 46px;">是</td><td style="width: 113px; height: 46px;">核销类型</td><td style="width: 331px; height: 46px;">请与易百技术确认，枚举值：online为线上场景，offline为线下POS场景</td></tr><tr style="height: 29px;"><td style="width: 139px; height: 29px;">activityProductNo</td><td style="width: 167px; height: 29px;">String</td><td style="width: 59px; height: 29px;">否</td><td style="width: 113px; height: 29px;">活动产品编号</td><td style="width: 331px; height: 29px;">二次交互时填写</td></tr><tr style="height: 29px;"><td style="width: 139px; height: 29px;">scene</td><td style="width: 167px; height: 29px;">String</td><td style="width: 59px; height: 29px;">否</td><td style="width: 113px; height: 29px;">支付场景</td><td style="width: 331px; height: 29px;">条码:bar\_code, 二维码:qr\_code</td></tr><tr style="height: 29px;"><td style="width: 139px; height: 29px;">orderSubject</td><td style="width: 167px; height: 29px;">String</td><td style="width: 59px; height: 29px;">否</td><td style="width: 113px; height: 29px;">订单标题</td><td style="width: 331px; height: 29px;">最长256</td></tr><tr style="height: 29px;"><td style="width: 139px; height: 29px;">orderDescription</td><td style="width: 167px; height: 29px;">String</td><td style="width: 59px; height: 29px;">否</td><td style="width: 113px; height: 29px;">订单描述</td><td style="width: 331px; height: 29px;">最长256</td></tr><tr><td style="width: 139px;">merchantOrderNo</td><td style="width: 167px;">String(30)</td><td style="width: 59px;">是</td><td style="width: 113px;">商户收银订单号</td><td style="width: 331px;">用于当笔交易对应到收银POS的订单，不能与traceNo值相同</td></tr><tr style="height: 29px;"><td style="width: 139px; height: 29px;">qrcode</td><td style="width: 167px; height: 29px;">String</td><td style="width: 59px; height: 29px;">是</td><td style="width: 113px; height: 29px;">二维码内容</td><td style="width: 331px; height: 29px;">串号、一维码或二维码内容</td></tr><tr style="height: 35px;"><td style="width: 139px; height: 35px;">goodsDetail</td><td style="width: 167px; height: 35px;">List&lt;[goodsDetail](https://book.e-buy.com/books/e-buy-B6z/page/3def1 "goodsDetail")&gt;</td><td style="width: 59px; height: 35px;">是</td><td style="width: 113px; height: 35px;">产品明细</td><td style="width: 331px; height: 35px;">验证产品明细时必填</td></tr><tr style="height: 35px;"><td style="width: 139px; height: 35px;">memberDetail</td><td style="width: 167px; height: 35px;">Object&lt;[memberDetail](https://book.e-buy.com/books/e-buy-B6z/page/9fc3d "memberDetail")&gt;</td><td style="width: 59px; height: 35px;">否</td><td style="width: 113px; height: 35px;">会员信息</td><td style="width: 331px; height: 35px;">会员支付时必填</td></tr><tr style="height: 29px;"><td style="width: 139px; height: 29px;">extendData</td><td style="width: 167px; height: 29px;">Object</td><td style="width: 59px; height: 29px;">否</td><td style="width: 113px; height: 29px;">扩展信息</td><td style="width: 331px; height: 29px;">特殊场景填值需与易百技术沟通</td></tr></tbody></table>

</div>### **请求报文举例**

```JSON
{
  "traceNo": "990000091000101620150201",
  "totalAmount": 40.8,
  "undiscountAmount": 0,
  "activityProductNo": "HDCP00000000001234",
  "qrcode": "280123121234567890",
  "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,
    "pointBalance": 30000
  },
  "extendData": {
    "orderId": "20211000101620150201",
    "rightsDetail": [
      {
        "snCode": "111111111xxxxxx"
      }
    ]
  }
}
```

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

<div id="bkmrk-%E5%8F%AF%E8%83%BD%E8%BF%94%E5%9B%9E%E6%B4%BB%E5%8A%A8%E4%BA%A7%E5%93%81%E9%80%89%E9%A1%B9%EF%BC%8C%E9%9C%80%E8%A6%81%E8%BF%9B%E8%A1%8C%E9%80%89%E6%8B%A9-%E5%AD%97%E6%AE%B5">- 可能返回[活动产品选项](https://book.e-buy.com/books/e-buy-B6z/page/5b8ad-xEt "活动产品选项")，需要进行选择

<table style="width: 99.7531%; height: 799.079px;"><thead><tr style="height: 46.5938px;"><th style="width: 18.0917%; height: 46.5938px;">字段</th><th style="width: 20.57%; height: 46.5938px;">类型</th><th style="width: 6.81537%; height: 46.5938px;">是否必填</th><th style="width: 15.9851%; height: 46.5938px;">字段意义</th><th style="width: 38.5378%; height: 46.5938px;">备注</th></tr></thead><tbody><tr style="height: 46.5938px;"><td style="width: 18.0917%; height: 46.5938px;">traceNo</td><td style="width: 20.57%; height: 46.5938px;">String</td><td style="width: 6.81537%; height: 46.5938px;">是</td><td style="width: 15.9851%; height: 46.5938px;">收银机流水号</td><td style="width: 38.5378%; height: 46.5938px;">不允许重复,必须以yyyyMMdd(当天)作为流水号开头+递增序列</td></tr><tr style="height: 29.7969px;"><td style="width: 18.0917%; height: 29.7969px;">orderNo</td><td style="width: 20.57%; height: 29.7969px;">String</td><td style="width: 6.81537%; height: 29.7969px;">是</td><td style="width: 15.9851%; height: 29.7969px;">交易订单号</td><td style="width: 38.5378%; height: 29.7969px;">易百生成</td></tr><tr style="height: 29.7969px;"><td style="width: 18.0917%; height: 29.7969px;">transDate</td><td style="width: 20.57%; height: 29.7969px;">String</td><td style="width: 6.81537%; height: 29.7969px;">是</td><td style="width: 15.9851%; height: 29.7969px;">交易时间</td><td style="width: 38.5378%; height: 29.7969px;">格式为：yyyyMMddHHmmss</td></tr><tr style="height: 29.7969px;"><td style="width: 18.0917%; height: 29.7969px;">returnCode</td><td style="width: 20.57%; height: 29.7969px;">String</td><td style="width: 6.81537%; height: 29.7969px;">是</td><td style="width: 15.9851%; height: 29.7969px;">返回码</td><td style="width: 38.5378%; height: 29.7969px;">00表示交易成功，其他表示失败</td></tr><tr style="height: 29.7969px;"><td style="width: 18.0917%; height: 29.7969px;">returnDesc</td><td style="width: 20.57%; height: 29.7969px;">String</td><td style="width: 6.81537%; height: 29.7969px;">是</td><td style="width: 15.9851%; height: 29.7969px;">返回信息</td><td style="width: 38.5378%; height: 29.7969px;">交易结果描述或错误原因</td></tr><tr style="height: 29.7969px;"><td style="width: 18.0917%; height: 29.7969px;">paidAmount</td><td style="width: 20.57%; height: 29.7969px;">Price</td><td style="width: 6.81537%; height: 29.7969px;">是</td><td style="width: 15.9851%; height: 29.7969px;">支付成功总金额</td><td style="width: 38.5378%; height: 29.7969px;">单位：元</td></tr><tr style="height: 29.7969px;"><td style="width: 18.0917%; height: 29.7969px;">receiptAmount</td><td style="width: 20.57%; height: 29.7969px;">Price</td><td style="width: 6.81537%; height: 29.7969px;">否</td><td style="width: 15.9851%; height: 29.7969px;">商户实收金额</td><td style="width: 38.5378%; height: 29.7969px;">单位：元</td></tr><tr style="height: 29.7969px;"><td style="width: 18.0917%; height: 29.7969px;">invoiceAmount</td><td style="width: 20.57%; height: 29.7969px;">Price</td><td style="width: 6.81537%; height: 29.7969px;">否</td><td style="width: 15.9851%; height: 29.7969px;">商户开票金额</td><td style="width: 38.5378%; height: 29.7969px;">单位：元</td></tr><tr style="height: 29.7969px;"><td style="width: 18.0917%; height: 29.7969px;">exchangeRate</td><td style="width: 20.57%; height: 29.7969px;">Number(8,6)</td><td style="width: 6.81537%; height: 29.7969px;">否</td><td style="width: 15.9851%; height: 29.7969px;">汇率</td><td style="width: 38.5378%; height: 29.7969px;">1外币等于多少人民币</td></tr><tr style="height: 29.7969px;"><td style="width: 18.0917%; height: 29.7969px;">currency</td><td style="width: 20.57%; height: 29.7969px;">String</td><td style="width: 6.81537%; height: 29.7969px;">否</td><td style="width: 15.9851%; height: 29.7969px;">货币类型</td><td style="width: 38.5378%; height: 29.7969px;">例如:CNY</td></tr><tr style="height: 29.7969px;"><td style="width: 18.0917%; height: 29.7969px;">discountCode</td><td style="width: 20.57%; height: 29.7969px;">String</td><td style="width: 6.81537%; height: 29.7969px;">否</td><td style="width: 15.9851%; height: 29.7969px;">折扣编码</td><td style="width: 38.5378%; height: 29.7969px;">由收银机分配，用于入账计折扣类型</td></tr><tr style="height: 29.7969px;"><td style="width: 18.0917%; height: 29.7969px;">discountNum</td><td style="width: 20.57%; height: 29.7969px;">Number</td><td style="width: 6.81537%; height: 29.7969px;">否</td><td style="width: 15.9851%; height: 29.7969px;">固定金额折扣数量</td><td style="width: 38.5378%; height: 29.7969px;">用于入账计折扣类型的数量</td></tr><tr style="height: 29.7969px;"><td style="width: 18.0917%; height: 29.7969px;">tenderCode</td><td style="width: 20.57%; height: 29.7969px;">String</td><td style="width: 6.81537%; height: 29.7969px;">否</td><td style="width: 15.9851%; height: 29.7969px;">支付方式编码</td><td style="width: 38.5378%; height: 29.7969px;">由收银机分配，用于入账计支付方式</td></tr><tr style="height: 46.5938px;"><td style="width: 18.0917%; height: 46.5938px;">remainTimes</td><td style="width: 20.57%; height: 46.5938px;">Number</td><td style="width: 6.81537%; height: 46.5938px;">是</td><td style="width: 15.9851%; height: 46.5938px;">券码当前可用次数</td><td style="width: 38.5378%; height: 46.5938px;">如果有限制每天使用多少次，代表当天可使用次数</td></tr><tr style="height: 29.7969px;"><td style="width: 18.0917%; height: 29.7969px;">activityProductNo</td><td style="width: 20.57%; height: 29.7969px;">String</td><td style="width: 6.81537%; height: 29.7969px;">否</td><td style="width: 15.9851%; height: 29.7969px;">活动产品编号</td><td style="width: 38.5378%; height: 29.7969px;">  
</td></tr><tr style="height: 29.7969px;"><td style="width: 18.0917%; height: 29.7969px;">activityProductName</td><td style="width: 20.57%; height: 29.7969px;">String</td><td style="width: 6.81537%; height: 29.7969px;">否</td><td style="width: 15.9851%; height: 29.7969px;">活动产品名称</td><td style="width: 38.5378%; height: 29.7969px;">  
</td></tr><tr style="height: 35.3906px;"><td style="width: 18.0917%; height: 35.3906px;">goodsDetail</td><td style="width: 20.57%; height: 35.3906px;">List&lt;[goodsDetail](https://book.e-buy.com/books/e-buy-B6z/page/3def1 "goodsDetail")&gt;</td><td style="width: 6.81537%; height: 35.3906px;">否</td><td style="width: 15.9851%; height: 35.3906px;">折抵产品明细</td><td style="width: 38.5378%; height: 35.3906px;">返回后台已抵扣成功的产品明细</td></tr><tr style="height: 35.3906px;"><td style="width: 18.0917%; height: 35.3906px;">fundChannel</td><td style="width: 20.57%; height: 35.3906px;">List&lt;[fundChannel](https://book.e-buy.com/books/e-buy-B6z/page/14bfa "fundChannel")&gt;</td><td style="width: 6.81537%; height: 35.3906px;">否</td><td style="width: 15.9851%; height: 35.3906px;">资金渠道</td><td style="width: 38.5378%; height: 35.3906px;">  
</td></tr><tr style="height: 35.3906px;"><td style="width: 18.0917%; height: 35.3906px;">printDetail</td><td style="width: 20.57%; height: 35.3906px;">Object&lt;[printDetail](https://book.e-buy.com/books/e-buy-B6z/page/eed5a "printDetail")&gt;</td><td style="width: 6.81537%; height: 35.3906px;">否</td><td style="width: 15.9851%; height: 35.3906px;">打印信息</td><td style="width: 38.5378%; height: 35.3906px;">如需要在收银小票上打印信息时必填</td></tr><tr style="height: 35.3906px;"><td style="width: 18.0917%; height: 35.3906px;">memberDetail</td><td style="width: 20.57%; height: 35.3906px;">Object&lt;[memberDetail](https://book.e-buy.com/books/e-buy-B6z/page/9fc3d "memberDetail")&gt;</td><td style="width: 6.81537%; height: 35.3906px;">否</td><td style="width: 15.9851%; height: 35.3906px;">会员信息</td><td style="width: 38.5378%; height: 35.3906px;">返回本次交易的会员信息</td></tr><tr style="height: 35.3906px;"><td style="width: 18.0917%; height: 35.3906px;">voucherDetail</td><td style="width: 20.57%; height: 35.3906px;">List&lt;[voucherDetail](https://book.e-buy.com/books/e-buy-B6z/page/8f855 "voucherDetail")&gt;</td><td style="width: 6.81537%; height: 35.3906px;">否</td><td style="width: 15.9851%; height: 35.3906px;">优惠券信息</td><td style="width: 38.5378%; height: 35.3906px;">返回本次交易的优惠券信息</td></tr><tr style="height: 29.7969px;"><td style="width: 18.0917%; height: 29.7969px;">remainAmount</td><td style="width: 20.57%; height: 29.7969px;">Number</td><td style="width: 6.81537%; height: 29.7969px;">否</td><td style="width: 15.9851%; height: 29.7969px;">消费后卡余额</td><td style="width: 38.5378%; height: 29.7969px;">单位：元</td></tr><tr style="height: 35.3906px;"><td style="width: 18.0917%; height: 35.3906px;">extendsData</td><td style="width: 20.57%; height: 35.3906px;">Object&lt;[extendsData](https://book.e-buy.com/books/e-buy-B6z/page/06905 "extendsData")&gt;</td><td style="width: 6.81537%; height: 35.3906px;">否</td><td style="width: 15.9851%; height: 35.3906px;">扩展信息</td><td style="width: 38.5378%; height: 35.3906px;">与ebuy约定</td></tr><tr><td style="width: 18.0917%;">transType</td><td style="width: 20.57%;">String</td><td style="width: 6.81537%;">是</td><td style="width: 15.9851%;">标识当笔交易类型</td><td style="width: 38.5378%;">下发alipayQrpay 表示 支付宝二维码支付业务</td></tr></tbody></table>

</div>### **返回报文举例**

```JSON
{
  "traceNo": "9900000910001011720150201",
  "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": "2016123102",
  "activityProductName": "支付宝支付",
  "transType": "alipayQrpay",
  "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",
    "paymentUser": "139****@163.com",
    "pointSale": "20000",
    "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,
    "pointBalance": 30000
  },
  "voucherDetail": [
    {
      "voucherId": "001",
      "voucherName": "现金优惠券",
      "voucherType": "现金",
      "voucherCode": "123456789",
      "channelAmount": "20.8"
    },
    {
      "voucherId": "002",
      "voucherName": "买一赠一优惠券",
      "voucherType": "买赠",
      "voucherCode": "1232136781",
      "channelAmount": "20.8"
    }
  ]
}
```

# 交易结果查询

### **接口用途**

- 在中间件未收到后台返回时，可以调用此接口查询原交易的状态。
- “电子凭证批量核销ecouponsVerify”交易目前不支持查询

### **接口地址**

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

### **action**

- `inquiry`

**请求参数，中件间===&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"><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>不允许重复,必须以yyyyMMdd(当天)作为流水号开头+递增序列</td></tr><tr><td>onlineTid</td><td>String</td><td>否</td><td>线上对接使用的统一终端号</td><td>对接前需提前和易百技术沟通</td></tr><tr><td>originalTraceNo</td><td>String</td><td>是</td><td>原收银机流水号</td><td>传入需要查询的原交易收银机流水号</td></tr><tr><td>originalDate</td><td>String</td><td>否</td><td>原交易日期</td><td>传入需要查询的原交易日期，不传默认为当天格式为yyyyMMdd</td></tr></tbody></table>

**请求报文举例**

```JSON
{
  "traceNo": "9900000910001014320150201",
  "originalTraceNo": "9900000910001014220150201",
  "originalDate": "20170912"
}
```

**返回参数，易百后台===&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: 154px;">字段</th><th style="width: 170px;">类型</th><th style="width: 45px;">是否必填</th><th style="width: 130px;">字段意义</th><th style="width: 308px;">备注</th></tr></thead><tbody><tr><td style="width: 154px;">traceNo</td><td style="width: 170px;">String</td><td style="width: 45px;">是</td><td style="width: 130px;">收银机流水号</td><td style="width: 308px;">不允许重复,必须以yyyyMMdd(当天)作为流水号开头+递增序列</td></tr><tr><td style="width: 154px;">orderNo</td><td style="width: 170px;">String</td><td style="width: 45px;">是</td><td style="width: 130px;">交易订单号</td><td style="width: 308px;">单位：元</td></tr><tr><td style="width: 154px;">transDate</td><td style="width: 170px;">String</td><td style="width: 45px;">是</td><td style="width: 130px;">交易时间</td><td style="width: 308px;">格式为：yyyyMMddHHmmss</td></tr><tr><td style="width: 154px;">returnCode</td><td style="width: 170px;">String</td><td style="width: 45px;">是</td><td style="width: 130px;">返回码</td><td style="width: 308px;">00表示交易成功，其他表示失败</td></tr><tr><td style="width: 154px;">returnDesc</td><td style="width: 170px;">String</td><td style="width: 45px;">是</td><td style="width: 130px;">返回信息</td><td style="width: 308px;">交易结果描述或错误原因</td></tr><tr><td style="width: 154px;">paidAmount</td><td style="width: 170px;">Price</td><td style="width: 45px;">是</td><td style="width: 130px;">支付成功总金额</td><td style="width: 308px;">单位：元</td></tr><tr><td style="width: 154px;">receiptAmount</td><td style="width: 170px;">Price</td><td style="width: 45px;">否</td><td style="width: 130px;">商户实收金额</td><td style="width: 308px;">单位：元</td></tr><tr><td style="width: 154px;">invoiceAmount</td><td style="width: 170px;">Price</td><td style="width: 45px;">否</td><td style="width: 130px;">商户开票金额</td><td style="width: 308px;">单位：元</td></tr><tr><td style="width: 154px;">exchangeRate</td><td style="width: 170px;">Number(8,6)</td><td style="width: 45px;">否</td><td style="width: 130px;">汇率</td><td style="width: 308px;">1外币等于多少人民币</td></tr><tr><td style="width: 154px;">currency</td><td style="width: 170px;">String</td><td style="width: 45px;">否</td><td style="width: 130px;">货币类型</td><td style="width: 308px;">例如:CNY</td></tr><tr><td style="width: 154px;">discountCode</td><td style="width: 170px;">String</td><td style="width: 45px;">否</td><td style="width: 130px;">折扣编码</td><td style="width: 308px;">由收银机分配，用于入账计折扣类型</td></tr><tr><td style="width: 154px;">discountNum</td><td style="width: 170px;">Number</td><td style="width: 45px;">否</td><td style="width: 130px;">固定金额折扣数量</td><td style="width: 308px;">用于入账计折扣类型的数量</td></tr><tr><td style="width: 154px;">tenderCode</td><td style="width: 170px;">String</td><td style="width: 45px;">否</td><td style="width: 130px;">支付方式编码</td><td style="width: 308px;">由收银机分配，用于入账计支付方式</td></tr><tr><td style="width: 154px;">activityProductNo</td><td style="width: 170px;">String</td><td style="width: 45px;">否</td><td style="width: 130px;">活动产品编号</td><td style="width: 308px;">  
</td></tr><tr><td style="width: 154px;">activityProductName</td><td style="width: 170px;">String</td><td style="width: 45px;">否</td><td style="width: 130px;">活动产品名称</td><td style="width: 308px;">  
</td></tr><tr><td style="width: 154px;">needSameCard</td><td style="width: 170px;">Boolean</td><td style="width: 45px;">否</td><td style="width: 130px;">同一张卡支付</td><td style="width: 308px;">如满额立减类活动，需要同一张银行卡支付剩余金额</td></tr><tr><td style="width: 154px;">goodsDetail</td><td style="width: 170px;">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: 130px;">折抵产品明细</td><td style="width: 308px;">返回后台已抵扣成功的产品明细</td></tr><tr><td style="width: 154px;">fundChannel</td><td style="width: 170px;">List&lt;[fundChannel](https://book.e-buy.com/books/e-buy-B6z/page/14bfa "fundChannel")&gt;</td><td style="width: 45px;">否</td><td style="width: 130px;">资金渠道</td><td style="width: 308px;">  
</td></tr><tr><td style="width: 154px;">printDetail</td><td style="width: 170px;">Object&lt;[printDetail](https://book.e-buy.com/books/e-buy-B6z/page/eed5a "printDetail")&gt;</td><td style="width: 45px;">否</td><td style="width: 130px;">打印信息</td><td style="width: 308px;">如需要在收银小票上打印信息时必填</td></tr><tr><td style="width: 154px;">memberDetail</td><td style="width: 170px;">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: 130px;">会员信息</td><td style="width: 308px;">返回本次交易的会员信息</td></tr><tr><td style="width: 154px;">voucherDetail</td><td style="width: 170px;">List&lt;[voucherDetail](https://book.e-buy.com/books/e-buy-B6z/page/8f855 "voucherDetail")&gt;</td><td style="width: 45px;">否</td><td style="width: 130px;">优惠券信息</td><td style="width: 308px;">返回本次交易的优惠券信息</td></tr><tr><td style="width: 154px;">extendsData</td><td style="width: 170px;">Object&lt;[extendsData](https://book.e-buy.com/books/e-buy-B6z/page/06905 "extendsData")&gt;</td><td style="width: 45px;">否</td><td style="width: 130px;">扩展信息</td><td style="width: 308px;">与ebuy约定</td></tr><tr><td style="width: 139px;">transType</td><td style="width: 167px;">String</td><td style="width: 59px;">是</td><td style="width: 113px;">标识当笔交易类型</td><td style="width: 331px;">下发alipayQrpay 表示 支付宝二维码支付业务</td></tr></tbody></table>

**返回报文举例**

```JSON
{
  "traceNo": "9900000910001014420150201",
  "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": "2016123102",
  "activityProductName": "支付宝支付",
  "transType": "alipayQrpay",
  "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": ""
  },
  "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"
    }
  ]
}
```

### **支持查询的交易**

- cardPayment
- cardRedemption
- qrcodeSale

# 当日撤销

### **接口用途**

- 需要对原交易整体撤销时，可以在原交易的同一天调用此接口。

### **接口地址**

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

### **action**

- `void`

**请求参数，中间件===&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"><thead><tr><th style="width: 119px;">字段</th><th style="width: 129px;">类型</th><th style="width: 53px;">是否必填</th><th style="width: 160px;">字段意义</th><th style="width: 347px;">备注</th></tr></thead><tbody><tr><td style="width: 119px;">traceNo</td><td style="width: 129px;">String</td><td style="width: 53px;">是</td><td style="width: 160px;">收银机流水号</td><td style="width: 347px;">不允许重复,必须以yyyyMMdd(当天)作为流水号开头+递增序列</td></tr><tr><td>onlineTid</td><td>String</td><td>否</td><td>线上对接使用的统一终端号</td><td>对接前需提前和易百技术沟通</td></tr><tr><td style="width: 119px;">originalTraceNo</td><td style="width: 129px;">String</td><td style="width: 53px;">是</td><td style="width: 160px;">原收银机流水号</td><td style="width: 347px;">传入需要撤销的原交易收银机流水号</td></tr><tr><td style="width: 119px;">isRollback</td><td style="width: 129px;">Boolean</td><td style="width: 53px;">是</td><td style="width: 160px;">标识本次请求是否为冲正交易(中间件发起)</td><td style="width: 347px;">冲正发起需要另起线程并且先返回收银机交易失败结果，再异步冲正</td></tr><tr><td style="width: 119px;">acquirer</td><td style="width: 129px;">String</td><td style="width: 53px;">否</td><td style="width: 160px;">收单机构</td><td style="width: 347px;">如：citicCashpay表示中信收单，如果收单撤销是必填的</td></tr><tr><td style="width: 119px;">cardInfo</td><td style="width: 129px;">Object&lt;[cardInfo](https://book.e-buy.com/books/e-buy-B6z/page/6cdd6 "cardInfo")&gt;</td><td style="width: 53px;">否</td><td style="width: 160px;">卡信息</td><td style="width: 347px;">卡支付类交易需要填入原交易卡信息</td></tr></tbody></table>

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

```JSON
{
  "traceNo": "9900000910001013220150201",
  "originalTraceNo": "9900000910001013120150201",
  "isRollback": false,
  "acquirer": "citicCashpay",
  "cardInfo": {
    "cardNo": "",
    "password": "",
    "valid": "",
    "track1": "",
    "track2": "",
    "track3": "",
    "cardSn": "",
    "icData": ""
  }
}
```

**返回参数，易百后台===&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: 110px;">字段</th><th style="width: 170px;">类型</th><th style="width: 47px;">是否必填</th><th style="width: 130px;">字段意义</th><th style="width: 352px;">备注</th></tr></thead><tbody><tr><td style="width: 110px;">traceNo</td><td style="width: 170px;">String</td><td style="width: 47px;">是</td><td style="width: 130px;">收银机流水号</td><td style="width: 352px;">不允许重复,必须以yyyyMMdd(当天)作为流水号开头+递增序列</td></tr><tr><td style="width: 110px;">orderNo</td><td style="width: 170px;">String</td><td style="width: 47px;">是</td><td style="width: 130px;">交易订单号</td><td style="width: 352px;">  
</td></tr><tr><td style="width: 110px;">transDate</td><td style="width: 170px;">String</td><td style="width: 47px;">是</td><td style="width: 130px;">交易时间</td><td style="width: 352px;">格式为：yyyyMMddHHmmss</td></tr><tr><td style="width: 110px;">returnCode</td><td style="width: 170px;">String</td><td style="width: 47px;">是</td><td style="width: 130px;">返回码</td><td style="width: 352px;">00表示交易成功，其他表示失败</td></tr><tr><td style="width: 110px;">returnDesc</td><td style="width: 170px;">String</td><td style="width: 47px;">是</td><td style="width: 130px;">返回信息</td><td style="width: 352px;">交易结果描述或错误原因</td></tr><tr><td style="width: 110px;">fundChannel</td><td style="width: 170px;">List&lt;[fundChannel](https://book.e-buy.com/books/e-buy-B6z/page/14bfa "fundChannel")&gt;</td><td style="width: 47px;">否</td><td style="width: 130px;">资金渠道</td><td style="width: 352px;">  
</td></tr><tr><td style="width: 110px;">printDetail</td><td style="width: 170px;">Object&lt;[printDetail](https://book.e-buy.com/books/e-buy-B6z/page/eed5a "printDetail")&gt;</td><td style="width: 47px;">否</td><td style="width: 130px;">打印信息</td><td style="width: 352px;">如需要在收银小票上打印信息时必填</td></tr><tr><td style="width: 110px;">memberDetail</td><td style="width: 170px;">Object&lt;[memberDetail](https://book.e-buy.com/books/e-buy-B6z/page/9fc3d "memberDetail")&gt;</td><td style="width: 47px;">否</td><td style="width: 130px;">会员信息</td><td style="width: 352px;">返回本次交易的会员信息</td></tr><tr><td style="width: 110px;">voucherDetail</td><td style="width: 170px;">List&lt;[voucherDetail](https://book.e-buy.com/books/e-buy-B6z/page/8f855 "voucherDetail")&gt;</td><td style="width: 47px;">否</td><td style="width: 130px;">优惠券信息</td><td style="width: 352px;">返回本次交易的优惠券信息</td></tr><tr><td style="width: 110px;">cashOrderNo</td><td style="width: 170px;">String</td><td style="width: 47px;">否</td><td style="width: 130px;">收单原流水号</td><td style="width: 352px;">收单撤销时返回</td></tr><tr><td style="width: 110px;">cashBank</td><td style="width: 170px;">String</td><td style="width: 47px;">否</td><td style="width: 130px;">收单机构标识</td><td style="width: 352px;">收单撤销时返回</td></tr><tr><td style="width: 110px;">purchaseOrder</td><td style="width: 170px;">List&lt;[purchaseOrder](https://book.e-buy.com/books/e-buy-B6z/page/218a0)&gt;</td><td style="width: 47px;">否</td><td style="width: 130px;">收单签购单信息</td><td style="width: 352px;">[签购单信息](https://book.e-buy.com/books/e-buy-B6z/page/218a0)</td></tr></tbody></table>

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

```JSON
{
  "traceNo": "9900000910001013420150201",
  "orderNo": "171698602301",
  "cashOrderNo": "000025",
  "cashBank": "40",
  "transDate": "20161231120533",
  "returnCode": "00",
  "returnDesc": "SUCCESS",
  "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": ""
  },
  "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"
    }
  ]
}
```

### **支持撤销的交易**

- cardPayment
- cardRedemption
- qrcodeSale

# 隔日退款

### **接口用途**

- 用户需要退款时，可以调用此接口，支持全额或部分退款（依赖支付机构的接口）。
- 不支持券核销类交易的退款，建议调用“当日撤销void”来支持

### **接口地址**

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

### **action**

- `refund`

**请求参数，中间件===&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"><thead><tr><th style="width: 119px;">字段</th><th style="width: 132px;">类型</th><th style="width: 54px;">是否必填</th><th style="width: 112px;">字段意义</th><th style="width: 392px;">备注</th></tr></thead><tbody><tr><td style="width: 119px;">traceNo</td><td style="width: 132px;">String</td><td style="width: 54px;">是</td><td style="width: 112px;">收银机流水号</td><td style="width: 392px;">不允许重复,必须以yyyyMMdd(当天)作为流水号开头+递增序列</td></tr><tr><td>onlineTid</td><td>String</td><td>否</td><td>线上对接使用的统一终端号</td><td>对接前需提前和易百技术沟通</td></tr><tr><td style="width: 119px;">originalTraceNo</td><td style="width: 132px;">String</td><td style="width: 54px;">是</td><td style="width: 112px;">原收银机流水号</td><td style="width: 392px;">传入需要退款的原交易收银机流水号</td></tr><tr><td style="width: 119px;">originalDate</td><td style="width: 132px;">String</td><td style="width: 54px;">否</td><td style="width: 112px;">原交易日期</td><td style="width: 392px;">传入需要退款的原交易日期，不传默认为当天格式为yyyyMMdd</td></tr><tr><td style="width: 119px;">refundAmount</td><td style="width: 132px;">Price</td><td style="width: 54px;">是</td><td style="width: 112px;">本次退款金额</td><td style="width: 392px;">单位：元</td></tr><tr><td style="width: 119px;">acquirer</td><td style="width: 132px;">String</td><td style="width: 54px;">否</td><td style="width: 112px;">收单机构</td><td style="width: 392px;">如：citicCashpay表示中信收单，如果收单撤销是必填的</td></tr><tr><td style="width: 119px;">cardInfo</td><td style="width: 132px;">Object&lt;[cardInfo](https://book.e-buy.com/books/e-buy-B6z/page/6cdd6 "cardInfo")&gt;</td><td style="width: 54px;">否</td><td style="width: 112px;">卡信息</td><td style="width: 392px;">卡支付类交易需要填入原交易卡信息</td></tr></tbody></table>

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

```JSON
{
  "traceNo": "9900000910001013920150201",
  "originalTraceNo": "9900000910001013820150201",
  "originalDate": "20170912",
  "refundAmount": 40.8,
  "acquirer": "citicCashpay",
  "cardInfo": {
    "cardNo": "",
    "password": "",
    "valid": "",
    "track1": "",
    "track2": "",
    "track3": "",
    "cardSn": "",
    "icData": ""
  }
}
```

**返回参数，易百后台===&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: 115px;">字段</th><th style="width: 172px;">类型</th><th style="width: 50px;">是否必填</th><th style="width: 142px;">字段意义</th><th style="width: 330px;">备注</th></tr></thead><tbody><tr><td style="width: 115px;">traceNo</td><td style="width: 172px;">String</td><td style="width: 50px;">是</td><td style="width: 142px;">收银机流水号</td><td style="width: 330px;">不允许重复,必须以yyyyMMdd(当天)作为流水号开头+递增序列</td></tr><tr><td style="width: 115px;">orderNo</td><td style="width: 172px;">String</td><td style="width: 50px;">是</td><td style="width: 142px;">交易订单号</td><td style="width: 330px;">  
</td></tr><tr><td style="width: 115px;">transDate</td><td style="width: 172px;">String</td><td style="width: 50px;">是</td><td style="width: 142px;">交易时间</td><td style="width: 330px;">格式为：yyyyMMddHHmmss</td></tr><tr><td style="width: 115px;">returnCode</td><td style="width: 172px;">String</td><td style="width: 50px;">是</td><td style="width: 142px;">返回码</td><td style="width: 330px;">00表示交易成功，其他表示失败</td></tr><tr><td style="width: 115px;">returnDesc</td><td style="width: 172px;">String</td><td style="width: 50px;">是</td><td style="width: 142px;">返回信息</td><td style="width: 330px;">交易结果描述或错误原因</td></tr><tr><td style="width: 115px;">refundAmount</td><td style="width: 172px;">Price</td><td style="width: 50px;">是</td><td style="width: 142px;">退款成功总金额</td><td style="width: 330px;">单位：元</td></tr><tr><td style="width: 115px;">fundChannel</td><td style="width: 172px;">List&lt;[fundChannel](https://book.e-buy.com/books/e-buy-B6z/page/14bfa "fundChannel")&gt;</td><td style="width: 50px;">否</td><td style="width: 142px;">资金渠道</td><td style="width: 330px;">  
</td></tr><tr><td style="width: 115px;">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: 50px;">否</td><td style="width: 142px;">打印信息</td><td style="width: 330px;">如需要在收银小票上打印信息时必填</td></tr><tr><td style="width: 115px;">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: 50px;">否</td><td style="width: 142px;">会员信息</td><td style="width: 330px;">返回本次交易的会员信息</td></tr><tr><td style="width: 115px;">voucherDetail</td><td style="width: 172px;">List&lt;[voucherDetail](https://book.e-buy.com/books/e-buy-B6z/page/8f855 "voucherDetail")&gt;</td><td style="width: 50px;">否</td><td style="width: 142px;">优惠券信息</td><td style="width: 330px;">返回本次交易的优惠券信息</td></tr><tr><td style="width: 115px;">cashOrderNo</td><td style="width: 172px;">String</td><td style="width: 50px;">否</td><td style="width: 142px;">收单原交易订单号</td><td style="width: 330px;">收单退款时返回</td></tr><tr><td style="width: 115px;">cashBank</td><td style="width: 172px;">String</td><td style="width: 50px;">否</td><td style="width: 142px;">收单机构标识</td><td style="width: 330px;">收单退款时返回</td></tr><tr><td style="width: 115px;">purchaseOrder</td><td style="width: 172px;">List&lt;[purchaseOrder](https://book.e-buy.com/books/e-buy-B6z/page/218a0)&gt;</td><td style="width: 50px;">否</td><td style="width: 142px;">收单签购单信息</td><td style="width: 330px;">[签购单信息](https://book.e-buy.com/books/e-buy-B6z/page/218a0)</td></tr></tbody></table>

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

```JSON
{
  "traceNo": "9900000910001014020150201",
  "orderNo": "171698602301",
  "cashOrderNo": "000025",
  "cashBank": "40",
  "transDate": "20161231120533",
  "returnCode": "00",
  "returnDesc": "SUCCESS",
  "refundAmount": 40.8,
  "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": ""
  },
  "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"
    }
  ]
}
```

### **支持退款的交易**

- cardPayment
- cardRedemption
- qrcodeSale

# 撤销或退款结果查询(接口处于设计开发中请勿对接)

### **接口用途**

- 在调用方未收到撤销或退款的后台返回时，可以调用此接口查询原撤销或退款交易的状态。

### **接口地址**

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

### **action**

- `reverseInquiry`

**请求参数，中件间===&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"><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>不允许重复,必须以yyyyMMdd(当天)作为流水号开头+递增序列</td></tr><tr><td>originalTraceNo</td><td>String</td><td>是</td><td>原收银机流水号</td><td>传入需要查询的原交易收银机流水号</td></tr></tbody></table>

**请求报文举例**

```JSON
{
  "traceNo": "9900000910001014320150201",
  "originalTraceNo": "9900000910001014220150201"
}
```

**返回参数，易百后台===&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: 154px;">字段</th><th style="width: 170px;">类型</th><th style="width: 45px;">是否必填</th><th style="width: 130px;">字段意义</th><th style="width: 308px;">备注</th></tr></thead><tbody><tr><td style="width: 154px;">traceNo</td><td style="width: 170px;">String</td><td style="width: 45px;">是</td><td style="width: 130px;">收银机流水号</td><td style="width: 308px;">不允许重复,必须以yyyyMMdd(当天)作为流水号开头+递增序列</td></tr><tr><td style="width: 154px;">orderNo</td><td style="width: 170px;">String</td><td style="width: 45px;">是</td><td style="width: 130px;">交易订单号</td><td style="width: 308px;">单位：元</td></tr><tr><td style="width: 154px;">transDate</td><td style="width: 170px;">String</td><td style="width: 45px;">是</td><td style="width: 130px;">交易时间</td><td style="width: 308px;">格式为：yyyyMMddHHmmss</td></tr><tr><td style="width: 154px;">returnCode</td><td style="width: 170px;">String</td><td style="width: 45px;">是</td><td style="width: 130px;">返回码</td><td style="width: 308px;">00表示交易成功，其他表示失败</td></tr><tr><td style="width: 154px;">returnDesc</td><td style="width: 170px;">String</td><td style="width: 45px;">是</td><td style="width: 130px;">返回信息</td><td style="width: 308px;">交易结果描述或错误原因</td></tr><tr><td style="width: 154px;">paidAmount</td><td style="width: 170px;">Price</td><td style="width: 45px;">是</td><td style="width: 130px;">支付成功总金额</td><td style="width: 308px;">单位：元</td></tr><tr><td style="width: 154px;">receiptAmount</td><td style="width: 170px;">Price</td><td style="width: 45px;">否</td><td style="width: 130px;">商户实收金额</td><td style="width: 308px;">单位：元</td></tr><tr><td style="width: 154px;">invoiceAmount</td><td style="width: 170px;">Price</td><td style="width: 45px;">否</td><td style="width: 130px;">商户开票金额</td><td style="width: 308px;">单位：元</td></tr><tr><td style="width: 154px;">refundAmount</td><td style="width: 170px;">Price</td><td style="width: 45px;">否</td><td style="width: 130px;">退款金额</td><td style="width: 308px;">单位：元 查询成功时会有该值返回</td></tr><tr><td style="width: 154px;">activityProductNo</td><td style="width: 170px;">String</td><td style="width: 45px;">否</td><td style="width: 130px;">活动产品编号</td><td style="width: 308px;">  
</td></tr><tr><td style="width: 154px;">activityProductName</td><td style="width: 170px;">String</td><td style="width: 45px;">否</td><td style="width: 130px;">活动产品名称</td><td style="width: 308px;">  
</td></tr><tr><td style="width: 154px;">printDetail</td><td style="width: 170px;">Object&lt;[printDetail](https://book.e-buy.com/books/e-buy-B6z/page/eed5a "printDetail")&gt;</td><td style="width: 45px;">否</td><td style="width: 130px;">打印信息</td><td style="width: 308px;">如需要在收银小票上打印信息时必填</td></tr><tr><td style="width: 154px;">extendsData</td><td style="width: 170px;">Object&lt;[extendsData](https://book.e-buy.com/books/e-buy-B6z/page/06905 "extendsData")&gt;</td><td style="width: 45px;">否</td><td style="width: 130px;">扩展信息</td><td style="width: 308px;">与ebuy约定</td></tr></tbody></table>

**返回报文举例**

```JSON
{
  "extendsData": {},
  "returnCode": "00",
  "invoiceAmount": 0,
  "receiptAmount": 0,
  "printDetail": {
    "content": "00001F0E652D42757920B5E7D7D3C6BED6A42F0F726576657273652D696E7175697279"
  },
  "activityProductNo": "00000000503050",
  "transDate": "20220803162322",
  "activityProductName": "支付宝",
  "orderNo": "192070117798",
  "refundAmount": 0.01,
  "paidAmount": 0,
  "traceNo": "20220803162317100000000SH20501",
  "uuid": "d577d15662f84ce2bf4c2d928e7c21e5",
  "returnDesc": "交易成功",
  "step": "01",
  "rpcContext": "10.10.3.106:62774-->10.10.3.106:30200"
}
```

### **支持查询的交易**

- qrcodeSale(扫码支付类交易，目前仅支付宝2.0)

# 卡余额或权益查询

### **接口用途**

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

### **接口地址**

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

### **action**

- `balance`

**请求参数，中间件===&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"><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
    }
}
```

# 电子凭证查询

### **接口用途**

- 查询电子凭证的产品信息，可抵用的金额以及所属的活动，支持易百自有电子凭证和第三方电子凭证。

### **接口地址**

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

### **action**

- `ecouponInquiry`

**请求参数，中间件===&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"><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>不允许重复,必须以yyyyMMdd(当天)作为流水号开头+递增序列</td></tr><tr><td>onlineTid</td><td>String</td><td>否</td><td>线上对接使用的统一终端号</td><td>对接前需提前和易百技术沟通</td></tr><tr><td>qrcode</td><td>String</td><td>是</td><td>电子凭证号</td><td>要查询的电子凭证号</td></tr></tbody></table>

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

```JSON
{
    "traceNo": "9900000910001013620150201",
    "qrcode": "HDCP00000000001235"
}

```

**返回参数，易百后台===&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" style="width: 99.7531%; height: 392.206px;"><thead><tr style="height: 45.9191px;"><th style="width: 19.3069%; height: 45.9191px;">字段</th><th style="width: 19.802%; height: 45.9191px;">类型</th><th style="width: 6.55941%; height: 45.9191px;">是否必填</th><th style="width: 14.8515%; height: 45.9191px;">字段意义</th><th style="width: 39.3564%; height: 45.9191px;">备注</th></tr></thead><tbody><tr style="height: 45.9191px;"><td style="width: 19.3069%; height: 45.9191px;">traceNo</td><td style="width: 19.802%; height: 45.9191px;">String</td><td style="width: 6.55941%; height: 45.9191px;">是</td><td style="width: 14.8515%; height: 45.9191px;">收银机流水号</td><td style="width: 39.3564%; height: 45.9191px;">不允许重复,必须以yyyyMMdd(当天)作为流水号开头+递增序列</td></tr><tr style="height: 29.4485px;"><td style="width: 19.3069%; height: 29.4485px;">orderNo</td><td style="width: 19.802%; height: 29.4485px;">String</td><td style="width: 6.55941%; height: 29.4485px;">是</td><td style="width: 14.8515%; height: 29.4485px;">交易订单号</td><td style="width: 39.3564%; height: 29.4485px;">单位：元</td></tr><tr style="height: 29.4485px;"><td style="width: 19.3069%; height: 29.4485px;">transDate</td><td style="width: 19.802%; height: 29.4485px;">String</td><td style="width: 6.55941%; height: 29.4485px;">是</td><td style="width: 14.8515%; height: 29.4485px;">交易时间</td><td style="width: 39.3564%; height: 29.4485px;">格式为：yyyyMMddHHmmss</td></tr><tr style="height: 29.4485px;"><td style="width: 19.3069%; height: 29.4485px;">returnCode</td><td style="width: 19.802%; height: 29.4485px;">String</td><td style="width: 6.55941%; height: 29.4485px;">是</td><td style="width: 14.8515%; height: 29.4485px;">返回码</td><td style="width: 39.3564%; height: 29.4485px;">00，C3表示券码可用，其他表示不可用</td></tr><tr style="height: 29.4485px;"><td style="width: 19.3069%; height: 29.4485px;">returnDesc</td><td style="width: 19.802%; height: 29.4485px;">String</td><td style="width: 6.55941%; height: 29.4485px;">是</td><td style="width: 14.8515%; height: 29.4485px;">返回信息</td><td style="width: 39.3564%; height: 29.4485px;">交易结果描述或错误原因</td></tr><tr style="height: 29.4485px;"><td style="width: 19.3069%; height: 29.4485px;">canPayAmount</td><td style="width: 19.802%; height: 29.4485px;">Price</td><td style="width: 6.55941%; height: 29.4485px;">是</td><td style="width: 14.8515%; height: 29.4485px;">可抵用的总金额</td><td style="width: 39.3564%; height: 29.4485px;">单位：元</td></tr><tr style="height: 29.4485px;"><td style="width: 19.3069%; height: 29.4485px;">activityProductNo</td><td style="width: 19.802%; height: 29.4485px;">String</td><td style="width: 6.55941%; height: 29.4485px;">否</td><td style="width: 14.8515%; height: 29.4485px;">活动产品编号</td><td style="width: 39.3564%; height: 29.4485px;">该电子凭证所属的活动产品编号</td></tr><tr style="height: 29.4485px;"><td style="width: 19.3069%; height: 29.4485px;">activityProductName</td><td style="width: 19.802%; height: 29.4485px;">String</td><td style="width: 6.55941%; height: 29.4485px;">否</td><td style="width: 14.8515%; height: 29.4485px;">活动产品名称</td><td style="width: 39.3564%; height: 29.4485px;">该电子凭证所属的活动产品名称</td></tr><tr style="height: 29.4485px;"><td style="width: 19.3069%; height: 29.4485px;">useTimes</td><td style="width: 19.802%; height: 29.4485px;">int</td><td style="width: 6.55941%; height: 29.4485px;">否</td><td style="width: 14.8515%; height: 29.4485px;">总核销次数</td><td style="width: 39.3564%; height: 29.4485px;"> </td></tr><tr style="height: 29.4485px;"><td style="width: 19.3069%; height: 29.4485px;">remainTimes</td><td style="width: 19.802%; height: 29.4485px;">int</td><td style="width: 6.55941%; height: 29.4485px;">否</td><td style="width: 14.8515%; height: 29.4485px;">剩余可核销次数</td><td style="width: 39.3564%; height: 29.4485px;"> </td></tr><tr style="height: 35.3309px;"><td style="width: 19.3069%; height: 35.3309px;">extendsData</td><td style="width: 19.802%; height: 35.3309px;">Object&lt;[extendsData](https://book.e-buy.com/books/e-buy-B6z/page/06905 "extendsData")&gt;</td><td style="width: 6.55941%; height: 35.3309px;">否</td><td style="width: 14.8515%; height: 35.3309px;">扩展信息</td><td style="width: 39.3564%; height: 35.3309px;">与ebuy约定</td></tr></tbody></table>

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

```JSON
{
    "traceNo": "9900000910001013720150201",
    "orderNo": "171698602301",
    "transDate": "20161231120533",
    "returnCode": "00",
    "returnDesc": "SUCCESS",
    "canPayAmount": 40.8,
    "activityProductNo": "2016123101",
    "activityProductName": "中信365权益",
    "useTimes":10,
    "remainTimes":7
}
```

# 电子凭证预核销

### **接口用途**

- 预核销电子凭证，模拟电子凭证核销交易提前获取核销结果信息；

### **接口地址**

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

### **action**

- `ecouponPreVerify`

**请求参数，中间件===&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" style="width: 809px;"><thead><tr><th style="width: 138px;">字段</th><th style="width: 171px;">类型</th><th style="width: 54px;">是否必填</th><th style="width: 136px;">字段意义</th><th style="width: 310px;">备注</th></tr></thead><tbody><tr><td style="width: 138px;">traceNo</td><td style="width: 171px;">String</td><td style="width: 54px;">是</td><td style="width: 136px;">收银机流水号</td><td style="width: 310px;">不允许重复，必须以yyyyMMdd(当天)作为流水号开头+递增序列</td></tr><tr><td style="width: 138px;">onlineTid</td><td style="width: 171px;">String</td><td style="width: 54px;">否</td><td style="width: 136px;">线上对接使用的统一终端号</td><td style="width: 310px;">对接前需提前和易百技术沟通</td></tr><tr><td style="width: 138px;">totalAmount</td><td style="width: 171px;">Price</td><td style="width: 54px;">是</td><td style="width: 136px;">交易总金额</td><td style="width: 310px;">单位：元</td></tr><tr><td style="width: 138px;">undiscountAmount</td><td style="width: 171px;">Price</td><td style="width: 54px;">是</td><td style="width: 136px;">不可打折金额</td><td style="width: 310px;">单位：元，没有填写0</td></tr><tr><td style="width: 138px;">verifyType</td><td style="width: 171px;">String</td><td style="width: 54px;">是</td><td style="width: 136px;">核销类型</td><td style="width: 310px;">请与易百技术确认，枚举值：online为线上场景，offline为线下POS场景</td></tr><tr><td style="width: 138px;">activityProductNo</td><td style="width: 171px;">String</td><td style="width: 54px;">否</td><td style="width: 136px;">活动产品编号</td><td style="width: 310px;">二次交互时填写</td></tr><tr><td style="width: 138px;">scene</td><td style="width: 171px;">String</td><td style="width: 54px;">否</td><td style="width: 136px;">支付场景</td><td style="width: 310px;">条码:bar\_code, 二维码:qr\_code</td></tr><tr><td style="width: 138px;">orderSubject</td><td style="width: 171px;">String</td><td style="width: 54px;">否</td><td style="width: 136px;">订单标题</td><td style="width: 310px;">最长256</td></tr><tr><td style="width: 138px;">orderDescription</td><td style="width: 171px;">String</td><td style="width: 54px;">否</td><td style="width: 136px;">订单描述</td><td style="width: 310px;">最长256</td></tr><tr><td style="width: 138px;">qrcode</td><td style="width: 171px;">String</td><td style="width: 54px;">是</td><td style="width: 136px;">二维码内容</td><td style="width: 310px;">串号、一维码或二维码内容</td></tr><tr><td style="width: 138px;">goodsDetail</td><td style="width: 171px;">List&lt;[goodsDetail](https://book.e-buy.com/books/e-buy-B6z/page/3def1 "goodsDetail")&gt;</td><td style="width: 54px;">否</td><td style="width: 136px;">产品明细</td><td style="width: 310px;">验证产品明细时必填</td></tr><tr><td style="width: 138px;">memberDetail</td><td style="width: 171px;">Object&lt;[memberDetail](https://book.e-buy.com/books/e-buy-B6z/page/9fc3d "memberDetail")&gt;</td><td style="width: 54px;">否</td><td style="width: 136px;">会员信息</td><td style="width: 310px;">会员支付时必填</td></tr></tbody></table>

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

```JSON
{
  "traceNo": "9900000910001011320150201",
  "totalAmount": 40.8,
  "undiscountAmount": 0,
  "activityProductNo": "HDCP00000000001234",
  "qrcode": "280123121234567890",
  "lockTime": "300",
  "afterLock": "0",
  "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,
    "pointBalance": 30000
  }
}
```

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

- 可能返回[活动产品选项](https://gitbook.e-fuli.com/ebuy-cashier-integration-api/cn/api-list/transaction-api/prompt-options.html "活动产品选项")，需要进行选择

<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" style="height: 743px; width: 812px;"><thead><tr style="height: 29px;"><th style="width: 147px; height: 29px;">字段</th><th style="width: 167px; height: 29px;">类型</th><th style="width: 50px; height: 29px;">是否必填</th><th style="width: 149px; height: 29px;">字段意义</th><th style="width: 299px; height: 29px;">备注</th></tr></thead><tbody><tr style="height: 45px;"><td style="width: 147px; height: 45px;">traceNo</td><td style="width: 167px; height: 45px;">String</td><td style="width: 50px; height: 45px;">是</td><td style="width: 149px; height: 45px;">收银机流水号</td><td style="width: 299px; height: 45px;">不允许重复，必须以yyyyMMdd(当天)作为流水号开头+递增序列</td></tr><tr style="height: 29px;"><td style="width: 147px; height: 29px;">orderNo</td><td style="width: 167px; height: 29px;">String</td><td style="width: 50px; height: 29px;">是</td><td style="width: 149px; height: 29px;">交易订单号</td><td style="width: 299px; height: 29px;">易百生成</td></tr><tr style="height: 29px;"><td style="width: 147px; height: 29px;">transDate</td><td style="width: 167px; height: 29px;">String</td><td style="width: 50px; height: 29px;">是</td><td style="width: 149px; height: 29px;">交易时间</td><td style="width: 299px; height: 29px;">格式为：yyyyMMddHHmmss</td></tr><tr style="height: 29px;"><td style="width: 147px; height: 29px;">returnCode</td><td style="width: 167px; height: 29px;">String</td><td style="width: 50px; height: 29px;">是</td><td style="width: 149px; height: 29px;">返回码</td><td style="width: 299px; height: 29px;">00表示交易成功，其他表示失败</td></tr><tr style="height: 29px;"><td style="width: 147px; height: 29px;">returnDesc</td><td style="width: 167px; height: 29px;">String</td><td style="width: 50px; height: 29px;">是</td><td style="width: 149px; height: 29px;">返回信息</td><td style="width: 299px; height: 29px;">交易结果描述或错误原因</td></tr><tr style="height: 29px;"><td style="width: 147px; height: 29px;">paidAmount</td><td style="width: 167px; height: 29px;">Price</td><td style="width: 50px; height: 29px;">是</td><td style="width: 149px; height: 29px;">支付成功总金额</td><td style="width: 299px; height: 29px;">单位：元</td></tr><tr style="height: 29px;"><td style="width: 147px; height: 29px;">receiptAmount</td><td style="width: 167px; height: 29px;">Price</td><td style="width: 50px; height: 29px;">否</td><td style="width: 149px; height: 29px;">商户实收金额</td><td style="width: 299px; height: 29px;">单位：元</td></tr><tr style="height: 29px;"><td style="width: 147px; height: 29px;">invoiceAmount</td><td style="width: 167px; height: 29px;">Price</td><td style="width: 50px; height: 29px;">否</td><td style="width: 149px; height: 29px;">商户开票金额</td><td style="width: 299px; height: 29px;">单位：元</td></tr><tr style="height: 45px;"><td style="width: 147px; height: 45px;">remainTimes</td><td style="width: 167px; height: 45px;">Number</td><td style="width: 50px; height: 45px;">是</td><td style="width: 149px; height: 45px;">券码当前可用次数</td><td style="width: 299px; height: 45px;">如果有限制每天使用多少次，代表当天可使用次数｜</td></tr><tr style="height: 19px;"><td style="width: 147px; height: 19px;">lockTime</td><td style="width: 167px; height: 19px;">String</td><td style="width: 50px; height: 19px;">否</td><td style="width: 149px; height: 19px;">锁定时间,单位（秒）</td><td style="width: 299px; height: 19px;">默认：300</td></tr><tr style="height: 45px;"><td style="width: 147px; height: 45px;">afterLock</td><td style="width: 167px; height: 45px;">String</td><td style="width: 50px; height: 45px;">否</td><td style="width: 149px; height: 45px;">锁定和解锁，锁定：1，解锁：0</td><td style="width: 299px; height: 45px;">默认：1，锁定返回校验参数</td></tr><tr style="height: 29px;"><td style="width: 147px; height: 29px;">exchangeRate</td><td style="width: 167px; height: 29px;">Number(8,6)</td><td style="width: 50px; height: 29px;">否</td><td style="width: 149px; height: 29px;">汇率</td><td style="width: 299px; height: 29px;">1外币等于多少人民币</td></tr><tr style="height: 29px;"><td style="width: 147px; height: 29px;">currency</td><td style="width: 167px; height: 29px;">String</td><td style="width: 50px; height: 29px;">否</td><td style="width: 149px; height: 29px;">货币类型</td><td style="width: 299px; height: 29px;">例如:CNY</td></tr><tr style="height: 26px;"><td style="width: 147px; height: 26px;">discountCode</td><td style="width: 167px; height: 26px;">String</td><td style="width: 50px; height: 26px;">否</td><td style="width: 149px; height: 26px;">折扣编码</td><td style="width: 299px; height: 26px;">由收银机分配，用于入账计折扣类型和折扣金额</td></tr><tr style="height: 29px;"><td style="width: 147px; height: 29px;">discountNum</td><td style="width: 167px; height: 29px;">Number</td><td style="width: 50px; height: 29px;">否</td><td style="width: 149px; height: 29px;">固定金额折扣数量</td><td style="width: 299px; height: 29px;">用于入账计折扣类型的数量</td></tr><tr style="height: 45px;"><td style="width: 147px; height: 45px;">tenderCode</td><td style="width: 167px; height: 45px;">String</td><td style="width: 50px; height: 45px;">否</td><td style="width: 149px; height: 45px;">支付方式编码</td><td style="width: 299px; height: 45px;">由收银机分配，用于入账计支付方式和入账金额</td></tr><tr style="height: 29px;"><td style="width: 147px; height: 29px;">activityProductNo</td><td style="width: 167px; height: 29px;">String</td><td style="width: 50px; height: 29px;">否</td><td style="width: 149px; height: 29px;">活动产品编号</td><td style="width: 299px; height: 29px;">  
</td></tr><tr style="height: 29px;"><td style="width: 147px; height: 29px;">activityProductName</td><td style="width: 167px; height: 29px;">String</td><td style="width: 50px; height: 29px;">否</td><td style="width: 149px; height: 29px;">活动产品名称</td><td style="width: 299px; height: 29px;">  
</td></tr><tr style="height: 20px;"><td style="width: 147px; height: 20px;">goodsDetail</td><td style="width: 167px; height: 20px;">List&lt;[goodsDetail](https://book.e-buy.com/books/e-buy-B6z/page/3def1 "goodsDetail")&gt;</td><td style="width: 50px; height: 20px;">否</td><td style="width: 149px; height: 20px;">折抵产品明细</td><td style="width: 299px; height: 20px;">返回后台已抵扣成功的产品明细</td></tr><tr style="height: 23px;"><td style="width: 147px; height: 23px;">fundChannel</td><td style="width: 167px; height: 23px;">List&lt;[fundChannel](https://book.e-buy.com/books/e-buy-B6z/page/14bfa "fundChannel")&gt;</td><td style="width: 50px; height: 23px;">否</td><td style="width: 149px; height: 23px;">资金渠道</td><td style="width: 299px; height: 23px;">  
</td></tr><tr style="height: 15px;"><td style="width: 147px; height: 15px;">printDetail</td><td style="width: 167px; height: 15px;">Object&lt;[printDetail](https://book.e-buy.com/books/e-buy-B6z/page/eed5a "printDetail")&gt;</td><td style="width: 50px; height: 15px;">否</td><td style="width: 149px; height: 15px;">打印信息</td><td style="width: 299px; height: 15px;">如需要在收银小票上打印信息时必填</td></tr><tr style="height: 21px;"><td style="width: 147px; height: 21px;">memberDetail</td><td style="width: 167px; height: 21px;">Object&lt;[memberDetail](https://book.e-buy.com/books/e-buy-B6z/page/9fc3d "memberDetail")&gt;</td><td style="width: 50px; height: 21px;">否</td><td style="width: 149px; height: 21px;">会员信息</td><td style="width: 299px; height: 21px;">返回本次交易的会员信息</td></tr><tr style="height: 26px;"><td style="width: 147px; height: 26px;">voucherDetail</td><td style="width: 167px; height: 26px;">List&lt;[voucherDetail](https://book.e-buy.com/books/e-buy-B6z/page/8f855 "voucherDetail")&gt;</td><td style="width: 50px; height: 26px;">否</td><td style="width: 149px; height: 26px;">优惠券信息</td><td style="width: 299px; height: 26px;">返回本次交易的优惠券信息</td></tr><tr style="height: 36px;"><td style="width: 147px; height: 36px;">extendsData</td><td style="width: 167px; height: 36px;">Object&lt;[extendsData](https://book.e-buy.com/books/e-buy-B6z/page/06905 "extendsData")&gt;</td><td style="width: 50px; height: 36px;">否</td><td style="width: 149px; height: 36px;">扩展信息</td><td style="width: 299px; height: 36px;">与ebuy约定</td></tr></tbody></table>

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

```JSON
{
  "transDate": "20220726153110",
  "returnCode": "00",
  "extendsData": {},
  "orderNo": "191990113248",
  "ecouponsData": [
    {
      "desc": "操作成功",
      "status": "00",
      "invoiceAmount": 0,
      "code": "10010605284819524875",
      "receiptAmount": 10,
      "activityProductNo": "00000000503057",
      "transType": "whaleAuth",
      "activityProductName": "85°C10元代金券",
      "goodsDetail": [
        {
          "goodsSpec": "00",
          "goodsId": "A00001",
          "activityNo": "EB11060200",
          "price": 1000,
          "memo": "10010605284819524875",
          "quantity": 1
        }
      ],
      "totalAmount": 68,
      "paidAmount": 10,
      "fundChannel": [
        {
          "channelName": "用户实际支付",
          "channelAmount": 0,
          "channelNo": "user_real_money"
        }
      ]
    },
    {
      "desc": "操作成功",
      "status": "00",
      "invoiceAmount": 0,
      "code": "10010605171871824601",
      "receiptAmount": 10,
      "activityProductNo": "00000000503057",
      "transType": "whaleAuth",
      "activityProductName": "85°C10元代金券",
      "goodsDetail": [
        {
          "goodsSpec": "00",
          "goodsId": "A00001",
          "activityNo": "EB11060200",
          "price": 1000,
          "memo": "10010605171871824601",
          "quantity": 1
        }
      ],
      "totalAmount": 68,
      "paidAmount": 10,
      "fundChannel": [
        {
          "channelName": "用户实际支付",
          "channelAmount": 0,
          "channelNo": "user_real_money"
        }
      ]
    }
  ],
  "traceNo": "20220726153107100000000SH20501",
  "uuid": "f3c32fa32ccb4ccd8f38c36800741682",
  "returnDesc": "请求成功"
}
```

# 电子凭证批量核销

### **接口用途**

- 批量核销电子凭证，多张电子凭证核销交易；

### **接口地址**

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

### **action**

- `ecouponsVerify`

**请求参数，中间件===&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" style="width: 809px; height: 471.328px;"><thead><tr style="height: 46.5938px;"><th style="width: 137px; height: 46.5938px;">字段</th><th style="width: 179px; height: 46.5938px;">类型</th><th style="width: 51px; height: 46.5938px;">是否必填</th><th style="width: 130px; height: 46.5938px;">字段意义</th><th style="width: 312px; height: 46.5938px;">备注</th></tr></thead><tbody><tr style="height: 46.5938px;"><td style="width: 137px; height: 46.5938px;">traceNo</td><td style="width: 179px; height: 46.5938px;">String</td><td style="width: 51px; height: 46.5938px;">是</td><td style="width: 130px; height: 46.5938px;">收银机流水号</td><td style="width: 312px; height: 46.5938px;">不允许重复,必须以yyyyMMdd(当天)作为流水号开头+递增序列</td></tr><tr style="height: 46.5938px;"><td style="width: 137px; height: 46.5938px;">onlineTid</td><td style="width: 179px; height: 46.5938px;">String</td><td style="width: 51px; height: 46.5938px;">否</td><td style="width: 130px; height: 46.5938px;">线上对接使用的统一终端号</td><td style="width: 312px; height: 46.5938px;">对接前需提前和易百技术沟通</td></tr><tr style="height: 29.7969px;"><td style="width: 137px; height: 29.7969px;">totalAmount</td><td style="width: 179px; height: 29.7969px;">Price</td><td style="width: 51px; height: 29.7969px;">是</td><td style="width: 130px; height: 29.7969px;">交易总金额</td><td style="width: 312px; height: 29.7969px;">单位：元</td></tr><tr style="height: 29.7969px;"><td style="width: 137px; height: 29.7969px;">undiscountAmount</td><td style="width: 179px; height: 29.7969px;">Price</td><td style="width: 51px; height: 29.7969px;">是</td><td style="width: 130px; height: 29.7969px;">不可打折金额</td><td style="width: 312px; height: 29.7969px;">单位：元，没有填写0</td></tr><tr style="height: 46.5938px;"><td style="width: 137px; height: 46.5938px;">verifyType</td><td style="width: 179px; height: 46.5938px;">String</td><td style="width: 51px; height: 46.5938px;">是</td><td style="width: 130px; height: 46.5938px;">核销类型</td><td style="width: 312px; height: 46.5938px;">请与易百技术确认，枚举值：online为线上场景，offline为线下POS场景</td></tr><tr style="height: 29.7969px;"><td style="width: 137px; height: 29.7969px;">scene</td><td style="width: 179px; height: 29.7969px;">String</td><td style="width: 51px; height: 29.7969px;">否</td><td style="width: 130px; height: 29.7969px;">支付场景</td><td style="width: 312px; height: 29.7969px;">条码:bar\_code, 二维码:qr\_code</td></tr><tr style="height: 29.7969px;"><td style="width: 137px; height: 29.7969px;">orderSubject</td><td style="width: 179px; height: 29.7969px;">String</td><td style="width: 51px; height: 29.7969px;">否</td><td style="width: 130px; height: 29.7969px;">订单标题</td><td style="width: 312px; height: 29.7969px;">最长256</td></tr><tr style="height: 29.7969px;"><td style="width: 137px; height: 29.7969px;">orderDescription</td><td style="width: 179px; height: 29.7969px;">String</td><td style="width: 51px; height: 29.7969px;">否</td><td style="width: 130px; height: 29.7969px;">订单描述</td><td style="width: 312px; height: 29.7969px;">最长256</td></tr><tr style="height: 35.3906px;"><td style="width: 137px; height: 35.3906px;">ecoupons</td><td style="width: 179px; height: 35.3906px;">List&lt;[codeInfo](https://book.e-buy.com/books/e-buy-B6z/page/67c6a "codeInfo")&gt;</td><td style="width: 51px; height: 35.3906px;">是</td><td style="width: 130px; height: 35.3906px;">批量核销劵码</td><td style="width: 312px; height: 35.3906px;">批量核销必填,一次最多10张券</td></tr><tr style="height: 35.3906px;"><td style="width: 137px; height: 35.3906px;">goodsDetail</td><td style="width: 179px; height: 35.3906px;">List&lt;[goodsDetail](https://book.e-buy.com/books/e-buy-B6z/page/3def1 "goodsDetail")&gt;</td><td style="width: 51px; height: 35.3906px;">否</td><td style="width: 130px; height: 35.3906px;">产品明细</td><td style="width: 312px; height: 35.3906px;">验证产品明细时必填</td></tr><tr style="height: 35.3906px;"><td style="width: 137px; height: 35.3906px;">memberDetail</td><td style="width: 179px; height: 35.3906px;">Object&lt;[memberDetail](https://book.e-buy.com/books/e-buy-B6z/page/9fc3d "memberDetail")&gt;</td><td style="width: 51px; height: 35.3906px;">否</td><td style="width: 130px; height: 35.3906px;">会员信息</td><td style="width: 312px; height: 35.3906px;">会员支付时必填</td></tr></tbody></table>

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

```JSON
{
  "traceNo": "99000009100010101732123",
  "totalAmount": 40.8,
  "undiscountAmount": 0,
  "activityProductNo": "HDCP00000000001234",
  "qrcode": "280123121234567890",
  "lockTime": "300",
  "afterLock": "0",
  "ecoupons": [
    {
      "code": "10019041500000071521",
      "ext": "test"
    }
  ],
  "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,
    "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" style="width: 100%;"><thead><tr><th style="width: 12.7318%;">字段</th><th style="width: 19.0354%;">类型</th><th style="width: 8.03507%;">是否必填</th><th style="width: 15.4512%;">字段意义</th><th style="width: 44.8702%;">备注</th></tr></thead><tbody><tr><td style="width: 12.7318%;">traceNo</td><td style="width: 19.0354%;">String</td><td style="width: 8.03507%;">是</td><td style="width: 15.4512%;">收银机流水号</td><td style="width: 44.8702%;">不允许重复</td></tr><tr><td style="width: 12.7318%;">orderNo</td><td style="width: 19.0354%;">String</td><td style="width: 8.03507%;">是</td><td style="width: 15.4512%;">交易订单号</td><td style="width: 44.8702%;">易百生成</td></tr><tr><td style="width: 12.7318%;">transDate</td><td style="width: 19.0354%;">String</td><td style="width: 8.03507%;">是</td><td style="width: 15.4512%;">交易时间</td><td style="width: 44.8702%;">格式为：yyyyMMddHHmmss</td></tr><tr><td style="width: 12.7318%;">returnCode</td><td style="width: 19.0354%;">String</td><td style="width: 8.03507%;">是</td><td style="width: 15.4512%;">返回码</td><td style="width: 44.8702%;">00表示本次请求成功，并不代表所有码都核销成功</td></tr><tr><td style="width: 12.7318%;">returnDesc</td><td style="width: 19.0354%;">String</td><td style="width: 8.03507%;">是</td><td style="width: 15.4512%;">返回信息</td><td style="width: 44.8702%;">交易结果描述或错误原因</td></tr><tr><td style="width: 12.7318%;">ecouponsData</td><td style="width: 19.0354%;">List&lt;[ecouponsData](https://book.e-buy.com/books/e-buy-B6z/page/f4b9e "ecouponsData")&gt;</td><td style="width: 8.03507%;">是</td><td style="width: 15.4512%;">返回批量核销结果</td><td style="width: 44.8702%;">对应批量核销劵</td></tr><tr><td style="width: 12.7318%;">extendsData</td><td style="width: 19.0354%;">Object&lt;[extendsData](https://book.e-buy.com/books/e-buy-B6z/page/06905 "extendsData")&gt;</td><td style="width: 8.03507%;">是</td><td style="width: 15.4512%;">扩展信息</td><td style="width: 44.8702%;">与ebuy约定 allSuccess=false表示本次核销有券码核销失败</td></tr></tbody></table>

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

```JSON
{
  "transDate": "20220726153110",
  "returnCode": "00",
  "extendsData": {},
  "orderNo": "191990113248",
  "invoiceAmount": 0,
  "ecouponsData": [
    {
      "returnCode": "00",
      "desc": "操作成功",
      "status": "00",
      "invoiceAmount": 0,
      "code": "10010605284819524875",
      "receiptAmount": 10,
      "activityProductNo": "00000000503057",
      "transType": "whaleAuth",
      "activityProductName": "85°C10元代金券",
      "goodsDetail": [
        {
          "goodsSpec": "00",
          "goodsId": "A00001",
          "activityNo": "EB11060200",
          "price": 1000,
          "memo": "10010605284819524875",
          "quantity": 1
        }
      ],
      "totalAmount": 68,
      "paidAmount": 10,
      "fundChannel": [
        {
          "channelName": "用户实际支付",
          "channelAmount": 0,
          "channelNo": "user_real_money"
        }
      ]
    },
    {
      "returnCode": "00",
      "desc": "操作成功",
      "status": "00",
      "invoiceAmount": 0,
      "code": "10010605171871824601",
      "receiptAmount": 10,
      "activityProductNo": "00000000503057",
      "transType": "whaleAuth",
      "activityProductName": "85°C10元代金券",
      "goodsDetail": [
        {
          "goodsSpec": "00",
          "goodsId": "A00001",
          "activityNo": "EB11060200",
          "price": 1000,
          "memo": "10010605171871824601",
          "quantity": 1
        }
      ],
      "totalAmount": 68,
      "paidAmount": 10,
      "fundChannel": [
        {
          "channelName": "用户实际支付",
          "channelAmount": 0,
          "channelNo": "user_real_money"
        }
      ]
    }
  ],
  "paidAmount": 0,
  "traceNo": "20220726153107100000000SH20501",
  "uuid": "f3c32fa32ccb4ccd8f38c36800741682",
  "receiptAmount": 0,
  "returnDesc": "请求成功",
  "step": "01"
}
```

# 批量核销结果查询

### **接口用途**

- 当调用批量核销接口超时未收到服务端返回时，可以调本接口来查询批量核销结果；

### **接口地址**

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

### **action**

- `batchCodeVerifyQuery`

**请求参数，中间件===&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" style="width: 809px;"><thead><tr><th style="width: 137px;">字段</th><th style="width: 179px;">类型</th><th style="width: 51px;">是否必填</th><th style="width: 130px;">字段意义</th><th style="width: 312px;">备注</th></tr></thead><tbody><tr><td style="width: 137px;">traceNo</td><td style="width: 179px;">String</td><td style="width: 51px;">是</td><td style="width: 130px;">收银机流水号</td><td style="width: 312px;">不允许重复,必须以yyyyMMdd(当天)作为流水号开头+递增序列</td></tr><tr><td style="width: 137px;">onlineTid</td><td style="width: 179px;">String</td><td style="width: 51px;">否</td><td style="width: 130px;">线上对接使用的统一终端号</td><td style="width: 312px;">对接前需提前和易百技术沟通</td></tr><tr><td style="width: 137px;">originalTraceNo</td><td style="width: 179px;">String</td><td style="width: 51px;">是</td><td style="width: 130px;">原收银机流水号</td><td style="width: 312px;">传入需要查询的原交易收银机流水号</td></tr><tr><td style="width: 137px;">originalDate</td><td style="width: 179px;">String</td><td style="width: 51px;">否</td><td style="width: 130px;">原交易日期</td><td style="width: 312px;">传入需要查询的原交易日期，不传默认为当天格式为yyyyMMdd</td></tr></tbody></table>

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

```JSON
{
  "traceNo": "9900000910001014320150201",
  "originalTraceNo": "9900000910001014220150201",
  "originalDate": "20170912"
}
```

**返回参数，易百后台===&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" style="width: 100%;"><thead><tr><th style="width: 12.7318%;">字段</th><th style="width: 19.0354%;">类型</th><th style="width: 8.03507%;">是否必填</th><th style="width: 15.4512%;">字段意义</th><th style="width: 44.8702%;">备注</th></tr></thead><tbody><tr><td style="width: 12.7318%;">traceNo</td><td style="width: 19.0354%;">String</td><td style="width: 8.03507%;">是</td><td style="width: 15.4512%;">收银机流水号</td><td style="width: 44.8702%;">不允许重复</td></tr><tr><td style="width: 12.7318%;">orderNo</td><td style="width: 19.0354%;">String</td><td style="width: 8.03507%;">是</td><td style="width: 15.4512%;">交易订单号</td><td style="width: 44.8702%;">易百生成</td></tr><tr><td style="width: 12.7318%;">transDate</td><td style="width: 19.0354%;">String</td><td style="width: 8.03507%;">是</td><td style="width: 15.4512%;">交易时间</td><td style="width: 44.8702%;">格式为：yyyyMMddHHmmss</td></tr><tr><td style="width: 12.7318%;">returnCode</td><td style="width: 19.0354%;">String</td><td style="width: 8.03507%;">是</td><td style="width: 15.4512%;">返回码</td><td style="width: 44.8702%;">00表示本次请求成功，并不代表所有码都核销成功</td></tr><tr><td style="width: 12.7318%;">returnDesc</td><td style="width: 19.0354%;">String</td><td style="width: 8.03507%;">是</td><td style="width: 15.4512%;">返回信息</td><td style="width: 44.8702%;">交易结果描述或错误原因</td></tr><tr><td style="width: 12.7318%;">ecouponsData</td><td style="width: 19.0354%;">List&lt;[ecouponsData](https://book.e-buy.com/books/e-buy-B6z/page/f4b9e "ecouponsData")&gt;</td><td style="width: 8.03507%;">是</td><td style="width: 15.4512%;">返回批量核销结果</td><td style="width: 44.8702%;">对应批量核销劵</td></tr><tr><td style="width: 12.7318%;">extendsData</td><td style="width: 19.0354%;">Object&lt;[extendsData](https://book.e-buy.com/books/e-buy-B6z/page/06905 "extendsData")&gt;</td><td style="width: 8.03507%;">是</td><td style="width: 15.4512%;">扩展信息</td><td style="width: 44.8702%;">与ebuy约定 allSuccess=false表示本次核销有券码核销失败</td></tr></tbody></table>

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

```json
{
  "transDate": "20220726153110",
  "returnCode": "00",
  "extendsData": {},
  "orderNo": "191990113248",
  "ecouponsData": [
    {
      "desc": "操作成功",
      "status": "00",
      "invoiceAmount": 0,
      "code": "10010605284819524875",
      "receiptAmount": 10,
      "activityProductNo": "00000000503057",
      "transType": "whaleAuth",
      "activityProductName": "85°C10元代金券",
      "totalAmount": 68,
      "paidAmount": 10,
      "fundChannel": [
        {
          "channelName": "用户实际支付",
          "channelAmount": 0,
          "channelNo": "user_real_money"
        }
      ]
    },
    {
      "desc": "操作成功",
      "status": "00",
      "invoiceAmount": 0,
      "code": "10010605171871824601",
      "receiptAmount": 10,
      "activityProductNo": "00000000503057",
      "transType": "whaleAuth",
      "activityProductName": "85°C10元代金券",
      "totalAmount": 68,
      "paidAmount": 10,
      "fundChannel": [
        {
          "channelName": "用户实际支付",
          "channelAmount": 0,
          "channelNo": "user_real_money"
        }
      ]
    }
  ],
  "traceNo": "20220726153107100000000SH20501",
  "uuid": "f3c32fa32ccb4ccd8f38c36800741682",
  "returnDesc": "请求成功"
}
```

# 会员资产查询接口

### **接口用途**

- 通过身份信息查询会员资产

### **接口地址**

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

### **action**

- `vipassets`

**请求参数，中间件===&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-a"><thead><tr><th style="width: 107px;">字段</th><th style="width: 150px;">类型</th><th style="width: 46px;">是否必填</th><th style="width: 300px;">字段意义</th><th style="width: 205px;">备注</th></tr></thead><tbody><tr><td style="width: 107px;">accountInfo</td><td style="width: 150px;">Object&lt;[accountInfo](https://book.e-buy.com/books/e-buy-B6z/page/ac627 "accountInfo")&gt;</td><td style="width: 46px;">是</td><td style="width: 300px;">用户身份信息，密文</td><td style="width: 205px;">aes256加密，易百提供密钥。</td></tr><tr><td>onlineTid</td><td>String</td><td>否</td><td>线上对接使用的统一终端号</td><td>对接前需提前和易百技术沟通</td></tr><tr><td style="width: 107px;">platformCode</td><td style="width: 150px;">String</td><td style="width: 46px;">是</td><td style="width: 300px;">平台编码，易百提供（天猫（Tmall），淘宝（TaoBao），拼多多（PDD），京东（JD））</td><td>  
</td></tr></tbody></table>

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

```
{
    "accountInfo": "lmANPRMeymgFQ+0D2N7nFMi1MADWvh3FPkQ0JEyYEBGiLhpquBx0mtigUpfPosWknHj/HzQLC1dnd6wlXuoJPQ==",
    "platformCode": "Tmall"
}

```

**返回参数，易百后台===&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-v" style="width: 806px; height: 231px;"><thead><tr style="height: 45px;"><th style="width: 94px; height: 45px;">字段</th><th style="width: 126px; height: 45px;">类型</th><th style="width: 61px; height: 45px;">是否必填</th><th style="width: 104px; height: 45px;">字段意义</th><th style="width: 421px; height: 45px;">备注</th></tr></thead><tbody><tr style="height: 29px;"><td style="width: 94px; height: 29px;">vipName</td><td style="width: 126px; height: 29px;">String</td><td style="width: 61px; height: 29px;">否</td><td style="width: 104px; height: 29px;">收银机流水号</td><td style="width: 421px; height: 29px;">不允许重复,必须以yyyyMMdd(当天)作为流水号开头+递增序列</td></tr><tr style="height: 29px;"><td style="width: 94px; height: 29px;">vipLevel</td><td style="width: 126px; height: 29px;">String</td><td style="width: 61px; height: 29px;">否</td><td style="width: 104px; height: 29px;">交易订单号</td><td style="width: 421px; height: 29px;">单位：元</td></tr><tr style="height: 35px;"><td style="width: 94px; height: 35px;">point</td><td style="width: 126px; height: 35px;">Object&lt;[point](https://book.e-buy.com/books/e-buy-B6z/page/cd006 "point")&gt;</td><td style="width: 61px; height: 35px;">否</td><td style="width: 104px; height: 35px;">会员积分</td><td style="width: 421px; height: 35px;"> </td></tr><tr style="height: 35px;"><td style="width: 94px; height: 35px;">vouchers</td><td style="width: 126px; height: 35px;">List&lt;[vouchers](https://book.e-buy.com/books/e-buy-B6z/page/e2ef5 "vouchers")&gt;</td><td style="width: 61px; height: 35px;">否</td><td style="width: 104px; height: 35px;">会员电子券</td><td style="width: 421px; height: 35px;"> </td></tr><tr style="height: 29px;"><td style="width: 94px; height: 29px;">returnCode</td><td style="width: 126px; height: 29px;">String</td><td style="width: 61px; height: 29px;">是</td><td style="width: 104px; height: 29px;">返回码</td><td style="width: 421px; height: 29px;">00表示交易成功，其他表示失败</td></tr><tr style="height: 29px;"><td style="width: 94px; height: 29px;">returnDesc</td><td style="width: 126px; height: 29px;">String</td><td style="width: 61px; height: 29px;">是</td><td style="width: 104px; height: 29px;">返回信息</td><td style="width: 421px; height: 29px;">交易结果描述或错误原因</td></tr></tbody></table>

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

```
{
    "vipName": "至尊会员",
    "vipLevel": "7",
    "returnCode": "00",
    "returnDesc": "SUCCESS",
    "point": {
        "points": 120000,
        "deductileAmount": 2400,
        "validDate": "20210625",
        "invalidPoints": 22000
    },
    "vouchers": {
        "voucherType": "coupon",
        "code": "10032345433321232345",
        "faceAmount": "10",
        "validDate": "20210120-20210225",
        "voucherStatus": "00",
        "voucherStatusDesc": "可用",
        "tenderDiscountCode": 123|97,
        "defaultGoodsId": "P00001",
        "goodsDetail": [{
                "goodsCategory": "001",
                "goodsId": "P00001",
                "goodsName": "牙膏",
                "price": 5,
                "quantity": 2
            },
            {
                "goodsCategory": "101",
                "goodsId": "P00002",
                "goodsName": "洗发水",
                "price": 10,
                "quantity": 1
            }
        ],
        "userInvoiceAmount": 8,
        "ebuyInvoiceAmount": 2,
        "platformCode": "Tmall",
        "activityProductNo": "5837",
        "remainTimes": 1,
        "totalTimes": 30,
        "voucherScope": "{\"merchatVoucherType\":\"sxx\",\"mutualPlatform\":\"EBUY,PDD\",\"dayUseTime\":\"7:00-10:00\",\"mutualType\":\"cash\"}"
    }
}
```

# 会员集点

### **接口用途**

- 会员集点

### **接口地址**

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

### **action**

- `accumulating`

**请求参数，中件间===&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"><thead><tr><th style="width: 137px;">字段</th><th style="width: 165px;">类型</th><th style="width: 54px;">是否必填</th><th style="width: 105px;">字段意义</th><th style="width: 345px;">备注</th></tr></thead><tbody><tr><td style="width: 137px;">traceNo</td><td style="width: 165px;">String</td><td style="width: 54px;">是</td><td style="width: 105px;">收银机流水号</td><td style="width: 345px;">不允许重复,必须以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: 165px;">Price</td><td style="width: 54px;">是</td><td style="width: 105px;">交易总金额</td><td style="width: 345px;">单位：元</td></tr><tr><td style="width: 137px;">undiscountAmount</td><td style="width: 165px;">Price</td><td style="width: 54px;">否</td><td style="width: 105px;">不可打折金额</td><td style="width: 345px;">单位：元</td></tr><tr><td style="width: 137px;">recogCode</td><td style="width: 165px;">String</td><td style="width: 54px;">否</td><td style="width: 105px;">操作识别代码</td><td style="width: 345px;">为006时代表补积星星，为000时代表电子凭证核销，为100时代表电子凭证状态信息查询，为200时代表是核销交易的查询，为001代表集点前置判断</td></tr><tr><td style="width: 137px;">pointDetail</td><td style="width: 165px;">List&lt;[pointDetail](https://book.e-buy.com/books/e-buy-B6z/page/d67d8 "pointDetail")&gt;</td><td style="width: 54px;">否</td><td style="width: 105px;">集点明细</td><td style="width: 345px;">收银机集点时填写,后台集点不填</td></tr><tr><td style="width: 137px;">goodsDetail</td><td style="width: 165px;">List&lt;[goodsDetail](https://book.e-buy.com/books/e-buy-B6z/page/3def1 "goodsDetail")&gt;</td><td style="width: 54px;">否</td><td style="width: 105px;">产品明细</td><td style="width: 345px;">验证产品明细时必填</td></tr><tr><td style="width: 137px;">memberDetail</td><td style="width: 165px;">Object&lt;[memberDetail](https://book.e-buy.com/books/e-buy-B6z/page/9fc3d "memberDetail")&gt;</td><td style="width: 54px;">否</td><td style="width: 105px;">会员信息</td><td style="width: 345px;">会员支付时必填</td></tr></tbody></table>

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

```
{
    "traceNo": "99000009100010101732123",
    "totalAmount": 40.8,
    "undiscountAmount": 0,
    "recogCode": "006",
    "pointDetail": [{
        "activityNo": "2016121901",
        "points": 100
    }, {
        "activityNo": "2017100901",
        "points": 50
    }],
    "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: 146px;">字段</th><th style="width: 174px;">类型</th><th style="width: 58px;">是否必填</th><th style="width: 112px;">字段意义</th><th style="width: 319px;">备注</th></tr></thead><tbody><tr><td style="width: 146px;">traceNo</td><td style="width: 174px;">String</td><td style="width: 58px;">是</td><td style="width: 112px;">收银机流水号</td><td style="width: 319px;">不允许重复,必须以yyyyMMdd(当天)作为流水号开头+递增序列</td></tr><tr><td style="width: 146px;">orderNo</td><td style="width: 174px;">String</td><td style="width: 58px;">是</td><td style="width: 112px;">交易订单号</td><td style="width: 319px;">易百生成</td></tr><tr><td style="width: 146px;">transDate</td><td style="width: 174px;">String</td><td style="width: 58px;">是</td><td style="width: 112px;">交易时间</td><td style="width: 319px;">格式为：yyyyMMddHHmmss</td></tr><tr><td style="width: 146px;">returnCode</td><td style="width: 174px;">String</td><td style="width: 58px;">是</td><td style="width: 112px;">返回码</td><td style="width: 319px;">00表示交易成功，其他表示失败</td></tr><tr><td style="width: 146px;">returnDesc</td><td style="width: 174px;">String</td><td style="width: 58px;">是</td><td style="width: 112px;">返回信息</td><td style="width: 319px;">交易结果描述或错误原因</td></tr><tr><td style="width: 146px;">activityProductNo</td><td style="width: 174px;">String</td><td style="width: 58px;">否</td><td style="width: 112px;">活动产品编号</td><td style="width: 319px;"> </td></tr><tr><td style="width: 146px;">activityProductName</td><td style="width: 174px;">String</td><td style="width: 58px;">否</td><td style="width: 112px;">活动产品名称</td><td style="width: 319px;"> </td></tr><tr><td style="width: 146px;">printDetail</td><td style="width: 174px;">Object&lt;[printDetail](https://book.e-buy.com/books/e-buy-B6z/page/eed5a "printDetail")&gt;</td><td style="width: 58px;">否</td><td style="width: 112px;">打印信息</td><td style="width: 319px;">如需要在收银小票上打印信息时必填</td></tr><tr><td style="width: 146px;">memberDetail</td><td style="width: 174px;">Object&lt;[memberDetail](https://book.e-buy.com/books/e-buy-B6z/page/9fc3d "memberDetail")&gt;</td><td style="width: 58px;">否</td><td style="width: 112px;">会员信息</td><td style="width: 319px;">返回本次交易的会员信息</td></tr><tr><td style="width: 146px;">voucherDetail</td><td style="width: 174px;">List&lt;[voucherDetail](https://book.e-buy.com/books/e-buy-B6z/page/8f855 "voucherDetail")&gt;</td><td style="width: 58px;">否</td><td style="width: 112px;">优惠券信息</td><td style="width: 319px;">返回本次交易的优惠券信息</td></tr></tbody></table>

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

```
{
    "traceNo": "99000009100010101732123",
    "orderNo": "171698602301",
    "transDate": "20161231120533",
    "returnCode": "00",
    "returnDesc": "SUCCESS",
    "activityProductNo": "2016123102",
    "activityProductName": "圣诞集点活动",
    "printDetail": {
        "cardNo64": "622562****8888",
        "bank": "中国银行",
        "paymentOrderNo": "201612315689412157458787",
        "pointSale": "20000",
        "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
    },
    "voucherDetail": [
        {
            "voucherId": "001",
            "voucherName": "现金优惠券",
            "voucherType": "现金",
            "voucherCode": "123456789",
            "channelAmount": "20.8"
        },
        {
            "voucherId": "002",
            "voucherName": "买一赠一优惠券",
            "voucherType": "买赠",
            "voucherCode": "1232136781",
            "channelAmount": "20.8"
        }
    ]
}
```

# 活动产品选项

**当通过卡BIN与码BIN无法确认具体支付渠道时，易百后台会返回活动产品列表，供中间件弹出窗体，让收银人员进行选择，选择项需填入activityProductNo字段后再向易百后台请求支付。返回报文如下：**

**二次交互的返回参数，易百后台===&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"><thead><tr><th style="width: 130px;">字段</th><th style="width: 175px;">类型</th><th style="width: 83px;">是否必填</th><th style="width: 128px;">字段意义</th><th style="width: 293px;">备注</th></tr></thead><tbody><tr><td style="width: 130px;">traceNo</td><td style="width: 175px;">String</td><td style="width: 83px;">是</td><td style="width: 128px;">收银机流水号</td><td style="width: 293px;">不允许重复,必须以yyyyMMdd(当天)作为流水号开头+递增序列</td></tr><tr><td>onlineTid</td><td>String</td><td>否</td><td>线上对接使用的统一终端号</td><td>对接前需提前和易百技术沟通</td></tr><tr><td style="width: 130px;">activityProductList</td><td style="width: 175px;">List&lt;[activityProductList](https://book.e-buy.com/books/e-buy-B6z/page/8e296-BzR "activityProductList")&gt;</td><td style="width: 83px;">是</td><td style="width: 128px;">活动产品列表</td><td style="width: 293px;">中件间弹出窗体，显示所有选择项</td></tr></tbody></table>

**二次交互返回报文举例**

```
{
    "traceNo": "9900000910001014520150201",
    "activityProductList": [
        {
            "activityProductNo": "HDCP00000000000001",
            "activityProductName": "中信银行积分兑换",
            "showOrder": "1"
        },
        {
            "activityProductNo": "HDCP00000000000002",
            "activityProductName": "中国银行积分兑换",
            "showOrder": "2"
        }
    ]
}
```

# 收单交易结果通知

### **接口用途**

- 银行卡收单结果通知

### **接口地址**

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

### **action**

- `cashPosNotice`

**请求参数，POS机===&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-o"><thead><tr><th>字段</th><th>类型</th><th>是否必填</th><th>字段意义</th><th>备注</th></tr></thead><tbody><tr><td>onlineTid</td><td>String</td><td>否</td><td>线上对接使用的统一终端号</td><td>对接前需提前和易百技术沟通</td></tr><tr><td>originalTraceNo</td><td>String</td><td>是</td><td>待通知交易的收银机流水号</td><td>不允许重复,必须以yyyyMMdd(当天)作为流水号开头+递增序列</td></tr><tr><td>originalDate</td><td>String</td><td>是</td><td>待通知交易的日期</td><td>一般为当天，yyyyMMdd</td></tr><tr><td>originalTransclass</td><td>String</td><td>是</td><td>待通知的交易类型</td><td>sale,void,refund</td></tr><tr><td>returnCode</td><td>String</td><td>是</td><td>结果码</td><td>收单机构的返回码</td></tr><tr><td>returnDesc</td><td>String</td><td>是</td><td>结果描述</td><td>收单机构的返回信息</td></tr><tr><td>paidAmount</td><td>Price</td><td>是</td><td>收单支付金额</td><td>收单机构的实收金额</td></tr><tr><td>deductAmount</td><td>Price</td><td>是</td><td>收单优惠金额</td><td>收单机构优惠金额</td></tr><tr><td>ifWeb</td><td>String</td><td>是</td><td>是否web接口</td><td>填“1”</td></tr><tr><td>bankTid</td><td>String</td><td>是</td><td>收单机构终端号</td><td>收单机构终端号</td></tr><tr><td>bankMid</td><td>String</td><td>是</td><td>收单机构商户号</td><td>收单机构商户号</td></tr><tr><td>bankRefno</td><td>String</td><td>是</td><td>收单机构订单号</td><td>收单机构订单号</td></tr><tr><td>bankSwift</td><td>String</td><td>是</td><td>收单机构流水号</td><td>收单机构流水号</td></tr></tbody></table>

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

```
{
    "deductAmount": 0,
    "originalDate": "20180314",
    "originalTraceNo": "EP18031411351400010686002000651",
    "bankMid": "84931005331K003",
    "returnCode": "00",
    "ifWeb": "1",
    "bankTid": "70027420",
    "originalTid": "99001061",
    "paidAmount": 0.100000,
    "originalTransclass": "refund",
    "bankRefno": "141135568723",
    "returnDesc": "success"
}

```

**返回参数，易百后台===&gt;POS机**

<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-r"><thead><tr><th>字段</th><th>类型</th><th>是否必填</th><th>字段意义</th><th>备注</th></tr></thead><tbody><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></tbody></table>

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

```
{
    "returnDesc": "notice success",
    "returnCode": "00"
}
```