# 隔日退款（实体卡）

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

- 用户需要退款时，可以调用此接口，支持全额或部分退款（依赖支付机构的接口）。

#### **交易流程说明**

- 该交易发至中间件后，中间件不会直接请求易百后台，而是先点亮[MIS-POS](https://book.e-buy.com/link/391#bkmrk-mis-pos "安装于商户门店内的POS机具，提供活动执行辅助及兑换功能")，等待刷卡和输入密码，[MIS-POS](https://book.e-buy.com/link/391#bkmrk-mis-pos "安装于商户门店内的POS机具，提供活动执行辅助及兑换功能")上确认后，中间件收到卡和密码信息再请求易百后台进行处理。

#### **action**

- `refundCardSale`

#### **请求参数，收银机===>中间件**

<table id="bkmrk-%E5%AD%97%E6%AE%B5-%E7%B1%BB%E5%9E%8B-%E6%98%AF%E5%90%A6%E5%BF%85%E5%A1%AB-%E5%AD%97%E6%AE%B5%E6%84%8F%E4%B9%89-%E5%A4%87%E6%B3%A8-t"><thead><tr><th>字段</th><th>类型</th><th>是否必填</th><th>字段意义</th><th>备注</th></tr></thead><tbody><tr><td>traceNo</td><td>String</td><td>是</td><td>收银机流水号</td><td>不允许重复</td></tr><tr><td>originalTraceNo</td><td>String</td><td>是</td><td>原收银机流水号</td><td>传入需要退款的原交易收银机流水号</td></tr><tr><td>refundAmount</td><td>Price</td><td>是</td><td>本次退款金额</td><td>单位：元</td></tr><tr><td>acquirer</td><td>String</td><td>否</td><td>收单机构</td><td>如：citicCashpay表示中信收单，如果收单撤销是必填的</td></tr></tbody></table>

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

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

```

#### **返回参数，中间件===&gt;收银机**

<table id="bkmrk-%E5%AD%97%E6%AE%B5-%E7%B1%BB%E5%9E%8B-%E6%98%AF%E5%90%A6%E5%BF%85%E5%A1%AB-%E5%AD%97%E6%AE%B5%E6%84%8F%E4%B9%89-%E5%A4%87%E6%B3%A8-t-0" style="height: 398px;"><thead><tr style="height: 29px;"><th style="width: 138px; height: 29px;">字段</th><th style="width: 169px; height: 29px;">类型</th><th style="width: 83px; height: 29px;">是否必填</th><th style="width: 146px; height: 29px;">字段意义</th><th style="width: 273px; height: 29px;">备注</th></tr></thead><tbody><tr style="height: 29px;"><td style="width: 138px; height: 29px;">traceNo</td><td style="width: 169px; height: 29px;">String</td><td style="width: 83px; height: 29px;">是</td><td style="width: 146px; height: 29px;">收银机流水号</td><td style="width: 273px; height: 29px;">不允许重复</td></tr><tr style="height: 29px;"><td style="width: 138px; height: 29px;">orderNo</td><td style="width: 169px; height: 29px;">String</td><td style="width: 83px; height: 29px;">是</td><td style="width: 146px; height: 29px;">交易订单号</td><td style="width: 273px; height: 29px;"> </td></tr><tr style="height: 29px;"><td style="width: 138px; height: 29px;">transDate</td><td style="width: 169px; height: 29px;">String</td><td style="width: 83px; height: 29px;">是</td><td style="width: 146px; height: 29px;">交易时间</td><td style="width: 273px; height: 29px;">格式为：YYYYmmddHHMMSS</td></tr><tr style="height: 29px;"><td style="width: 138px; height: 29px;">returnCode</td><td style="width: 169px; height: 29px;">String</td><td style="width: 83px; height: 29px;">是</td><td style="width: 146px; height: 29px;">返回码</td><td style="width: 273px; height: 29px;">00表示交易成功，其他表示失败</td></tr><tr style="height: 29px;"><td style="width: 138px; height: 29px;">returnDesc</td><td style="width: 169px; height: 29px;">String</td><td style="width: 83px; height: 29px;">是</td><td style="width: 146px; height: 29px;">返回信息</td><td style="width: 273px; height: 29px;">交易结果描述或错误原因</td></tr><tr style="height: 45px;"><td style="width: 138px; height: 45px;">discountCode</td><td style="width: 169px; height: 45px;">String</td><td style="width: 83px; height: 45px;">否</td><td style="width: 146px; height: 45px;">折扣编码</td><td style="width: 273px; height: 45px;">由收银机分配，用于入账计折扣类型，如：2016120102|10.00表示折扣10元</td></tr><tr style="height: 45px;"><td style="width: 138px; height: 45px;">tenderCode</td><td style="width: 169px; height: 45px;">String</td><td style="width: 83px; height: 45px;">否</td><td style="width: 146px; height: 45px;">支付方式编码</td><td style="width: 273px; height: 45px;">由收银机分配，用于入账计支付方式，如：2016120101|20.00表示支付20元</td></tr><tr style="height: 29px;"><td style="width: 138px; height: 29px;">refundAmount</td><td style="width: 169px; height: 29px;">Price</td><td style="width: 83px; height: 29px;">是</td><td style="width: 146px; height: 29px;">退款成功总金额</td><td style="width: 273px; height: 29px;">单位：元</td></tr><tr style="height: 35px;"><td style="width: 138px; height: 35px;">fundChannel</td><td style="width: 169px; height: 35px;">List&lt;[fundChannel](https://book.e-buy.com/books/ebuy-cashier-middleware-api/page/e00da "fundChannel")&gt;</td><td style="width: 83px; height: 35px;">否</td><td style="width: 146px; height: 35px;">资金渠道</td><td style="width: 273px; height: 35px;"> </td></tr><tr style="height: 35px;"><td style="width: 138px; height: 35px;">printDetail</td><td style="width: 169px; height: 35px;">Object&lt;[printDetail](https://book.e-buy.com/books/ebuy-cashier-middleware-api/page/310dc "printDetail")&gt;</td><td style="width: 83px; height: 35px;">否</td><td style="width: 146px; height: 35px;">打印信息</td><td style="width: 273px; height: 35px;">如需要在收银小票上打印信息时必填</td></tr><tr style="height: 35px;"><td style="width: 138px; height: 35px;">memberDetail</td><td style="width: 169px; height: 35px;">Object&lt;[memberDetail](https://book.e-buy.com/books/ebuy-cashier-middleware-api/page/559cb "memberDetail")&gt;</td><td style="width: 83px; height: 35px;">否</td><td style="width: 146px; height: 35px;">会员信息</td><td style="width: 273px; height: 35px;">返回本次交易的会员信息</td></tr></tbody></table>

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

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

```

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

- cardPayment
- CardRedemption