# 线下posp接口列表



# 二维码支付或兑换

**接口用途**

- 支付宝支付
- 微信被扫支付
- 银行二维码支付(工行、中行、中信、浦发等)
- 银行二维码积分兑换(工行、中行、中信、浦发等)
- 银联立码付
- 百度支付
- 翼支付
- 其他二维码支付
- 电子凭证核销：产品券/代金券/折扣券/买N赠M券/立减券
- 外卖或自助点单订单码自动上屏

**action**

- `qrcodeSale`

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

<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(40)</td><td>是</td><td>收银机流水号</td><td>不允许重复，必须以yyyyMMdd(当天)作为流水号开头+递增序列</td></tr><tr><td>totalAmount</td><td>Price</td><td>是</td><td>交易总金额</td><td>单位：元</td></tr><tr><td>undiscountAmount</td><td>Price</td><td>是</td><td>不可打折金额</td><td>单位：元 如无此金额时可填0</td></tr><tr><td>verifyType</td><td>String</td><td>是</td><td>核销类型</td><td>请与易百技术确认，枚举值：wechatApp(微信小程序),h5,aliApp(支付宝小程序),pos(线下pos机具)</td></tr><tr><td>activityProductNo</td><td>String</td><td>否</td><td>活动产品编号</td><td>二次交互时填写</td></tr><tr><td>scene</td><td>String</td><td>否</td><td>支付场景</td><td>条码:bar\_code, 二维码:qr\_code</td></tr><tr><td>orderSubject</td><td>String</td><td>否</td><td>订单标题</td><td>最长256</td></tr><tr><td>orderDescription</td><td>String</td><td>否</td><td>订单描述</td><td>最长256</td></tr><tr><td>qrcode</td><td>String</td><td>是</td><td>二维码内容</td><td>串号、一维码或二维码内容</td></tr><tr><td>goodsDetail</td><td>List&lt;[goodsDetail](https://gitbook.e-fuli.com/ebuy-cashier-integration-api/cn/api-introduction/parameter-object/goods-detail.html "goodsDetail")&gt;</td><td>是</td><td>产品明细</td><td>验证产品明细时必填</td></tr><tr><td>memberDetail</td><td>Object&lt;[memberDetail](https://gitbook.e-fuli.com/ebuy-cashier-integration-api/cn/api-introduction/parameter-object/member-detail.html "memberDetail")&gt;</td><td>否</td><td>会员信息</td><td>会员支付时必填</td></tr><tr><td>extendData</td><td>[JSON](https://book.e-buy.com/books/c20ad/page/extenddata)</td><td>否</td><td>扩展信息</td><td>特殊场景填值需与易百技术沟通</td></tr></tbody></table>

**请求报文举例**

```
{
    "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.00,
        "pointBalance": 30000
    },
    "extendData": {
        "rightsDetail": [{
            "snCode": "111111111xxxxxx"
        }],
        "shopNo":"test001",
        "voucherNo":"test001",
        "posSerialNo":"test001"
    }
}

```

**返回参数，易百后台===&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-1"><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>orderNo</td><td>String</td><td>是</td><td>交易订单号</td><td>易百生成</td></tr><tr><td>transDate</td><td>String</td><td>是</td><td>交易时间</td><td>格式为：yyyyMMddHHmmss</td></tr><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><tr><td>paidAmount</td><td>Price</td><td>是</td><td>支付成功总金额</td><td>单位：元</td></tr><tr><td>receiptAmount</td><td>Price</td><td>否</td><td>商户实收金额</td><td>单位：元</td></tr><tr><td>invoiceAmount</td><td>Price</td><td>否</td><td>商户开票金额</td><td>单位：元</td></tr><tr><td>exchangeRate</td><td>Number(8,6)</td><td>否</td><td>汇率</td><td>1外币等于多少人民币</td></tr><tr><td>currency</td><td>String</td><td>否</td><td>货币类型</td><td>例如:CNY</td></tr><tr><td>discountCode</td><td>String</td><td>否</td><td>折扣编码</td><td>由收银机分配，用于入账计折扣类型</td></tr><tr><td>discountNum</td><td>Number</td><td>否</td><td>固定金额折扣数量</td><td>用于入账计折扣类型的数量</td></tr><tr><td>tenderCode</td><td>String</td><td>否</td><td>支付方式编码</td><td>由收银机分配，用于入账计支付方式</td></tr><tr><td>remainTimes</td><td>Number</td><td>是</td><td>券码当前可用次数</td><td>如果有限制每天使用多少次，代表当天可使用次数</td></tr><tr><td>activityProductNo</td><td>String</td><td>否</td><td>活动产品编号</td><td> </td></tr><tr><td>activityProductName</td><td>String</td><td>否</td><td>活动产品名称</td><td> </td></tr><tr><td>goodsDetail</td><td>List&lt;[goodsDetail](https://gitbook.e-fuli.com/ebuy-cashier-integration-api/cn/api-introduction/parameter-object/goods-detail.html "goodsDetail")&gt;</td><td>否</td><td>折抵产品明细</td><td>返回后台已抵扣成功的产品明细</td></tr><tr><td>fundChannel</td><td>List&lt;[fundChannel](https://gitbook.e-fuli.com/ebuy-cashier-integration-api/cn/api-introduction/parameter-object/fund-channel.html "fundChannel")&gt;</td><td>否</td><td>资金渠道</td><td> </td></tr><tr><td>printDetail</td><td>Object&lt;[printDetail](https://gitbook.e-fuli.com/ebuy-cashier-integration-api/cn/api-introduction/parameter-object/print-detail.html "printDetail")&gt;</td><td>否</td><td>打印信息</td><td>如需要在收银小票上打印信息时必填</td></tr><tr><td>memberDetail</td><td>Object&lt;[memberDetail](https://gitbook.e-fuli.com/ebuy-cashier-integration-api/cn/api-introduction/parameter-object/member-detail.html "memberDetail")&gt;</td><td>否</td><td>会员信息</td><td>返回本次交易的会员信息</td></tr><tr><td>voucherDetail</td><td>List&lt;[voucherDetail](https://gitbook.e-fuli.com/ebuy-cashier-integration-api/cn/api-introduction/parameter-object/voucher-detail.html "voucherDetail")&gt;</td><td>否</td><td>优惠券信息</td><td>返回本次交易的优惠券信息</td></tr><tr><td>extendsData</td><td>Object&lt;[extendsData](https://gitbook.e-fuli.com/ebuy-cashier-integration-api/cn/api-introduction/parameter-object/extends-data.html "extendsData")&gt;</td><td>否</td><td>扩展信息</td><td>与ebuy约定</td></tr></tbody></table>

**返回报文举例**

```
{
    "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": "支付宝支付",
    "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.00,
        "pointBalance": 30000
    },
    "voucherDetail": [
        {
            "voucherId": "001",
            "voucherName": "现金优惠券",
            "voucherType": "现金",
            "voucherCode": "123456789",
            "channelAmount": "20.8"
        },
        {
            "voucherId": "002",
            "voucherName": "买一赠一优惠券",
            "voucherType": "买赠",
            "voucherCode": "1232136781",
            "channelAmount": "20.8"
        }
    ]
}
```

# 当日撤销

**接口用途**

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

**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>字段</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><tr><td>isRollback</td><td>Boolean</td><td>是</td><td>标识本次请求是否为冲正交易(中间件发起)</td><td>冲正发起需要另起线程并且先返回收银机交易失败结果，再异步冲正</td></tr><tr><td>acquirer</td><td>String</td><td>否</td><td>收单机构</td><td>如：citicCashpay表示中信收单，如果收单撤销是必填的</td></tr><tr><td>cardInfo</td><td>Object&lt;[cardInfo](https://gitbook.e-fuli.com/ebuy-cashier-integration-api/cn/api-introduction/parameter-object/card-info.html "cardInfo")&gt;</td><td>否</td><td>卡信息</td><td>卡支付类交易需要填入原交易卡信息</td></tr></tbody></table>

**请求报文举例**

```
{
    "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-1"><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>orderNo</td><td>String</td><td>是</td><td>交易订单号</td><td> </td></tr><tr><td>transDate</td><td>String</td><td>是</td><td>交易时间</td><td>格式为：yyyyMMddHHmmss</td></tr><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><tr><td>fundChannel</td><td>List&lt;[fundChannel](https://gitbook.e-fuli.com/ebuy-cashier-integration-api/cn/api-introduction/parameter-object/fund-channel.html "fundChannel")&gt;</td><td>否</td><td>资金渠道</td><td> </td></tr><tr><td>printDetail</td><td>Object&lt;[printDetail](https://gitbook.e-fuli.com/ebuy-cashier-integration-api/cn/api-introduction/parameter-object/print-detail.html "printDetail")&gt;</td><td>否</td><td>打印信息</td><td>如需要在收银小票上打印信息时必填</td></tr><tr><td>memberDetail</td><td>Object&lt;[memberDetail](https://gitbook.e-fuli.com/ebuy-cashier-integration-api/cn/api-introduction/parameter-object/member-detail.html "memberDetail")&gt;</td><td>否</td><td>会员信息</td><td>返回本次交易的会员信息</td></tr><tr><td>voucherDetail</td><td>List&lt;[voucherDetail](https://gitbook.e-fuli.com/ebuy-cashier-integration-api/cn/api-introduction/parameter-object/voucher-detail.html "voucherDetail")&gt;</td><td>否</td><td>优惠券信息</td><td>返回本次交易的优惠券信息</td></tr><tr><td>cashOrderNo</td><td>String</td><td>否</td><td>收单原流水号</td><td>收单撤销时返回</td></tr><tr><td>cashBank</td><td>String</td><td>否</td><td>收单机构标识</td><td>收单撤销时返回</td></tr><tr><td>purchaseOrder</td><td>List&lt;[purchaseOrder](https://gitbook.e-fuli.com/ebuy-cashier-integration-api/cn/api-introduction/parameter-object/qian-gou-dan-xin-xi.html)&gt;</td><td>否</td><td>收单签购单信息</td><td>[签购单信息](https://gitbook.e-fuli.com/ebuy-cashier-integration-api/cn/api-introduction/parameter-object/qian-gou-dan-xin-xi.html)</td></tr></tbody></table>

**返回报文举例**

```
{
    "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.00,
        "pointBalance": 30000
    },
    "voucherDetail": [
        {
            "voucherId": "001",
            "voucherName": "现金优惠券",
            "voucherType": "现金",
            "voucherCode": "123456789",
            "channelAmount": "20.8"
        },
        {
            "voucherId": "002",
            "voucherName": "买一赠一优惠券",
            "voucherType": "买赠",
            "voucherCode": "1232136781",
            "channelAmount": "20.8"
        }
    ]
}

```

**支持撤销的交易**

- cardPayment
- cardRedemption
- qrcodeSale

# 电子凭证查询

**接口用途**

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

**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>qrcode</td><td>String</td><td>是</td><td>电子凭证号</td><td>要查询的电子凭证号</td></tr></tbody></table>

**请求报文举例**

```
{
    "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-1"><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>orderNo</td><td>String</td><td>是</td><td>交易订单号</td><td>单位：元</td></tr><tr><td>transDate</td><td>String</td><td>是</td><td>交易时间</td><td>格式为：yyyyMMddHHmmss</td></tr><tr><td>returnCode</td><td>String</td><td>是</td><td>返回码</td><td>00，C3表示券码可用，其他表示不可用</td></tr><tr><td>returnDesc</td><td>String</td><td>是</td><td>返回信息</td><td>交易结果描述或错误原因</td></tr><tr><td>canPayAmount</td><td>Price</td><td>是</td><td>可抵用的总金额</td><td>单位：元</td></tr><tr><td>activityProductNo</td><td>String</td><td>否</td><td>活动产品编号</td><td>该电子凭证所属的活动产品编号</td></tr><tr><td>activityProductName</td><td>String</td><td>否</td><td>活动产品名称</td><td>该电子凭证所属的活动产品名称</td></tr><tr><td>extendsData</td><td>Object&lt;[extendsData](https://gitbook.e-fuli.com/ebuy-cashier-integration-api/cn/api-introduction/parameter-object/extends-data.html "extendsData")&gt;</td><td>否</td><td>扩展信息</td><td>与ebuy约定</td></tr></tbody></table>

**返回报文举例**

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