当日撤销
接口用途
- 需要对原交易整体撤销时,可以在原交易的同一天调用此接口。
接口地址
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
No Comments