# 隔日退款

### **接口用途**

- 用户需要退款时，可以调用此接口，支持全额或部分退款（依赖支付机构的接口）。
- 不支持券核销类交易的退款，建议调用“当日撤销void”来支持

### **接口地址**

- `https://ebuywebposp-test.e-buychina.com/ebuyweb-posp/api/refund`

### **action**

- `refund`

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

<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 style="width: 119px;">字段</th><th style="width: 132px;">类型</th><th style="width: 54px;">是否必填</th><th style="width: 112px;">字段意义</th><th style="width: 392px;">备注</th></tr></thead><tbody><tr><td style="width: 119px;">traceNo</td><td style="width: 132px;">String</td><td style="width: 54px;">是</td><td style="width: 112px;">收银机流水号</td><td style="width: 392px;">不允许重复,必须以yyyyMMdd(当天)作为流水号开头+递增序列</td></tr><tr><td>onlineTid</td><td>String</td><td>否</td><td>线上对接使用的统一终端号</td><td>对接前需提前和易百技术沟通</td></tr><tr><td style="width: 119px;">originalTraceNo</td><td style="width: 132px;">String</td><td style="width: 54px;">是</td><td style="width: 112px;">原收银机流水号</td><td style="width: 392px;">传入需要退款的原交易收银机流水号</td></tr><tr><td style="width: 119px;">originalDate</td><td style="width: 132px;">String</td><td style="width: 54px;">否</td><td style="width: 112px;">原交易日期</td><td style="width: 392px;">传入需要退款的原交易日期，不传默认为当天格式为yyyyMMdd</td></tr><tr><td style="width: 119px;">refundAmount</td><td style="width: 132px;">Price</td><td style="width: 54px;">是</td><td style="width: 112px;">本次退款金额</td><td style="width: 392px;">单位：元</td></tr><tr><td style="width: 119px;">acquirer</td><td style="width: 132px;">String</td><td style="width: 54px;">否</td><td style="width: 112px;">收单机构</td><td style="width: 392px;">如：citicCashpay表示中信收单，如果收单撤销是必填的</td></tr><tr><td style="width: 119px;">cardInfo</td><td style="width: 132px;">Object&lt;[cardInfo](https://book.e-buy.com/books/e-buy-B6z/page/6cdd6 "cardInfo")&gt;</td><td style="width: 54px;">否</td><td style="width: 112px;">卡信息</td><td style="width: 392px;">卡支付类交易需要填入原交易卡信息</td></tr></tbody></table>

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

```JSON
{
  "traceNo": "9900000910001013920150201",
  "originalTraceNo": "9900000910001013820150201",
  "originalDate": "20170912",
  "refundAmount": 40.8,
  "acquirer": "citicCashpay",
  "cardInfo": {
    "cardNo": "",
    "password": "",
    "valid": "",
    "track1": "",
    "track2": "",
    "track3": "",
    "cardSn": "",
    "icData": ""
  }
}
```

**返回参数，易百后台===&gt;中间件**

<table id="bkmrk-%E5%AD%97%E6%AE%B5-%E7%B1%BB%E5%9E%8B-%E6%98%AF%E5%90%A6%E5%BF%85%E5%A1%AB-%E5%AD%97%E6%AE%B5%E6%84%8F%E4%B9%89-%E5%A4%87%E6%B3%A8-t-0"><thead><tr><th style="width: 115px;">字段</th><th style="width: 172px;">类型</th><th style="width: 50px;">是否必填</th><th style="width: 142px;">字段意义</th><th style="width: 330px;">备注</th></tr></thead><tbody><tr><td style="width: 115px;">traceNo</td><td style="width: 172px;">String</td><td style="width: 50px;">是</td><td style="width: 142px;">收银机流水号</td><td style="width: 330px;">不允许重复,必须以yyyyMMdd(当天)作为流水号开头+递增序列</td></tr><tr><td style="width: 115px;">orderNo</td><td style="width: 172px;">String</td><td style="width: 50px;">是</td><td style="width: 142px;">交易订单号</td><td style="width: 330px;">  
</td></tr><tr><td style="width: 115px;">transDate</td><td style="width: 172px;">String</td><td style="width: 50px;">是</td><td style="width: 142px;">交易时间</td><td style="width: 330px;">格式为：yyyyMMddHHmmss</td></tr><tr><td style="width: 115px;">returnCode</td><td style="width: 172px;">String</td><td style="width: 50px;">是</td><td style="width: 142px;">返回码</td><td style="width: 330px;">00表示交易成功，其他表示失败</td></tr><tr><td style="width: 115px;">returnDesc</td><td style="width: 172px;">String</td><td style="width: 50px;">是</td><td style="width: 142px;">返回信息</td><td style="width: 330px;">交易结果描述或错误原因</td></tr><tr><td style="width: 115px;">refundAmount</td><td style="width: 172px;">Price</td><td style="width: 50px;">是</td><td style="width: 142px;">退款成功总金额</td><td style="width: 330px;">单位：元</td></tr><tr><td style="width: 115px;">fundChannel</td><td style="width: 172px;">List&lt;[fundChannel](https://book.e-buy.com/books/e-buy-B6z/page/14bfa "fundChannel")&gt;</td><td style="width: 50px;">否</td><td style="width: 142px;">资金渠道</td><td style="width: 330px;">  
</td></tr><tr><td style="width: 115px;">printDetail</td><td style="width: 172px;">Object&lt;[printDetail](https://book.e-buy.com/books/e-buy-B6z/page/eed5a "printDetail")&gt;</td><td style="width: 50px;">否</td><td style="width: 142px;">打印信息</td><td style="width: 330px;">如需要在收银小票上打印信息时必填</td></tr><tr><td style="width: 115px;">memberDetail</td><td style="width: 172px;">Object&lt;[memberDetail](https://book.e-buy.com/books/e-buy-B6z/page/9fc3d "memberDetail")&gt;</td><td style="width: 50px;">否</td><td style="width: 142px;">会员信息</td><td style="width: 330px;">返回本次交易的会员信息</td></tr><tr><td style="width: 115px;">voucherDetail</td><td style="width: 172px;">List&lt;[voucherDetail](https://book.e-buy.com/books/e-buy-B6z/page/8f855 "voucherDetail")&gt;</td><td style="width: 50px;">否</td><td style="width: 142px;">优惠券信息</td><td style="width: 330px;">返回本次交易的优惠券信息</td></tr><tr><td style="width: 115px;">cashOrderNo</td><td style="width: 172px;">String</td><td style="width: 50px;">否</td><td style="width: 142px;">收单原交易订单号</td><td style="width: 330px;">收单退款时返回</td></tr><tr><td style="width: 115px;">cashBank</td><td style="width: 172px;">String</td><td style="width: 50px;">否</td><td style="width: 142px;">收单机构标识</td><td style="width: 330px;">收单退款时返回</td></tr><tr><td style="width: 115px;">purchaseOrder</td><td style="width: 172px;">List&lt;[purchaseOrder](https://book.e-buy.com/books/e-buy-B6z/page/218a0)&gt;</td><td style="width: 50px;">否</td><td style="width: 142px;">收单签购单信息</td><td style="width: 330px;">[签购单信息](https://book.e-buy.com/books/e-buy-B6z/page/218a0)</td></tr></tbody></table>

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

```JSON
{
  "traceNo": "9900000910001014020150201",
  "orderNo": "171698602301",
  "cashOrderNo": "000025",
  "cashBank": "40",
  "transDate": "20161231120533",
  "returnCode": "00",
  "returnDesc": "SUCCESS",
  "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,
    "pointBalance": 30000
  },
  "voucherDetail": [
    {
      "voucherId": "001",
      "voucherName": "现金优惠券",
      "voucherType": "现金",
      "voucherCode": "123456789",
      "channelAmount": "20.8"
    },
    {
      "voucherId": "002",
      "voucherName": "买一赠一优惠券",
      "voucherType": "买赠",
      "voucherCode": "1232136781",
      "channelAmount": "20.8"
    }
  ]
}
```

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

- cardPayment
- cardRedemption
- qrcodeSale