# Transaction API



# Bank Acquiring

#### **Transaction Flow**

- The requested transaction will firstly invoke [MIS-POS](https://book.e-buy.com/link/124#bkmrk-mis-pos "Installed in merchants in-store POS machine, providing the operation activity to support and exchange function") for Card swape and password input. Once [MIS-POS](https://book.e-buy.com/link/124#bkmrk-mis-pos "Installed in merchants in-store POS machine, providing the operation activity to support and exchange function") confirmed on both inputs, it will send back to [e-Buy backend](https://book.e-buy.com/link/124#bkmrk-e-buy-backend "A group /set of equipment / server to process all the transaction from e-Buy POS") server to process.

#### **action**

- `cardPayment`

**Request body，Cashier POS===>[e-Buy Backend](https://book.e-buy.com/link/124#bkmrk-e-buy-backend "A group /set of equipment / server to process all the transaction from e-Buy POS")**

<table id="bkmrk-field-type-mandatory"><thead><tr><th style="width: 139px;">Field</th><th style="width: 168px;">Type</th><th style="width: 93px;">Mandatory</th><th style="width: 192px;">Description</th><th style="width: 217px;">Memo</th></tr></thead><tbody><tr><td style="width: 139px;">traceNo</td><td style="width: 168px;">String</td><td style="width: 93px;">Yes</td><td style="width: 192px;">Cashier terminal trace no.</td><td style="width: 217px;">No repeat</td></tr><tr><td style="width: 139px;">totalAmount</td><td style="width: 168px;">Price</td><td style="width: 93px;">Yes</td><td style="width: 192px;">Total transaction amount</td><td style="width: 217px;">Unit : Dollar</td></tr><tr><td style="width: 139px;">undiscountAmount</td><td style="width: 168px;">Price</td><td style="width: 93px;">Yes</td><td style="width: 192px;">undiscountable Amount</td><td style="width: 217px;">Unit : Dollar</td></tr><tr><td style="width: 139px;">acquirer</td><td style="width: 168px;">String</td><td style="width: 93px;">Yes</td><td style="width: 192px;">Acquirer Bank</td><td style="width: 217px;">Example：citicCashpay</td></tr><tr><td style="width: 139px;">goodsDetail</td><td style="width: 168px;">List&lt;[goodsDetail](https://book.e-buy.com/link/333#bkmrk-goods-detail "goodsDetail")&gt;</td><td style="width: 93px;">Yes</td><td style="width: 192px;">Goods detail</td><td style="width: 217px;">Mandated on goods detail verification</td></tr><tr><td style="width: 139px;">memberDetail</td><td style="width: 168px;">Object&lt;[memberDetail](https://book.e-buy.com/link/333#bkmrk-member-detail "memberDetail")&gt;</td><td style="width: 93px;">No</td><td style="width: 192px;">Member information</td><td style="width: 217px;">Mandated on member payment</td></tr></tbody></table>

#### **Request body example**

```
{
    "traceNo": "99000009100010101732123",
    "totalAmount": 40.8,
    "undiscountAmount": 0,
    "acquirer": "citicCashpay",
    "goodsDetail": [
        {
            "goodsCategory": "001",
            "goodsId": "P00001",
            "goodsName": "牙膏",
            "price": 8,
            "quantity": 2,
            "rebateCode": "000"
        },
        {
            "goodsCategory": "101",
            "goodsId": "P00002",
            "goodsName": "洗发水",
            "price": 24.8,
            "quantity": 1,
            "rebateCode": "000"
        }
    ],
    "memberDetail": {
        "memberId": "M000001545",
        "memberName": "TONY",
        "grade": "1",
        "status": "1",
        "balance": 1000.00,
        "pointBalance": 30000
    }
}

```

**Response body，[e-Buy Backend](https://book.e-buy.com/link/124#bkmrk-e-buy-backend "A group /set of equipment / server to process all the transaction from e-Buy POS")===&gt;Cashier POS**

<table id="bkmrk-field-type-mandatory-0"><thead><tr><th style="width: 149px;">Field</th><th style="width: 165px;">Type</th><th style="width: 62px;">Mandatory</th><th style="width: 126px;">Description</th><th style="width: 304px;">Memo</th></tr></thead><tbody><tr><td style="width: 149px;">traceNo</td><td style="width: 165px;">String</td><td style="width: 62px;">Yes</td><td style="width: 126px;">Cashier terminal trace no.</td><td style="width: 304px;">No repeat</td></tr><tr><td style="width: 149px;">orderNo</td><td style="width: 165px;">String</td><td style="width: 62px;">Yes</td><td style="width: 126px;">Order No. from e-Buy</td><td style="width: 304px;">易百生成</td></tr><tr><td style="width: 149px;">transDate</td><td style="width: 165px;">String</td><td style="width: 62px;">Yes</td><td style="width: 126px;">Transaction time</td><td style="width: 304px;">Format：yyyyMMddHHmmss</td></tr><tr><td style="width: 149px;">returnCode</td><td style="width: 165px;">String</td><td style="width: 62px;">Yes</td><td style="width: 126px;">Return code</td><td style="width: 304px;">00 represent successful transaction, else represent fail</td></tr><tr><td style="width: 149px;">returnDesc</td><td style="width: 165px;">String</td><td style="width: 62px;">Yes</td><td style="width: 126px;">Return message</td><td style="width: 304px;">Detail explanation / error message per transaction result</td></tr><tr><td style="width: 149px;">paidAmount</td><td style="width: 165px;">Price</td><td style="width: 62px;">Yes</td><td style="width: 126px;">Total amount paid</td><td style="width: 304px;">Face Value. Unit : Dollar</td></tr><tr><td style="width: 149px;">receiptAmount</td><td style="width: 165px;">Price</td><td style="width: 62px;">No</td><td style="width: 126px;">Merchant actual received amount</td><td style="width: 304px;">Net Value. Unit : Dollar</td></tr><tr><td style="width: 149px;">invoiceAmount</td><td style="width: 165px;">Price</td><td style="width: 62px;">No</td><td style="width: 126px;">Merchant invoice amount</td><td style="width: 304px;">Unit : Dollar</td></tr><tr><td style="width: 149px;">exchangeRate</td><td style="width: 165px;">Number(8,6)</td><td style="width: 62px;">No</td><td style="width: 126px;">Exchange Rate</td><td style="width: 304px;">The rate of conversion the currency given in the request to CNY.</td></tr><tr><td style="width: 149px;">currency</td><td style="width: 165px;">String</td><td style="width: 62px;">No</td><td style="width: 126px;">Currency</td><td style="width: 304px;">For example: CNY</td></tr><tr><td style="width: 149px;">discountCode</td><td style="width: 165px;">String</td><td style="width: 62px;">No</td><td style="width: 126px;">Discount Code</td><td style="width: 304px;">assigned by Cashier POS,用于入账计折扣类型，如：2016120101|20.00表示支付20元</td></tr><tr><td style="width: 149px;">discountNum</td><td style="width: 165px;">Number</td><td style="width: 62px;">No</td><td style="width: 126px;">numbers of discountCode</td><td style="width: 304px;">用于入账计折扣类型的数量</td></tr><tr><td style="width: 149px;">tenderCode</td><td style="width: 165px;">String</td><td style="width: 62px;">No</td><td style="width: 126px;">Tender Code</td><td style="width: 304px;">assigned by Cashier POS,用于入账计支付方式，如：2016120101|20.00表示支付20元</td></tr><tr><td style="width: 149px;">activityProductNo</td><td style="width: 165px;">String</td><td style="width: 62px;">No</td><td style="width: 126px;">Activity Product no.</td><td style="width: 304px;"> </td></tr><tr><td style="width: 149px;">activityProductName</td><td style="width: 165px;">String</td><td style="width: 62px;">No</td><td style="width: 126px;">Activity Product name</td><td style="width: 304px;"> </td></tr><tr><td style="width: 149px;">needSameCard</td><td style="width: 165px;">Boolean</td><td style="width: 62px;">No</td><td style="width: 126px;">Required same card payment</td><td style="width: 304px;">Such as discount upon amount reached, same credit card must be used for the payment</td></tr><tr><td style="width: 149px;">goodsDetail</td><td style="width: 165px;">List&lt;[goodsDetail](https://book.e-buy.com/link/333#bkmrk-goods-detail "goodsDetail")&gt;</td><td style="width: 62px;">No</td><td style="width: 126px;">Paid product detail</td><td style="width: 304px;">Backend response paid product detail</td></tr><tr><td style="width: 149px;">fundChannel</td><td style="width: 165px;">List&lt;[fundChannel](https://book.e-buy.com/link/333#bkmrk-fund-channel "fundChannel")&gt;</td><td style="width: 62px;">No</td><td style="width: 126px;">Channel of fund</td><td style="width: 304px;"> </td></tr><tr><td style="width: 149px;">printDetail</td><td style="width: 165px;">Object&lt;[printDetail](https://book.e-buy.com/link/333#bkmrk-print-detail "printDetail")&gt;</td><td style="width: 62px;">No</td><td style="width: 126px;">Printing message</td><td style="width: 304px;">Provided if required to print on the receipt</td></tr><tr><td style="width: 149px;">memberDetail</td><td style="width: 165px;">Object&lt;[memberDetail](https://book.e-buy.com/link/333#bkmrk-member-detail "memberDetail")&gt;</td><td style="width: 62px;">No</td><td style="width: 126px;">Member information</td><td style="width: 304px;">Member info return message on this transaction</td></tr></tbody></table>

#### **Response body example**

```
{
    "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.xxx.com/url",
        "qrCode2": "",
        "qrCode3": "",
        "barCode1": "12345679",
        "barCode2": "",
        "barCode3": ""
    },
    "memberDetail": {
        "memberId": "M000001545",
        "memberName": "TONY",
        "grade": "1",
        "status": "1",
        "balance": 1000.00,
        "pointBalance": 30000
    }
}
```

# Card Redemption

#### **Usage**

- Bank loyalty point redemption
- Bank Loyalty point redemption + Cash payment
- Bank privilege verification
- Bank privilege verification + Cash Payment
- Prepay Card payment
- Member Card payment

#### **Transaction Flow**

- The requested transaction will will firstly invoke [MIS-POS](https://book.e-buy.com/link/124#bkmrk-mis-pos "Installed in merchants in-store POS machine, providing the operation activity to support and exchange function") for Card swape and password input. Once [MIS-POS](https://book.e-buy.com/link/124#bkmrk-mis-pos "Installed in merchants in-store POS machine, providing the operation activity to support and exchange function") confirmed on both inputs, it will send back to [e-Buy backend](https://book.e-buy.com/link/124#bkmrk-e-buy-backend "A group /set of equipment / server to process all the transaction from e-Buy POS") server to process.

#### **action**

- `cardRedemption`

**Request body，Cashier POS===&gt;[e-Buy Backend](https://book.e-buy.com/link/124#bkmrk-e-buy-backend "A group /set of equipment / server to process all the transaction from e-Buy POS")**

<table id="bkmrk-field-type-mandatory"><thead><tr><th style="width: 138px;">Field</th><th style="width: 169px;">Type</th><th style="width: 90px;">Mandatory</th><th style="width: 157px;">Description</th><th style="width: 255px;">Memo</th></tr></thead><tbody><tr><td style="width: 138px;">traceNo</td><td style="width: 169px;">String</td><td style="width: 90px;">Yes</td><td style="width: 157px;">Cashier terminal trace no.</td><td style="width: 255px;">No repeat，建议yyyyMMddHHmmss+10位流水号</td></tr><tr><td style="width: 138px;">totalAmount</td><td style="width: 169px;">Price</td><td style="width: 90px;">Yes</td><td style="width: 157px;">Total transaction amount</td><td style="width: 255px;">Unit : Dollar</td></tr><tr><td style="width: 138px;">undiscountAmount</td><td style="width: 169px;">Price</td><td style="width: 90px;">Yes</td><td style="width: 157px;">undiscountable Amount</td><td style="width: 255px;">Unit : Dollar</td></tr><tr><td style="width: 138px;">goodsDetail</td><td style="width: 169px;">List&lt;[goodsDetail](https://book.e-buy.com/link/333#bkmrk-goods-detail "goodsDetail")&gt;</td><td style="width: 90px;">Yes</td><td style="width: 157px;">Goods detail</td><td style="width: 255px;">Mandated on goods detail verification</td></tr><tr><td style="width: 138px;">memberDetail</td><td style="width: 169px;">Object&lt;[memberDetail](https://book.e-buy.com/link/333#bkmrk-member-detail "memberDetail")&gt;</td><td style="width: 90px;">No</td><td style="width: 157px;">Member information</td><td style="width: 255px;">Mandated on member payment</td></tr></tbody></table>

#### **Request body example**

```
{
    "traceNo": "99000009100010101732123",
    "totalAmount": 40.8,
    "undiscountAmount": 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.00,
        "pointBalance": 30000
    }
}

```

**Response body，[e-Buy Backend](https://book.e-buy.com/link/124#bkmrk-e-buy-backend "A group /set of equipment / server to process all the transaction from e-Buy POS")===&gt;Cashier POS**

<table id="bkmrk-field-type-mandatory-0"><thead><tr><th style="width: 150px;">Field</th><th style="width: 142px;">Type</th><th style="width: 57px;">Mandatory</th><th style="width: 154px;">Description</th><th style="width: 306px;">Memo</th></tr></thead><tbody><tr><td style="width: 150px;">traceNo</td><td style="width: 142px;">String</td><td style="width: 57px;">Yes</td><td style="width: 154px;">Cashier terminal trace no.</td><td style="width: 306px;">No repeat</td></tr><tr><td style="width: 150px;">orderNo</td><td style="width: 142px;">String</td><td style="width: 57px;">Yes</td><td style="width: 154px;">Order No. from e-Buy</td><td style="width: 306px;">易百生成</td></tr><tr><td style="width: 150px;">transDate</td><td style="width: 142px;">String</td><td style="width: 57px;">Yes</td><td style="width: 154px;">Transaction time</td><td style="width: 306px;">Format：yyyyMMddHHmmss</td></tr><tr><td style="width: 150px;">returnCode</td><td style="width: 142px;">String</td><td style="width: 57px;">Yes</td><td style="width: 154px;">Return code</td><td style="width: 306px;">00 represent successful transaction, else represent fail</td></tr><tr><td style="width: 150px;">returnDesc</td><td style="width: 142px;">String</td><td style="width: 57px;">Yes</td><td style="width: 154px;">Return message</td><td style="width: 306px;">Detail explanation / error message per transaction result</td></tr><tr><td style="width: 150px;">paidAmount</td><td style="width: 142px;">Price</td><td style="width: 57px;">Yes</td><td style="width: 154px;">Total amount paid</td><td style="width: 306px;">Face Value. Unit : Dollar</td></tr><tr><td style="width: 150px;">receiptAmount</td><td style="width: 142px;">Price</td><td style="width: 57px;">No</td><td style="width: 154px;">Merchant actual received amount</td><td style="width: 306px;">Net Value. Unit : Dollar</td></tr><tr><td style="width: 150px;">invoiceAmount</td><td style="width: 142px;">Price</td><td style="width: 57px;">No</td><td style="width: 154px;">Merchant invoice amount</td><td style="width: 306px;">Unit : Dollar</td></tr><tr><td style="width: 150px;">exchangeRate</td><td style="width: 142px;">Number(8,6)</td><td style="width: 57px;">No</td><td style="width: 154px;">Exchange Rate</td><td style="width: 306px;">The rate of conversion the currency given in the request to CNY.</td></tr><tr><td style="width: 150px;">currency</td><td style="width: 142px;">String</td><td style="width: 57px;">No</td><td style="width: 154px;">Currency</td><td style="width: 306px;">For example: CNY</td></tr><tr><td style="width: 150px;">discountCode</td><td style="width: 142px;">String</td><td style="width: 57px;">No</td><td style="width: 154px;">Discount Code</td><td style="width: 306px;">assigned by Cashier POS</td></tr><tr><td style="width: 150px;">discountNum</td><td style="width: 142px;">Number</td><td style="width: 57px;">No</td><td style="width: 154px;">numbers of discountCode</td><td style="width: 306px;">用于入账计折扣类型的数量</td></tr><tr><td style="width: 150px;">tenderCode</td><td style="width: 142px;">String</td><td style="width: 57px;">No</td><td style="width: 154px;">Tender Code</td><td style="width: 306px;">assigned by Cashier POS,用于入账计支付方式，如：2016120101|20.00表示支付20元</td></tr><tr><td style="width: 150px;">activityProductNo</td><td style="width: 142px;">String</td><td style="width: 57px;">No</td><td style="width: 154px;">Activity Product no.</td><td style="width: 306px;"> </td></tr><tr><td style="width: 150px;">activityProductName</td><td style="width: 142px;">String</td><td style="width: 57px;">No</td><td style="width: 154px;">Activity Product name</td><td style="width: 306px;"> </td></tr><tr><td style="width: 150px;">needSameCard</td><td style="width: 142px;">Boolean</td><td style="width: 57px;">No</td><td style="width: 154px;">Required same card payment</td><td style="width: 306px;">Such as discount upon amount reached, same credit card must be used for the payment</td></tr><tr><td style="width: 150px;">goodsDetail</td><td style="width: 142px;">List&lt;[goodsDetail](https://book.e-buy.com/link/333#bkmrk-goods-detail "goodsDetail")&gt;</td><td style="width: 57px;">No</td><td style="width: 154px;">Paid product detail</td><td style="width: 306px;">Backend response paid product detail</td></tr><tr><td style="width: 150px;">fundChannel</td><td style="width: 142px;">List&lt;[fundChannel](https://book.e-buy.com/link/333#bkmrk-fund-channel "fundChannel")&gt;</td><td style="width: 57px;">No</td><td style="width: 154px;">Channel of fund</td><td style="width: 306px;"> </td></tr><tr><td style="width: 150px;">printDetail</td><td style="width: 142px;">Object&lt;[printDetail](https://book.e-buy.com/link/333#bkmrk-print-detail "printDetail")&gt;</td><td style="width: 57px;">No</td><td style="width: 154px;">Printing message</td><td style="width: 306px;">Provided if required to print on the receipt</td></tr><tr><td style="width: 150px;">memberDetail</td><td style="width: 142px;">Object&lt;[memberDetail](https://book.e-buy.com/link/333#bkmrk-member-detail "memberDetail")&gt;</td><td style="width: 57px;">No</td><td style="width: 154px;">Member information</td><td style="width: 306px;">Member info return message on this transaction</td></tr></tbody></table>

#### **Response body example**

```
{
    "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.xxx.com/url",
        "qrCode2": "",
        "qrCode3": "",
        "barCode1": "12345679",
        "barCode2": "",
        "barCode3": ""
    },
    "memberDetail": {
        "memberId": "M000001545",
        "memberName": "TONY",
        "grade": "1",
        "status": "1",
        "balance": 1000.00,
        "pointBalance": 30000
    }
}
```

# Qrcode Sale

#### **Usage**

- Alipay
- Wechat Payment
- QR-Code Payment from Bank
- QR-Code point redeem from Bank
- QR-Code Payment from China UnionPay
- Baidu Payment
- Bestpay
- Other QR-Code Payment
- Product coupon/cash coupon/discount coupon/Buy M Get N Free coupon /Deduct coupon
- Take out or Self booking order

#### **Transaction Flow**

- The transaction process will collect QR code message thru scanning or direct input through keypad, and it will send to [e-Buy backend](https://book.e-buy.com/link/124#bkmrk-e-buy-backend "A group /set of equipment / server to process all the transaction from e-Buy POS") server after collection to further process.

#### **action**

- `qrcodeSale`

**Request body，Cashier POS===&gt;[e-Buy Backend](https://book.e-buy.com/link/124#bkmrk-e-buy-backend "A group /set of equipment / server to process all the transaction from e-Buy POS")**

<table id="bkmrk-field-type-mandatory" style="height: 241px;"><thead><tr style="height: 29px;"><th style="width: 142px; height: 29px;">Field</th><th style="width: 168px; height: 29px;">Type</th><th style="width: 90px; height: 29px;">Mandatory</th><th style="width: 175px; height: 29px;">Description</th><th style="width: 234px; height: 29px;">Memo</th></tr></thead><tbody><tr style="height: 29px;"><td style="width: 142px; height: 29px;">traceNo</td><td style="width: 168px; height: 29px;">String</td><td style="width: 90px; height: 29px;">Yes</td><td style="width: 175px; height: 29px;">Cashier terminal trace no.</td><td style="width: 234px; height: 29px;">No repeat</td></tr><tr style="height: 29px;"><td style="width: 142px; height: 29px;">totalAmount</td><td style="width: 168px; height: 29px;">Price</td><td style="width: 90px; height: 29px;">Yes</td><td style="width: 175px; height: 29px;">Total transaction amount</td><td style="width: 234px; height: 29px;">Unit : Dollar</td></tr><tr style="height: 29px;"><td style="width: 142px; height: 29px;">undiscountAmount</td><td style="width: 168px; height: 29px;">Price</td><td style="width: 90px; height: 29px;">Yes</td><td style="width: 175px; height: 29px;">Undiscountable Amount</td><td style="width: 234px; height: 29px;">Unit : Dollar</td></tr><tr style="height: 29px;"><td style="width: 142px; height: 29px;">qrcode</td><td style="width: 168px; height: 29px;">String</td><td style="width: 90px; height: 29px;">Yes</td><td style="width: 175px; height: 29px;">QR-Code</td><td style="width: 234px; height: 29px;">串号、一维码或二维码内容</td></tr><tr style="height: 48px;"><td style="width: 142px; height: 48px;">goodsDetail</td><td style="width: 168px; height: 48px;">List&lt;[goodsDetail](https://book.e-buy.com/link/333#bkmrk-goods-detail "goodsDetail")&gt;</td><td style="width: 90px; height: 48px;">Yes</td><td style="width: 175px; height: 48px;">Goods detail</td><td style="width: 234px; height: 48px;">Mandated on goods detail verification</td></tr><tr style="height: 48px;"><td style="width: 142px; height: 48px;">memberDetail</td><td style="width: 168px; height: 48px;">Object&lt;[memberDetail](https://book.e-buy.com/link/333#bkmrk-member-detail "memberDetail")&gt;</td><td style="width: 90px; height: 48px;">No</td><td style="width: 175px; height: 48px;">Member information</td><td style="width: 234px; height: 48px;">Mandated for member payment</td></tr></tbody></table>

#### **Request body example**

```
{
    "traceNo": "99000009100010101732123",
    "totalAmount": 40.8,
    "undiscountAmount": 0,
    "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
    }
}

```

**Response body，[e-Buy Backend](https://book.e-buy.com/link/124#bkmrk-e-buy-backend "A group /set of equipment / server to process all the transaction from e-Buy POS")===&gt;Cashier POS**

<table id="bkmrk-field-type-mandatory-0"><thead><tr><th style="width: 148px;">Field</th><th style="width: 145px;">Type</th><th style="width: 54px;">Mandatory</th><th style="width: 184px;">Description</th><th style="width: 274px;">Memo</th></tr></thead><tbody><tr><td style="width: 148px;">traceNo</td><td style="width: 145px;">String</td><td style="width: 54px;">Yes</td><td style="width: 184px;">Cashier terminal trace no.</td><td style="width: 274px;">No repeat</td></tr><tr><td style="width: 148px;">orderNo</td><td style="width: 145px;">String</td><td style="width: 54px;">Yes</td><td style="width: 184px;">Order No. from e-Buy</td><td style="width: 274px;">made by Ebuy</td></tr><tr><td style="width: 148px;">transDate</td><td style="width: 145px;">String</td><td style="width: 54px;">Yes</td><td style="width: 184px;">Transaction time</td><td style="width: 274px;">Format：yyyyMMddHHmmss</td></tr><tr><td style="width: 148px;">returnCode</td><td style="width: 145px;">String</td><td style="width: 54px;">Yes</td><td style="width: 184px;">Return code</td><td style="width: 274px;">00 represent successful transaction, else represent fail</td></tr><tr><td style="width: 148px;">returnDesc</td><td style="width: 145px;">String</td><td style="width: 54px;">Yes</td><td style="width: 184px;">Return message</td><td style="width: 274px;">Detail explanation / error message per transaction result</td></tr><tr><td style="width: 148px;">paidAmount</td><td style="width: 145px;">Price</td><td style="width: 54px;">Yes</td><td style="width: 184px;">Total amount paid</td><td style="width: 274px;">Face Value. Unit : Dollar</td></tr><tr><td style="width: 148px;">receiptAmount</td><td style="width: 145px;">Price</td><td style="width: 54px;">No</td><td style="width: 184px;">Merchant actual received amount</td><td style="width: 274px;">Net Value. Unit : Dollar</td></tr><tr><td style="width: 148px;">invoiceAmount</td><td style="width: 145px;">Price</td><td style="width: 54px;">No</td><td style="width: 184px;">Merchant invoice amount</td><td style="width: 274px;">Unit : Dollar</td></tr><tr><td style="width: 148px;">exchangeRate</td><td style="width: 145px;">Number(8,6)</td><td style="width: 54px;">No</td><td style="width: 184px;">Exchange Rate</td><td style="width: 274px;">The rate of conversion the currency given in the request to CNY.</td></tr><tr><td style="width: 148px;">currency</td><td style="width: 145px;">String</td><td style="width: 54px;">No</td><td style="width: 184px;">Currency</td><td style="width: 274px;">For example: CNY</td></tr><tr><td style="width: 148px;">discountCode</td><td style="width: 145px;">String</td><td style="width: 54px;">No</td><td style="width: 184px;">Discount Code</td><td style="width: 274px;">assigned by Cashier POS</td></tr><tr><td style="width: 148px;">discountNum</td><td style="width: 145px;">Number</td><td style="width: 54px;">No</td><td style="width: 184px;">numbers of discountCode</td><td style="width: 274px;">用于入账计折扣类型的数量</td></tr><tr><td style="width: 148px;">tenderCode</td><td style="width: 145px;">String</td><td style="width: 54px;">No</td><td style="width: 184px;">Tender Code</td><td style="width: 274px;">assigned by Cashier POS,record payment method，like：2016120101|20.00 is payment 20yuan</td></tr><tr><td style="width: 148px;">activityProductNo</td><td style="width: 145px;">String</td><td style="width: 54px;">No</td><td style="width: 184px;">Activity Product no.</td><td style="width: 274px;"> </td></tr><tr><td style="width: 148px;">activityProductName</td><td style="width: 145px;">String</td><td style="width: 54px;">No</td><td style="width: 184px;">Activity Product name</td><td style="width: 274px;"> </td></tr><tr><td style="width: 148px;">goodsDetail</td><td style="width: 145px;">List&lt;[goodsDetail](https://book.e-buy.com/link/333#bkmrk-goods-detail "goodsDetail")&gt;</td><td style="width: 54px;">No</td><td style="width: 184px;">Paid product detail</td><td style="width: 274px;">Backend response paid product detail</td></tr><tr><td style="width: 148px;">fundChannel</td><td style="width: 145px;">List&lt;[fundChannel](https://book.e-buy.com/link/333#bkmrk-fund-channel "fundChannel")&gt;</td><td style="width: 54px;">No</td><td style="width: 184px;">Channel of fund</td><td style="width: 274px;"> </td></tr><tr><td style="width: 148px;">printDetail</td><td style="width: 145px;">Object&lt;[printDetail](https://book.e-buy.com/link/333#bkmrk-print-detail "printDetail")&gt;</td><td style="width: 54px;">No</td><td style="width: 184px;">Printing message</td><td style="width: 274px;">Provided if required to print on the receipt</td></tr><tr><td style="width: 148px;">memberDetail</td><td style="width: 145px;">Object&lt;[memberDetail](https://book.e-buy.com/link/333#bkmrk-member-detail "memberDetail")&gt;</td><td style="width: 54px;">No</td><td style="width: 184px;">Member information</td><td style="width: 274px;">Member info return message on this transaction</td></tr></tbody></table>

#### **Response body example**

```
{
    "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": "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.xxx.com/url",
        "qrCode2": "",
        "qrCode3": "",
        "barCode1": "12345679",
        "barCode2": "",
        "barCode3": ""
    },
    "memberDetail": {
        "memberId": "M000001545",
        "memberName": "TONY",
        "grade": "1",
        "status": "1",
        "balance": 1000.00,
        "pointBalance": 30000
    }
}
```

# Trans Inquiry

#### **Usage**

- Invoke this API to inquiry last transaction result when it is timed out.

#### **action**

- `inquiry`

**Request body，Cashier POS===&gt;[e-Buy Backend](https://book.e-buy.com/link/124#bkmrk-e-buy-backend "A group /set of equipment / server to process all the transaction from e-Buy POS")**

<table id="bkmrk-field-type-mandatory"><thead><tr><th>Field</th><th>Type</th><th>Mandatory</th><th>Description</th><th>Memo</th></tr></thead><tbody><tr><td>traceNo</td><td>String</td><td>Yes</td><td>Cashier trace no.</td><td>No repeat</td></tr><tr><td>originalTraceNo</td><td>String</td><td>Yes</td><td>Original Cashier trace no.</td><td>传入需要查询的原交易收银机流水号</td></tr></tbody></table>

#### **Request body example**

```
{
    "traceNo": "99000009100010101732123",
    "originalTraceNo": "99000009100010101732124"
}

```

**Response body，[e-Buy Backend](https://book.e-buy.com/link/124#bkmrk-e-buy-backend "A group /set of equipment / server to process all the transaction from e-Buy POS")===&gt;Cashier POS**

<table id="bkmrk-field-type-mandatory-0" style="height: 844px;"><thead><tr style="height: 45px;"><th style="width: 150px; height: 45px;">Field</th><th style="width: 142px; height: 45px;">Type</th><th style="width: 57px; height: 45px;">Mandatory</th><th style="width: 182px; height: 45px;">Description</th><th style="width: 276px; height: 45px;">Memo</th></tr></thead><tbody><tr style="height: 29px;"><td style="width: 150px; height: 29px;">traceNo</td><td style="width: 142px; height: 29px;">String</td><td style="width: 57px; height: 29px;">Yes</td><td style="width: 182px; height: 29px;">Cashier terminal trace no.</td><td style="width: 276px; height: 29px;">No repeat</td></tr><tr style="height: 29px;"><td style="width: 150px; height: 29px;">orderNo</td><td style="width: 142px; height: 29px;">String</td><td style="width: 57px; height: 29px;">Yes</td><td style="width: 182px; height: 29px;">Order No. from e-Buy</td><td style="width: 276px; height: 29px;">Unit：Dollar</td></tr><tr style="height: 29px;"><td style="width: 150px; height: 29px;">transDate</td><td style="width: 142px; height: 29px;">String</td><td style="width: 57px; height: 29px;">Yes</td><td style="width: 182px; height: 29px;">Transaction time</td><td style="width: 276px; height: 29px;">Format：yyyyMMddHHmmss</td></tr><tr style="height: 45px;"><td style="width: 150px; height: 45px;">returnCode</td><td style="width: 142px; height: 45px;">String</td><td style="width: 57px; height: 45px;">Yes</td><td style="width: 182px; height: 45px;">Return code</td><td style="width: 276px; height: 45px;">00 represent successful transaction, else represent fail</td></tr><tr style="height: 45px;"><td style="width: 150px; height: 45px;">returnDesc</td><td style="width: 142px; height: 45px;">String</td><td style="width: 57px; height: 45px;">Yes</td><td style="width: 182px; height: 45px;">Return message</td><td style="width: 276px; height: 45px;">Detail explanation / error message per transaction result</td></tr><tr style="height: 29px;"><td style="width: 150px; height: 29px;">paidAmount</td><td style="width: 142px; height: 29px;">Price</td><td style="width: 57px; height: 29px;">Yes</td><td style="width: 182px; height: 29px;">Total amount paid</td><td style="width: 276px; height: 29px;">Face Value. Unit : Dollar</td></tr><tr style="height: 45px;"><td style="width: 150px; height: 45px;">receiptAmount</td><td style="width: 142px; height: 45px;">Price</td><td style="width: 57px; height: 45px;">No</td><td style="width: 182px; height: 45px;">Merchant actual received amount</td><td style="width: 276px; height: 45px;">Net Value. Unit : Dollar</td></tr><tr style="height: 29px;"><td style="width: 150px; height: 29px;">invoiceAmount</td><td style="width: 142px; height: 29px;">Price</td><td style="width: 57px; height: 29px;">No</td><td style="width: 182px; height: 29px;">Merchant invoice amount</td><td style="width: 276px; height: 29px;">Unit : Dollar</td></tr><tr style="height: 45px;"><td style="width: 150px; height: 45px;">exchangeRate</td><td style="width: 142px; height: 45px;">Number(8,6)</td><td style="width: 57px; height: 45px;">No</td><td style="width: 182px; height: 45px;">Exchange Rate</td><td style="width: 276px; height: 45px;">The rate of conversion the currency given in the request to CNY.</td></tr><tr style="height: 29px;"><td style="width: 150px; height: 29px;">currency</td><td style="width: 142px; height: 29px;">String</td><td style="width: 57px; height: 29px;">No</td><td style="width: 182px; height: 29px;">Currency</td><td style="width: 276px; height: 29px;">For example: CNY</td></tr><tr style="height: 61px;"><td style="width: 150px; height: 61px;">discountCode</td><td style="width: 142px; height: 61px;">String</td><td style="width: 57px; height: 61px;">No</td><td style="width: 182px; height: 61px;">Discount Code</td><td style="width: 276px; height: 61px;">assigned by Cashier POS，用于入账计折扣类型，如：2016120102|10.00表示折扣10元</td></tr><tr style="height: 29px;"><td style="width: 150px; height: 29px;">discountNum</td><td style="width: 142px; height: 29px;">Number</td><td style="width: 57px; height: 29px;">No</td><td style="width: 182px; height: 29px;">numbers of discountCode</td><td style="width: 276px; height: 29px;">用于入账计折扣类型的数量</td></tr><tr style="height: 61px;"><td style="width: 150px; height: 61px;">tenderCode</td><td style="width: 142px; height: 61px;">String</td><td style="width: 57px; height: 61px;">No</td><td style="width: 182px; height: 61px;">Tender Code</td><td style="width: 276px; height: 61px;">assigned by Cashier POS，用于入账计支付方式，如：2016120101|20.00表示支付20元</td></tr><tr style="height: 29px;"><td style="width: 150px; height: 29px;">activityProductNo</td><td style="width: 142px; height: 29px;">String</td><td style="width: 57px; height: 29px;">No</td><td style="width: 182px; height: 29px;">Activity Product no.</td><td style="width: 276px; height: 29px;"> </td></tr><tr style="height: 29px;"><td style="width: 150px; height: 29px;">activityProductName</td><td style="width: 142px; height: 29px;">String</td><td style="width: 57px; height: 29px;">No</td><td style="width: 182px; height: 29px;">Activity Product name</td><td style="width: 276px; height: 29px;"> </td></tr><tr style="height: 61px;"><td style="width: 150px; height: 61px;">needSameCard</td><td style="width: 142px; height: 61px;">Boolean</td><td style="width: 57px; height: 61px;">No</td><td style="width: 182px; height: 61px;">Required same card payment</td><td style="width: 276px; height: 61px;">Such as discount upon amount reached, same credit card must be used for the payment</td></tr><tr style="height: 35px;"><td style="width: 150px; height: 35px;">goodsDetail</td><td style="width: 142px; height: 35px;">List&lt;[goodsDetail](https://book.e-buy.com/link/333#bkmrk-goods-detail "goodsDetail")&gt;</td><td style="width: 57px; height: 35px;">No</td><td style="width: 182px; height: 35px;">Paid product detail</td><td style="width: 276px; height: 35px;">Backend response paid product detail</td></tr><tr style="height: 35px;"><td style="width: 150px; height: 35px;">fundChannel</td><td style="width: 142px; height: 35px;">List&lt;[fundChannel](https://book.e-buy.com/link/333#bkmrk-fund-channel "fundChannel")&gt;</td><td style="width: 57px; height: 35px;">No</td><td style="width: 182px; height: 35px;">Channel of fund</td><td style="width: 276px; height: 35px;"> </td></tr><tr style="height: 48px;"><td style="width: 150px; height: 48px;">printDetail</td><td style="width: 142px; height: 48px;">Object&lt;[printDetail](https://book.e-buy.com/link/333#bkmrk-print-detail "printDetail")&gt;</td><td style="width: 57px; height: 48px;">No</td><td style="width: 182px; height: 48px;">Printing message</td><td style="width: 276px; height: 48px;">Provided if required to print on the receipt</td></tr><tr style="height: 57px;"><td style="width: 150px; height: 57px;">memberDetail</td><td style="width: 142px; height: 57px;">Object&lt;[memberDetail](https://book.e-buy.com/link/333#bkmrk-member-detail "memberDetail")&gt;</td><td style="width: 57px; height: 57px;">No</td><td style="width: 182px; height: 57px;">Member information</td><td style="width: 276px; height: 57px;">Member info return message on this transaction</td></tr></tbody></table>

#### **Response body example**

```
{
    "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": "2016123102",
    "activityProductName": "支付宝支付",
    "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.00,
        "pointBalance": 30000
    }
}

```

#### **Transaction support inquiry**

- cardSale
- qrcodeSale

# Trans Void(card)

#### **Usage**

- Invoke this API to reverse a transaction that dedicated by originalTraceNo.

#### **Transaction Flow**

- The requested transaction will send to [e-Buy backend](https://book.e-buy.com/link/124#bkmrk-e-buy-backend "A group /set of equipment / server to process all the transaction from e-Buy POS") server, it will firstly invoke [MIS-POS](https://book.e-buy.com/link/124#bkmrk-mis-pos "Installed in merchants in-store POS machine, providing the operation activity to support and exchange function") for Card swape and password input. Once [MIS-POS](https://book.e-buy.com/link/124#bkmrk-mis-pos "Installed in merchants in-store POS machine, providing the operation activity to support and exchange function") confirmed on both inputs, it will send back to [e-Buy backend](https://book.e-buy.com/link/124#bkmrk-e-buy-backend "A group /set of equipment / server to process all the transaction from e-Buy POS") server to process.

#### **action**

- `voidCardSale`

**Request body，Cashier POS===&gt;[e-Buy Backend](https://book.e-buy.com/link/124#bkmrk-e-buy-backend "A group /set of equipment / server to process all the transaction from e-Buy POS")**

<table id="bkmrk-field-type-mandatory"><thead><tr><th style="width: 117px;">Field</th><th style="width: 85px;">Type</th><th style="width: 100px;">Mandatory</th><th style="width: 205px;">Description</th><th style="width: 300px;">Memo</th></tr></thead><tbody><tr><td style="width: 117px;">traceNo</td><td style="width: 85px;">String</td><td style="width: 100px;">Yes</td><td style="width: 205px;">Cashier terminal trace no.</td><td style="width: 300px;">No repeat</td></tr><tr><td style="width: 117px;">originalTraceNo</td><td style="width: 85px;">String</td><td style="width: 100px;">Yes</td><td style="width: 205px;">last Cashier terminal trace no.</td><td style="width: 300px;">Cashier terminal trace no. in last transaction</td></tr><tr><td style="width: 117px;">acquirer</td><td style="width: 85px;">String</td><td style="width: 100px;">No</td><td style="width: 205px;">Acquirer Bank</td><td style="width: 300px;">Example：citicCashpay表示中信收单，如果收单撤销是必填的</td></tr></tbody></table>

#### **Request body example**

```
{
    "traceNo": "99000009100010101732123",
    "originalTraceNo": "99000009100010101732124",
    "acquirer": "citicCashpay"
}

```

**Response body，[e-Buy Backend](https://book.e-buy.com/link/124#bkmrk-e-buy-backend "A group /set of equipment / server to process all the transaction from e-Buy POS")===&gt;Cashier POS**

<table id="bkmrk-field-type-mandatory-0"><thead><tr><th style="width: 105px;">Field</th><th style="width: 147px;">Type</th><th style="width: 57px;">Mandatory</th><th style="width: 137px;">Description</th><th style="width: 361px;">Memo</th></tr></thead><tbody><tr><td style="width: 105px;">traceNo</td><td style="width: 147px;">String</td><td style="width: 57px;">Yes</td><td style="width: 137px;">Cashier terminal trace no.</td><td style="width: 361px;">No repeat</td></tr><tr><td style="width: 105px;">orderNo</td><td style="width: 147px;">String</td><td style="width: 57px;">Yes</td><td style="width: 137px;">Order No. from e-Buy</td><td style="width: 361px;"> </td></tr><tr><td style="width: 105px;">transDate</td><td style="width: 147px;">String</td><td style="width: 57px;">Yes</td><td style="width: 137px;">Transaction time</td><td style="width: 361px;">Format：yyyyMMddHHmmss</td></tr><tr><td style="width: 105px;">returnCode</td><td style="width: 147px;">String</td><td style="width: 57px;">Yes</td><td style="width: 137px;">Return code</td><td style="width: 361px;">00 represent successful transaction, else represent fail</td></tr><tr><td style="width: 105px;">returnDesc</td><td style="width: 147px;">String</td><td style="width: 57px;">Yes</td><td style="width: 137px;">Return message</td><td style="width: 361px;">Detail explanation / error message per transaction result</td></tr><tr><td style="width: 105px;">discountCode</td><td style="width: 147px;">String</td><td style="width: 57px;">No</td><td style="width: 137px;">Discount Code</td><td style="width: 361px;">assigned by Cashier POS</td></tr><tr><td style="width: 105px;">tenderCode</td><td style="width: 147px;">String</td><td style="width: 57px;">No</td><td style="width: 137px;">Tender Code</td><td style="width: 361px;">assigned by Cashier POS,record payment method，like：2016120101|20.00 is payment 20yuan</td></tr><tr><td style="width: 105px;">fundChannel</td><td style="width: 147px;">List&lt;[fundChannel](https://book.e-buy.com/link/333#bkmrk-fund-channel "fundChannel")&gt;</td><td style="width: 57px;">No</td><td style="width: 137px;">Channel of fund</td><td style="width: 361px;"> </td></tr><tr><td style="width: 105px;">printDetail</td><td style="width: 147px;">Object&lt;[printDetail](https://book.e-buy.com/link/333#bkmrk-print-detail "printDetail")&gt;</td><td style="width: 57px;">No</td><td style="width: 137px;">Printing message</td><td style="width: 361px;">Provided if required to print on the receipt</td></tr><tr><td style="width: 105px;">memberDetail</td><td style="width: 147px;">Object&lt;[memberDetail](https://book.e-buy.com/link/333#bkmrk-member-detail "memberDetail")&gt;</td><td style="width: 57px;">No</td><td style="width: 137px;">Member information</td><td style="width: 361px;">Member info return message on this transaction</td></tr></tbody></table>

#### **Response body example**

```
{
    "traceNo": "99000009100010101732123",
    "orderNo": "171698602301",
    "transDate": "20161231120533",
    "returnCode": "00",
    "returnDesc": "SUCCESS",
    "discountCode": "0001",
    "tenderCode": "8001",
    "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
    }
}

```

#### **Transaction support void**

- cardPayment
- cardRedemption

# Trans Void(qrcode)

#### **Usage**

- Invoke this API to reverse a transaction that dedicated by originalTraceNo.

#### **action**

- `voidQrcodeSale`

**Request body，Cashier POS===&gt;[e-Buy Backend](https://book.e-buy.com/link/124#bkmrk-e-buy-backend "A group /set of equipment / server to process all the transaction from e-Buy POS")**

<table id="bkmrk-field-type-mandatory"><thead><tr><th>Field</th><th>Type</th><th>Mandatory</th><th>Description</th><th>Memo</th></tr></thead><tbody><tr><td>traceNo</td><td>String</td><td>Yes</td><td>Cashier terminal trace no.</td><td>No repeat</td></tr><tr><td>originalTraceNo</td><td>String</td><td>Yes</td><td>last Cashier terminal trace no.</td><td>Cashier terminal trace no. in last transaction</td></tr></tbody></table>

#### **Request body example**

```
{
    "traceNo": "99000009100010101732123",
    "originalTraceNo": "99000009100010101732124"
}

```

**Response body，[e-Buy Backend](https://book.e-buy.com/link/124#bkmrk-e-buy-backend "A group /set of equipment / server to process all the transaction from e-Buy POS")===&gt;Cashier POS**

<table id="bkmrk-field-type-mandatory-0"><thead><tr><th style="width: 105px;">Field</th><th style="width: 147px;">Type</th><th style="width: 57px;">Mandatory</th><th style="width: 132px;">Description</th><th style="width: 366px;">Memo</th></tr></thead><tbody><tr><td style="width: 105px;">traceNo</td><td style="width: 147px;">String</td><td style="width: 57px;">Yes</td><td style="width: 132px;">Cashier terminal trace no.</td><td style="width: 366px;">No repeat</td></tr><tr><td style="width: 105px;">orderNo</td><td style="width: 147px;">String</td><td style="width: 57px;">Yes</td><td style="width: 132px;">Order No. from e-Buy</td><td style="width: 366px;"> </td></tr><tr><td style="width: 105px;">transDate</td><td style="width: 147px;">String</td><td style="width: 57px;">Yes</td><td style="width: 132px;">Transaction time</td><td style="width: 366px;">Format：yyyyMMddHHmmss</td></tr><tr><td style="width: 105px;">returnCode</td><td style="width: 147px;">String</td><td style="width: 57px;">Yes</td><td style="width: 132px;">Return code</td><td style="width: 366px;">00 represent successful transaction, else represent fail</td></tr><tr><td style="width: 105px;">returnDesc</td><td style="width: 147px;">String</td><td style="width: 57px;">Yes</td><td style="width: 132px;">Return message</td><td style="width: 366px;">Detail explanation / error message per transaction result</td></tr><tr><td style="width: 105px;">discountCode</td><td style="width: 147px;">String</td><td style="width: 57px;">No</td><td style="width: 132px;">Discount Code</td><td style="width: 366px;">assigned by Cashier POS</td></tr><tr><td style="width: 105px;">tenderCode</td><td style="width: 147px;">String</td><td style="width: 57px;">No</td><td style="width: 132px;">Tender Code</td><td style="width: 366px;">assigned by Cashier POS,record payment method，like：2016120101|20.00 is payment 20yuan</td></tr><tr><td style="width: 105px;">fundChannel</td><td style="width: 147px;">List&lt;[fundChannel](https://book.e-buy.com/link/333#bkmrk-fund-channel "fundChannel")&gt;</td><td style="width: 57px;">No</td><td style="width: 132px;">Channel of fund</td><td style="width: 366px;"> </td></tr><tr><td style="width: 105px;">printDetail</td><td style="width: 147px;">Object&lt;[printDetail](https://book.e-buy.com/link/333#bkmrk-print-detail "printDetail")&gt;</td><td style="width: 57px;">No</td><td style="width: 132px;">Printing message</td><td style="width: 366px;">Provided if required to print on the receipt</td></tr><tr><td style="width: 105px;">memberDetail</td><td style="width: 147px;">Object&lt;[memberDetail](https://book.e-buy.com/link/333#bkmrk-member-detail "memberDetail")&gt;</td><td style="width: 57px;">No</td><td style="width: 132px;">Member information</td><td style="width: 366px;">Member info return message on this transaction</td></tr></tbody></table>

#### **Response body example**

```
{
    "traceNo": "99000009100010101732123",
    "orderNo": "171698602301",
    "transDate": "20161231120533",
    "returnCode": "00",
    "returnDesc": "SUCCESS",
    "discountCode": "0001",
    "tenderCode": "8001",
    "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
    }
}

```

#### **Transaction support void**

- qrcodeSale

# Trans Refund(card)

#### **Usage**

- Invoke this API to refund a transaction that dedicated by originalTraceNo.

#### **Transaction Flow**

- The requested transaction will firstly invoke [MIS-POS](https://book.e-buy.com/link/124#bkmrk-mis-pos "Installed in merchants in-store POS machine, providing the operation activity to support and exchange function") for Card swape and password input. Once [MIS-POS](https://book.e-buy.com/link/124#bkmrk-mis-pos "Installed in merchants in-store POS machine, providing the operation activity to support and exchange function") confirmed on both inputs, it will send back to [e-Buy backend](https://book.e-buy.com/link/124#bkmrk-e-buy-backend "A group /set of equipment / server to process all the transaction from e-Buy POS") server to process.

#### **action**

- `refundCardSale`

**Request body，Cashier POS===&gt;[e-Buy Backend](https://book.e-buy.com/link/124#bkmrk-e-buy-backend "A group /set of equipment / server to process all the transaction from e-Buy POS")**

<table id="bkmrk-field-type-mandatory"><thead><tr><th>Field</th><th>Type</th><th>Mandatory</th><th>Description</th><th>Memo</th></tr></thead><tbody><tr><td>traceNo</td><td>String</td><td>Yes</td><td>Cashier terminal trace no.</td><td>No repeat</td></tr><tr><td>originalTraceNo</td><td>String</td><td>Yes</td><td>last Cashier terminal trace no.</td><td>Cashier terminal trace no. in last transaction</td></tr><tr><td>refundAmount</td><td>Price</td><td>Yes</td><td>Refund Amount</td><td>Unit：Dollar</td></tr><tr><td>acquirer</td><td>String</td><td>No</td><td>Acquirer Bank</td><td>Example：citicCashpay</td></tr></tbody></table>

#### **Request body example**

```
{
    "traceNo": "99000009100010101732123",
    "originalTraceNo": "99000009100010101732124",
    "refundAmount": 40.8,
    "acquirer": "citicCashpay"
}

```

**Response body，[e-Buy Backend](https://book.e-buy.com/link/124#bkmrk-e-buy-backend "A group /set of equipment / server to process all the transaction from e-Buy POS")===&gt;Cashier POS**

<table id="bkmrk-field-type-mandatory-0" style="height: 484px;"><thead><tr style="height: 45px;"><th style="width: 108px; height: 45px;">Field</th><th style="width: 145px; height: 45px;">Type</th><th style="width: 60px; height: 45px;">Mandatory</th><th style="width: 174px; height: 45px;">Description</th><th style="width: 318px; height: 45px;">Memo</th></tr></thead><tbody><tr style="height: 45px;"><td style="width: 108px; height: 45px;">traceNo</td><td style="width: 145px; height: 45px;">String</td><td style="width: 60px; height: 45px;">Yes</td><td style="width: 174px; height: 45px;">Cashier terminal trace no.</td><td style="width: 318px; height: 45px;">No repeat</td></tr><tr style="height: 45px;"><td style="width: 108px; height: 45px;">orderNo</td><td style="width: 145px; height: 45px;">String</td><td style="width: 60px; height: 45px;">Yes</td><td style="width: 174px; height: 45px;">Order No. from e-Buy</td><td style="width: 318px; height: 45px;"> </td></tr><tr style="height: 29px;"><td style="width: 108px; height: 29px;">transDate</td><td style="width: 145px; height: 29px;">String</td><td style="width: 60px; height: 29px;">Yes</td><td style="width: 174px; height: 29px;">Transaction time</td><td style="width: 318px; height: 29px;">Format：yyyyMMddHHmmss</td></tr><tr style="height: 45px;"><td style="width: 108px; height: 45px;">returnCode</td><td style="width: 145px; height: 45px;">String</td><td style="width: 60px; height: 45px;">Yes</td><td style="width: 174px; height: 45px;">Return code</td><td style="width: 318px; height: 45px;">00 represent successful transaction, else represent fail</td></tr><tr style="height: 45px;"><td style="width: 108px; height: 45px;">returnDesc</td><td style="width: 145px; height: 45px;">String</td><td style="width: 60px; height: 45px;">Yes</td><td style="width: 174px; height: 45px;">Return message</td><td style="width: 318px; height: 45px;">Detail explanation / error message per transaction result</td></tr><tr style="height: 29px;"><td style="width: 108px; height: 29px;">refundAmount</td><td style="width: 145px; height: 29px;">Price</td><td style="width: 60px; height: 29px;">Yes</td><td style="width: 174px; height: 29px;">Refunded Amount</td><td style="width: 318px; height: 29px;">Unit：Dollar</td></tr><tr style="height: 29px;"><td style="width: 108px; height: 29px;">discountCode</td><td style="width: 145px; height: 29px;">String</td><td style="width: 60px; height: 29px;">No</td><td style="width: 174px; height: 29px;">Discount Code</td><td style="width: 318px; height: 29px;">assigned by Cashier POS</td></tr><tr style="height: 45px;"><td style="width: 108px; height: 45px;">tenderCode</td><td style="width: 145px; height: 45px;">String</td><td style="width: 60px; height: 45px;">No</td><td style="width: 174px; height: 45px;">Tender Code</td><td style="width: 318px; height: 45px;">assigned by Cashier POS,record payment method，like：2016120101|20.00 is payment 20yuan</td></tr><tr style="height: 35px;"><td style="width: 108px; height: 35px;">fundChannel</td><td style="width: 145px; height: 35px;">List&lt;[fundChannel](https://book.e-buy.com/link/333#bkmrk-fund-channel "fundChannel")&gt;</td><td style="width: 60px; height: 35px;">No</td><td style="width: 174px; height: 35px;">Channel of fund</td><td style="width: 318px; height: 35px;"> </td></tr><tr style="height: 35px;"><td style="width: 108px; height: 35px;">printDetail</td><td style="width: 145px; height: 35px;">Object&lt;[printDetail](https://book.e-buy.com/link/333#bkmrk-print-detail "printDetail")&gt;</td><td style="width: 60px; height: 35px;">No</td><td style="width: 174px; height: 35px;">Printing message</td><td style="width: 318px; height: 35px;">Provided if required to print on the receipt</td></tr><tr style="height: 57px;"><td style="width: 108px; height: 57px;">memberDetail</td><td style="width: 145px; height: 57px;">Object&lt;[memberDetail](https://book.e-buy.com/link/333#bkmrk-member-detail "memberDetail")&gt;</td><td style="width: 60px; height: 57px;">No</td><td style="width: 174px; height: 57px;">Member information</td><td style="width: 318px; height: 57px;">Member info return message on this transaction</td></tr></tbody></table>

#### **Response body example**

```
{
    "traceNo": "99000009100010101732123",
    "orderNo": "171698602301",
    "transDate": "20161231120533",
    "returnCode": "00",
    "returnDesc": "SUCCESS",
    "discountCode": "0001",
    "tenderCode": "8001",
    "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.00,
        "pointBalance": 30000
    }
}

```

#### **Transaction support refund**

- cardPayment
- CardRedemption

# Trans Refund(qrcode)

#### **Usage**

- Invoke this API to refund a transaction that dedicated by originalTraceNo.

#### **action**

- `refundQrcodeSale`

**Request body，Cashier POS===&gt;[e-Buy Backend](https://book.e-buy.com/link/124#bkmrk-e-buy-backend "A group /set of equipment / server to process all the transaction from e-Buy POS")**

<table id="bkmrk-field-type-mandatory"><thead><tr><th>Field</th><th>Type</th><th>Mandatory</th><th>Description</th><th>Memo</th></tr></thead><tbody><tr><td>traceNo</td><td>String</td><td>Yes</td><td>Cashier terminal trace no.</td><td>No repeat</td></tr><tr><td>originalTraceNo</td><td>String</td><td>Yes</td><td>last Cashier terminal trace no.</td><td>Cashier terminal trace no. in last transaction</td></tr><tr><td>refundAmount</td><td>Price</td><td>Yes</td><td>Refund Amount</td><td>Unit：Dollar</td></tr></tbody></table>

#### **Request body example**

```
{
    "traceNo": "99000009100010101732123",
    "originalTraceNo": "99000009100010101732124",
    "refundAmount": 40.8
}

```

**Response body，[e-Buy Backend](https://book.e-buy.com/link/124#bkmrk-e-buy-backend "A group /set of equipment / server to process all the transaction from e-Buy POS")===&gt;Cashier POS**

<table id="bkmrk-field-type-mandatory-0" style="height: 484px;"><thead><tr style="height: 45px;"><th style="width: 105px; height: 45px;">Field</th><th style="width: 148px; height: 45px;">Type</th><th style="width: 56px; height: 45px;">Mandatory</th><th style="width: 140px; height: 45px;">Description</th><th style="width: 355px; height: 45px;">Memo</th></tr></thead><tbody><tr style="height: 45px;"><td style="width: 105px; height: 45px;">traceNo</td><td style="width: 148px; height: 45px;">String</td><td style="width: 56px; height: 45px;">Yes</td><td style="width: 140px; height: 45px;">Cashier terminal trace no.</td><td style="width: 355px; height: 45px;">No repeat</td></tr><tr style="height: 45px;"><td style="width: 105px; height: 45px;">orderNo</td><td style="width: 148px; height: 45px;">String</td><td style="width: 56px; height: 45px;">Yes</td><td style="width: 140px; height: 45px;">Order No. from e-Buy</td><td style="width: 355px; height: 45px;"> </td></tr><tr style="height: 29px;"><td style="width: 105px; height: 29px;">transDate</td><td style="width: 148px; height: 29px;">String</td><td style="width: 56px; height: 29px;">Yes</td><td style="width: 140px; height: 29px;">Transaction time</td><td style="width: 355px; height: 29px;">Format：yyyyMMddHHmmss</td></tr><tr style="height: 29px;"><td style="width: 105px; height: 29px;">returnCode</td><td style="width: 148px; height: 29px;">String</td><td style="width: 56px; height: 29px;">Yes</td><td style="width: 140px; height: 29px;">Return code</td><td style="width: 355px; height: 29px;">00 represent successful transaction, else represent fail</td></tr><tr style="height: 45px;"><td style="width: 105px; height: 45px;">returnDesc</td><td style="width: 148px; height: 45px;">String</td><td style="width: 56px; height: 45px;">Yes</td><td style="width: 140px; height: 45px;">Return message</td><td style="width: 355px; height: 45px;">Detail explanation / error message per transaction result</td></tr><tr style="height: 45px;"><td style="width: 105px; height: 45px;">refundAmount</td><td style="width: 148px; height: 45px;">Price</td><td style="width: 56px; height: 45px;">Yes</td><td style="width: 140px; height: 45px;">Refunded Amount</td><td style="width: 355px; height: 45px;">Unit：Dollar</td></tr><tr style="height: 29px;"><td style="width: 105px; height: 29px;">discountCode</td><td style="width: 148px; height: 29px;">String</td><td style="width: 56px; height: 29px;">No</td><td style="width: 140px; height: 29px;">Discount Code</td><td style="width: 355px; height: 29px;">assigned by Cashier POS</td></tr><tr style="height: 45px;"><td style="width: 105px; height: 45px;">tenderCode</td><td style="width: 148px; height: 45px;">String</td><td style="width: 56px; height: 45px;">No</td><td style="width: 140px; height: 45px;">Tender Code</td><td style="width: 355px; height: 45px;">assigned by Cashier POS,record payment method，like：2016120101|20.00 is payment 20yuan</td></tr><tr style="height: 35px;"><td style="width: 105px; height: 35px;">fundChannel</td><td style="width: 148px; height: 35px;">List&lt;[fundChannel](https://book.e-buy.com/link/333#bkmrk-fund-channel "fundChannel")&gt;</td><td style="width: 56px; height: 35px;">No</td><td style="width: 140px; height: 35px;">Channel of fund</td><td style="width: 355px; height: 35px;"> </td></tr><tr style="height: 35px;"><td style="width: 105px; height: 35px;">printDetail</td><td style="width: 148px; height: 35px;">Object&lt;[printDetail](https://book.e-buy.com/link/333#bkmrk-print-detail "printDetail")&gt;</td><td style="width: 56px; height: 35px;">No</td><td style="width: 140px; height: 35px;">Printing message</td><td style="width: 355px; height: 35px;">Provided if required to print on the receipt</td></tr><tr style="height: 57px;"><td style="width: 105px; height: 57px;">memberDetail</td><td style="width: 148px; height: 57px;">Object&lt;[memberDetail](https://book.e-buy.com/link/333#bkmrk-member-detail "memberDetail")&gt;</td><td style="width: 56px; height: 57px;">No</td><td style="width: 140px; height: 57px;">Member information</td><td style="width: 355px; height: 57px;">Member info return message on this transaction</td></tr></tbody></table>

#### **Response body example**

```
{
    "traceNo": "99000009100010101732123",
    "orderNo": "171698602301",
    "transDate": "20161231120533",
    "returnCode": "00",
    "returnDesc": "SUCCESS",
    "refundAmount": 40.8,
    "discountCode": "0001",
    "tenderCode": "8001",
    "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
    }
}

```

#### **Transaction support refund**

- qrcodeSale

# Ecoupon Inquiry

#### **Usage**

- Inquiry product detail \\ balance \\ activity of this coupon, support e-Buy Ecoupon and thirdparty ecoupon.

#### **Transaction Flow**

- The transaction process will collect QR code message thru scanning or direct input through keypad, and it will send to [e-Buy backend](https://book.e-buy.com/link/124#bkmrk-e-buy-backend "A group /set of equipment / server to process all the transaction from e-Buy POS") server after collection to further process.

#### **action**

- `ecouponInquiry`

**Request body，Cashier POS===&gt;[e-Buy Backend](https://book.e-buy.com/link/124#bkmrk-e-buy-backend "A group /set of equipment / server to process all the transaction from e-Buy POS")**

<table id="bkmrk-field-type-mandatory"><thead><tr><th>Field</th><th>Type</th><th>Mandatory</th><th>Description</th><th>Memo</th></tr></thead><tbody><tr><td>traceNo</td><td>String</td><td>Yes</td><td>Cashier terminal trace no.</td><td>No repeat</td></tr><tr><td>qrcode</td><td>String</td><td>Yes</td><td>ecoupon code</td><td>ecoupon code for inquiry</td></tr></tbody></table>

#### **Request body example**

```
{
    "traceNo": "99000009100010101732123",
    "qrcode": "HDCP00000000001235"
}

```

**Response body，[e-Buy Backend](https://book.e-buy.com/link/124#bkmrk-e-buy-backend "A group /set of equipment / server to process all the transaction from e-Buy POS")===&gt;Cashier POS**

<table id="bkmrk-field-type-mandatory-0"><thead><tr><th>Field</th><th>Type</th><th>Mandatory</th><th>Description</th><th>Memo</th></tr></thead><tbody><tr><td>traceNo</td><td>String</td><td>Yes</td><td>Cashier terminal trace no.</td><td>No repeat</td></tr><tr><td>orderNo</td><td>String</td><td>Yes</td><td>Order No. from e-Buy</td><td>Unit : dollar</td></tr><tr><td>transDate</td><td>String</td><td>Yes</td><td>Transaction time</td><td>Format：yyyyMMddHHmmss</td></tr><tr><td>returnCode</td><td>String</td><td>Yes</td><td>Return code</td><td>00 represent successful transaction, else represent fail</td></tr><tr><td>returnDesc</td><td>String</td><td>Yes</td><td>Return message</td><td>Detail explanation / error message per transaction result</td></tr><tr><td>canPayAmount</td><td>Price</td><td>Yes</td><td>Balance of this coupon</td><td>Unit : dollar</td></tr><tr><td>activityProductNo</td><td>String</td><td>No</td><td>Activity Product no.</td><td>The activity Product no. this coupon belongs to</td></tr><tr><td>activityProductName</td><td>String</td><td>No</td><td>Activity Product name</td><td>The activity Product name this coupon belongs to</td></tr></tbody></table>

#### **Response body example**

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

# Point Accumulating

#### **Usage**

- Points accumulating

#### **action**

- `accumulating`

**Request body，Cashier POS===&gt;[e-Buy Backend](https://book.e-buy.com/link/124#bkmrk-e-buy-backend "A group /set of equipment / server to process all the transaction from e-Buy POS")**

<table id="bkmrk-field-type-mandatory"><thead><tr><th style="width: 145px;">Field</th><th style="width: 169px;">Type</th><th style="width: 91px;">Mandatory</th><th style="width: 184px;">Description</th><th style="width: 220px;">Memo</th></tr></thead><tbody><tr><td style="width: 145px;">traceNo</td><td style="width: 169px;">String</td><td style="width: 91px;">Yes</td><td style="width: 184px;">Cashier terminal trace no.</td><td style="width: 220px;">No repeat</td></tr><tr><td style="width: 145px;">totalAmount</td><td style="width: 169px;">Price</td><td style="width: 91px;">Yes</td><td style="width: 184px;">Total transaction amount</td><td style="width: 220px;">Unit : Dollar</td></tr><tr><td style="width: 145px;">undiscountAmount</td><td style="width: 169px;">Price</td><td style="width: 91px;">No</td><td style="width: 184px;">Undiscountable Amount</td><td style="width: 220px;">Unit : Dollar</td></tr><tr><td style="width: 145px;">activityNo</td><td style="width: 169px;">String</td><td style="width: 91px;">No</td><td style="width: 184px;">Activity NO</td><td style="width: 220px;">收银机集点时填写,后台集点不填</td></tr><tr><td style="width: 145px;">points</td><td style="width: 169px;">Integer</td><td style="width: 91px;">No</td><td style="width: 184px;">Points</td><td style="width: 220px;">收银机集点时填写,后台集点不填</td></tr><tr><td style="width: 145px;">goodsDetail</td><td style="width: 169px;">List&lt;[goodsDetail](https://book.e-buy.com/link/333#bkmrk-goods-detail "goodsDetail")&gt;</td><td style="width: 91px;">No</td><td style="width: 184px;">Goods detail</td><td style="width: 220px;">Mandated on goods detail verification</td></tr><tr><td style="width: 145px;">memberDetail</td><td style="width: 169px;">Object&lt;[memberDetail](https://book.e-buy.com/link/333#bkmrk-member-detail "memberDetail")&gt;</td><td style="width: 91px;">No</td><td style="width: 184px;">Member information</td><td style="width: 220px;">Mandated for member payment</td></tr></tbody></table>

#### **Request body example**

```
{
    "traceNo": "99000009100010101732123",
    "totalAmount": 40.8,
    "undiscountAmount": 0,
    "activityNo": "2016121901",
    "points": 100,
    "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
    }
}

```

**Response body，[e-Buy Backend](https://book.e-buy.com/link/124#bkmrk-e-buy-backend "A group /set of equipment / server to process all the transaction from e-Buy POS")===&gt;Cashier POS**

<table id="bkmrk-field-type-mandatory-0"><thead><tr><th style="width: 151px;">Field</th><th style="width: 149px;">Type</th><th style="width: 57px;">Mandatory</th><th style="width: 158px;">Description</th><th style="width: 294px;">Memo</th></tr></thead><tbody><tr><td style="width: 151px;">traceNo</td><td style="width: 149px;">String</td><td style="width: 57px;">Yes</td><td style="width: 158px;">Cashier terminal trace no.</td><td style="width: 294px;">No repeat</td></tr><tr><td style="width: 151px;">orderNo</td><td style="width: 149px;">String</td><td style="width: 57px;">Yes</td><td style="width: 158px;">Order No. from e-Buy</td><td style="width: 294px;">易百生成</td></tr><tr><td style="width: 151px;">transDate</td><td style="width: 149px;">String</td><td style="width: 57px;">Yes</td><td style="width: 158px;">Transaction time</td><td style="width: 294px;">Format：yyyyMMddHHmmss</td></tr><tr><td style="width: 151px;">returnCode</td><td style="width: 149px;">String</td><td style="width: 57px;">Yes</td><td style="width: 158px;">Return code</td><td style="width: 294px;">00 represent successful transaction, else represent fail</td></tr><tr><td style="width: 151px;">returnDesc</td><td style="width: 149px;">String</td><td style="width: 57px;">Yes</td><td style="width: 158px;">Return message</td><td style="width: 294px;">Detail explanation / error message per transaction result</td></tr><tr><td style="width: 151px;">activityProductNo</td><td style="width: 149px;">String</td><td style="width: 57px;">No</td><td style="width: 158px;">Activity Product no.</td><td style="width: 294px;"> </td></tr><tr><td style="width: 151px;">activityProductName</td><td style="width: 149px;">String</td><td style="width: 57px;">No</td><td style="width: 158px;">Activity Product name</td><td style="width: 294px;"> </td></tr><tr><td style="width: 151px;">printDetail</td><td style="width: 149px;">Object&lt;[printDetail](https://book.e-buy.com/link/333#bkmrk-print-detail "printDetail")&gt;</td><td style="width: 57px;">No</td><td style="width: 158px;">Printing message</td><td style="width: 294px;">Provided if required to print on the receipt</td></tr><tr><td style="width: 151px;">memberDetail</td><td style="width: 149px;">Object&lt;[memberDetail](https://book.e-buy.com/link/333#bkmrk-member-detail "memberDetail")&gt;</td><td style="width: 57px;">No</td><td style="width: 158px;">Member information</td><td style="width: 294px;">Member info return message on this transaction</td></tr></tbody></table>

#### **Response body example**

```
{
    "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.xxx.com/url",
        "qrCode2": "",
        "qrCode3": "",
        "barCode1": "12345679",
        "barCode2": "",
        "barCode3": ""
    },
    "memberDetail": {
        "memberId": "M000001545",
        "memberName": "TONY",
        "grade": "1",
        "status": "1",
        "balance": 1000.00,
        "pointBalance": 30000
    }
}
```