Skip to main content

当日撤销

接口用途

  • 需要对原交易整体撤销时,可以在原交易的同一天调用此接口。

接口地址

  • https://ebuywebposp-test.e-buychina.com/ebuyweb-posp/api/void

action

  • void

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

字段 类型 是否必填 字段意义 备注
traceNo String 收银机流水号 不允许重复,必须以yyyyMMdd(当天)作为流水号开头+递增序列
onlineTid String 线上对接使用的统一终端号 对接前需提前和易百技术沟通
originalTraceNo String 原收银机流水号 传入需要撤销的原交易收银机流水号
isRollback Boolean 标识本次请求是否为冲正交易(中间件发起) 冲正发起需要另起线程并且先返回收银机交易失败结果,再异步冲正
acquirer String 收单机构 如:citicCashpay表示中信收单,如果收单撤销是必填的
cardInfo Object<cardInfo> 卡信息 卡支付类交易需要填入原交易卡信息

请求报文举例

{
  "traceNo": "9900000910001013220150201",
  "originalTraceNo": "9900000910001013120150201",
  "isRollback": false,
  "acquirer": "citicCashpay",
  "cardInfo": {
    "cardNo": "",
    "password": "",
    "valid": "",
    "track1": "",
    "track2": "",
    "track3": "",
    "cardSn": "",
    "icData": ""
  }
}

返回参数,易百后台===>中间件

字段 类型 是否必填 字段意义 备注
traceNo String 收银机流水号 不允许重复,必须以yyyyMMdd(当天)作为流水号开头+递增序列
orderNo String 交易订单号
transDate String 交易时间 格式为:yyyyMMddHHmmss
returnCode String 返回码 00表示交易成功,其他表示失败
returnDesc String 返回信息 交易结果描述或错误原因
fundChannel List<fundChannel> 资金渠道
printDetail Object<printDetail> 打印信息 如需要在收银小票上打印信息时必填
memberDetail Object<memberDetail> 会员信息 返回本次交易的会员信息
voucherDetail List<voucherDetail> 优惠券信息 返回本次交易的优惠券信息
cashOrderNo String 收单原流水号 收单撤销时返回
cashBank String 收单机构标识 收单撤销时返回
purchaseOrder List<purchaseOrder> 收单签购单信息 签购单信息

返回报文举例

{
  "traceNo": "9900000910001013420150201",
  "orderNo": "171698602301",
  "cashOrderNo": "000025",
  "cashBank": "40",
  "transDate": "20161231120533",
  "returnCode": "00",
  "returnDesc": "SUCCESS",
  "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