# 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===>[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