# 交易类接口



# 电子券核销/二维码被扫

#### **接口用途**

- 二维码被扫类交易统一入口

#### **接口地址**

- [https://qrpaymobiletest.e-buychina.com.cn/web/api/qrcodeSale](https://qrpaymobiletest.e-buychina.com.cn/web/api/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</td><td>是</td><td>app流水号</td><td>不允许重复</td></tr><tr><td>totalAmount</td><td>Price</td><td>是</td><td>交易总金额</td><td>单位：元</td></tr><tr><td>qrcode</td><td>String</td><td>是</td><td>二维码内容</td><td>二维码内容</td></tr></tbody></table>

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

```
{
    "traceNo": "990000091000101620150201",
    "totalAmount": 40.8,
    "qrcode": "280123121234567890"
}

```

#### **返回参数**

<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>字段</th><th>类型</th><th>是否必填</th><th>字段意义</th><th>备注</th></tr></thead><tbody><tr><td>traceNo</td><td>String</td><td>是</td><td>收银机流水号</td><td>不允许重复</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>canPayAmount</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>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>voucherDetail</td><td>List&lt;voucherDetail&gt;</td><td>否</td><td>优惠券信息</td><td>返回本次交易的优惠券信息</td></tr></tbody></table>

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

```
{
    "extendsData":{
    },
    "returnCode":"00",
    "remainTimes":0,
    "invoiceAmount":1000,
    "receiptAmount":1000,
    "activityProductNo":"00000000507096",
    "transDate":"20190909150302",
    "activityProductName":"ビックカメラ1000円分クーポン券",
    "orderNo":"181481000584",
    "voucherDetail":[
        {
            "voucherCode":"10010596750080404109"
        }
    ],
    "canPayAmount":1000,
    "paidAmount":1000,
    "traceNo":"794_40392571_1568008981496",
    "uuid":"c8c668e356b441ccbd6e253d1992eae3",
    "returnDesc":"SUCCESS",
    "step":"01",
    "rpcContext":"10.255.3.71:46120-->10.255.3.71:30032"
}
```

# 查询交易结果

#### **接口用途**

- 通过原流水号查询交易结果

#### **接口地址**

- [https://qrpaymobiletest.e-buychina.com.cn/web/api/inquiry](https://qrpaymobiletest.e-buychina.com.cn/web/api/inquiry)

#### **请求参数**

<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>app流水号</td><td>不允许重复</td></tr><tr><td>originalTraceNo</td><td>String</td><td>是</td><td>原app流水号</td></tr></tbody></table>

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

```
{
    "traceNo": "APPTEST9100010101732123012",
    "originalTraceNo": "APPTEST9100010101732123018"
}

```

#### **返回参数**

<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>字段</th><th>类型</th><th>是否必填</th><th>字段意义</th><th>备注</th></tr></thead><tbody><tr><td>traceNo</td><td>String</td><td>是</td><td>收银机流水号</td><td>不允许重复</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>canPayAmount</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>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>voucherDetail</td><td>List&lt;voucherDetail&gt;</td><td>否</td><td>优惠券信息</td><td>返回本次交易的优惠券信息</td></tr></tbody></table>

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

```
{
    "extendsData":{
    },
    "returnCode":"00",
    "remainTimes":0,
    "invoiceAmount":1000,
    "receiptAmount":1000,
    "activityProductNo":"00000000507096",
    "transDate":"20190909150302",
    "activityProductName":"ビックカメラ1000円分クーポン券",
    "orderNo":"181481000584",
    "voucherDetail":[
        {
            "voucherCode":"10010596750080404109"
        }
    ],
    "canPayAmount":1000,
    "paidAmount":1000,
    "traceNo":"794_40392571_1568008981496",
    "uuid":"c8c668e356b441ccbd6e253d1992eae3",
    "returnDesc":"SUCCESS",
    "step":"01",
    "rpcContext":"10.255.3.71:46120-->10.255.3.71:30032"
}
```

# 撤销

#### **接口用途**

- 撤销原交易（上送交易时间且不为当日时会自动调用业务主机退款接口）

#### **接口地址**

- [https://qrpaymobiletest.e-buychina.com.cn/web/api/void](https://qrpaymobiletest.e-buychina.com.cn/web/api/void)

#### **请求参数**

<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>app流水号</td><td>不允许重复</td></tr><tr><td>originalTraceNo</td><td>String</td><td>是</td><td>原app流水号</td></tr></tbody></table>

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

```
{
    "traceNo": "APPTEST9100010101732123012",
    "originalTraceNo": "APPTEST9100010101732123018"
}

```

#### **返回参数**

<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>字段</th><th>类型</th><th>是否必填</th><th>字段意义</th><th>备注</th></tr></thead><tbody><tr><td>traceNo</td><td>String</td><td>是</td><td>收银机流水号</td><td>不允许重复</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>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>voucherDetail</td><td>List&lt;voucherDetail&gt;</td><td>否</td><td>优惠券信息</td><td>返回本次交易的优惠券信息</td></tr></tbody></table>

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

```
{
    "extendsData":{

    },
    "returnCode":"00",
    "invoiceAmount":0,
    "receiptAmount":0,
    "transDate":"20190909184245",
    "activityProductName":"ビックカメラ1000円分クーポン券",
    "orderNo":"181481000589",
    "voucherDetail":[
        {
            "voucherCode":"10010526553080405449"
        }
    ],
    "paidAmount":0,
    "traceNo":"209_59392775_1568022164957",
    "uuid":"fccd5fccae5a4efe88222439bd530d9d",
    "returnDesc":"操作成功",
    "rpcContext":"10.255.3.71:46120-->10.255.3.71:30032",
    "step":"01"
}
```

# 筛选交易列表

#### **接口用途**

- 根据条件筛选交易列表

#### **接口地址**

- [https://qrpaymobiletest.e-buychina.com.cn/web/api/getMerchantTransList](https://qrpaymobiletest.e-buychina.com.cn/web/api/getMerchantTransList)

#### **请求参数**

<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>app流水号</td><td>不允许重复</td></tr><tr><td>beginDateTime</td><td>String</td><td>否</td><td>筛选开始时间</td><td>2019-06-20 12:00:00（不填默认当天0点）</td></tr><tr><td>endDateTime</td><td>String</td><td>否</td><td>筛选结束时间</td><td>2019-06-25 23:59:59（不填默认此刻）</td></tr><tr><td>pagesize</td><td>int</td><td>是</td><td>每页条数</td><td>50</td></tr><tr><td>pageno</td><td>int</td><td>是</td><td>当前页数</td><td>1</td></tr><tr><td>noStatistics</td><td>String</td><td>否</td><td>无需可视化图表数据</td><td>默认yes</td></tr><tr><td>conditionInfo</td><td>[ConditionInfo](https://book.e-buy.com/books/ebuy-epointvoucher/page/d947b-Fyk)</td><td>是</td><td>其他筛选条件</td><td>只上送筛选项</td></tr></tbody></table>

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

```
{
    "traceNo": "APPTEST9100010101732123013",
    "beginDateTime": "2019-06-10 00:00:00",
    "endDateTime": "2019-06-18 23:59:59",
    "pagesize": 50,
    "pageno": 1,
    "noStatistics": "yes",
    "conditionInfo": {
        "transType": "010",    //核销 撤销 退款
        "returnCode": "!00"    //！为不等于
    }
}

```

#### **返回参数**

<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><tr><td>totalamount</td><td>Price</td><td>是</td><td>统计总金额</td><td>单位：元</td></tr><tr><td>totalcount</td><td>int</td><td>否</td><td>统计总笔数</td><td>单位：元</td></tr><tr><td>saleamount</td><td>Price</td><td>否</td><td>交易金额</td><td>单位：元</td></tr><tr><td>refundamount</td><td>Price</td><td>否</td><td>退款金额</td><td>单位：元</td></tr><tr><td>currency</td><td>String</td><td>否</td><td>货币类型</td><td>例如:CNY</td></tr><tr><td>entitys</td><td>List&lt;[TransInfo](https://book.e-buy.com/books/ebuy-epointvoucher/page/019d3-QIi)&gt;</td><td>否</td><td>交易列表</td><td> </td></tr><tr><td>dateDatasList</td><td>List&lt;[DateData](https://book.e-buy.com/books/ebuy-epointvoucher/page/18d80)&gt;</td><td>否</td><td>按日统计结果</td><td> </td></tr><tr><td>appNameDatasList</td><td>List&lt;[AppNameData](https://book.e-buy.com/books/ebuy-epointvoucher/page/85d8c)&gt;</td><td>否</td><td>按应用统计结果</td></tr></tbody></table>

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

```
{
    "dateDatasList": [{
        "amount": 0.02,
        "name": "20190402",
        "count": 3
    },{
        "amount": 0.02,
        "name": "20190403",
        "count": 3
    }],
    "totalcount": 3,
    "returnCode": "00",
    "totalamount": 0.02,
    "saleamount": 0.02,
    "appNameDatasList": [{
        "amount": 0.02,
        "name": "Alipay",
        "count": 2
    },{
        "amount": 0,
        "count": 1,
        "name": "Ecoupon"
    }],
    "currency": "CNY",
    "refundamount": 0,
    "returnDesc": "获取成功",
    "entitys": [
        {
            "createTime": 1569922420000,
            "returnCode": "00",
            "transtime": "183340",
            "transcationId": 514,
            "posno": "",
            "transdate": "20191001",
            "isRefund": "0",
            "amount": "333.33",
            "appName": "Ecoupon",
            "isVoid": "0",
            "orderNo": "29_36392055_1569922420023",
            "nickName": "matsuya001店長",
            "qrcode": "10010506195921748853",
            "transclass": "ecoupon-verify",
            "traceNo": "29_36392055_1569922420023"
        },
        {
            "returnCode": "00",
            "transtime": "145027",
            "amount": "0.01",
            "orderNo": "EP1904021450400686002000106",
            "nickName": "matsuya001店長",
            "transclass": "qrpay-sale",
            "isVoid": "0",
            "createTime": 1554187835000,
            "appName": "AlipayQrpay",
            "isRefund": "0",
            "transcationId": 1098,
            "transdate": "20190402"
        },
        {
            "returnCode": "00",
            "transtime": "143719",
            "amount": "0.01",
            "orderNo": "EP1904021437320686002000098",
            "nickName": "matsuya001店長",
            "transclass": "qrpay-sale",
            "isVoid": "0",
            "createTime": 1554187047000,
            "appName": "AlipayQrpay",
            "isRefund": "0",
            "transcationId": 1097,
            "transdate": "20190403"
        }
    ],
}
```

# 新页面按券号查询历史交易

#### **接口用途**

- 根据券号筛选交易列表

#### **接口地址**

- [https://qrpaymobiletest.e-buychina.com.cn/web/api/getCodeTransList](https://qrpaymobiletest.e-buychina.com.cn/web/api/getCodeTransList)

#### **请求参数**

<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>app流水号</td><td>不允许重复</td></tr><tr><td>conditionInfo</td><td>[ConditionInfo](https://book.e-buy.com/books/ebuy-epointvoucher/page/d947b-Fyk)</td><td>是</td><td>其他筛选条件</td><td>只上送筛选项</td></tr></tbody></table>

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

```
{
    "traceNo": "APPTEST9100010101732123013",
    "conditionInfo": {
        "qrcode": "12312312313123"
    }
}

```

#### **返回参数**

<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><tr><td>totalamount</td><td>Price</td><td>是</td><td>统计总金额</td><td>单位：元</td></tr><tr><td>totalcount</td><td>int</td><td>否</td><td>统计总笔数</td><td>单位：元</td></tr><tr><td>saleamount</td><td>Price</td><td>否</td><td>交易金额</td><td>单位：元</td></tr><tr><td>refundamount</td><td>Price</td><td>否</td><td>退款金额</td><td>单位：元</td></tr><tr><td>currency</td><td>String</td><td>否</td><td>货币类型</td><td>例如:CNY</td></tr><tr><td>entitys</td><td>List&lt;[TransInfo](https://book.e-buy.com/books/ebuy-epointvoucher/page/019d3-QIi)&gt;</td><td>否</td><td>交易列表</td><td> </td></tr><tr><td>dateDatasList</td><td>List&lt;[DateData](https://book.e-buy.com/books/ebuy-epointvoucher/page/18d80)&gt;</td><td>否</td><td>按日统计结果</td><td> </td></tr><tr><td>appNameDatasList</td><td>List&lt;[AppNameData](https://book.e-buy.com/books/ebuy-epointvoucher/page/85d8c)&gt;</td><td>否</td><td>按应用统计结果</td></tr></tbody></table>

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

```
{
    "dateDatasList": [{
        "amount": 0.02,
        "name": "20190402",
        "count": 3
    },{
        "amount": 0.02,
        "name": "20190403",
        "count": 3
    }],
    "totalcount": 3,
    "returnCode": "00",
    "totalamount": 0.02,
    "saleamount": 0.02,
    "appNameDatasList": [{
        "amount": 0.02,
        "name": "Alipay",
        "count": 2
    },{
        "amount": 0,
        "count": 1,
        "name": "Ecoupon"
    }],
    "currency": "CNY",
    "refundamount": 0,
    "returnDesc": "获取成功",
    "entitys": [
        {
            "createTime": 1569922420000,
            "returnCode": "00",
            "transtime": "183340",
            "transcationId": 514,
            "posno": "",
            "transdate": "20191001",
            "isRefund": "0",
            "amount": "333.33",
            "appName": "Ecoupon",
            "isVoid": "0",
            "orderNo": "29_36392055_1569922420023",
            "nickName": "matsuya001店長",
            "qrcode": "10010506195921748853",
            "transclass": "ecoupon-verify",
            "traceNo": "29_36392055_1569922420023"
        },
        {
            "returnCode": "00",
            "transtime": "145027",
            "amount": "0.01",
            "orderNo": "EP1904021450400686002000106",
            "nickName": "matsuya001店長",
            "transclass": "qrpay-sale",
            "isVoid": "0",
            "createTime": 1554187835000,
            "appName": "AlipayQrpay",
            "isRefund": "0",
            "transcationId": 1098,
            "transdate": "20190402"
        },
        {
            "returnCode": "00",
            "transtime": "143719",
            "amount": "0.01",
            "orderNo": "EP1904021437320686002000098",
            "nickName": "matsuya001店長",
            "transclass": "qrpay-sale",
            "isVoid": "0",
            "createTime": 1554187047000,
            "appName": "AlipayQrpay",
            "isRefund": "0",
            "transcationId": 1097,
            "transdate": "20190403"
        }
    ],
}
```