Skip to main content

电子凭证预核销

接口用途

  • 预核销电子凭证，模拟电子凭证核销交易提前获取核销结果信息；

接口地址

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

action

  • ecouponPreVerify

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

字段类型是否必填字段意义备注
traceNoString是收银机流水号不允许重复，必须以yyyyMMdd(当天)作为流水号开头+递增序列
totalAmountPrice是交易总金额单位：元
undiscountAmountPrice是不可打折金额单位：元，没有填写0
activityProductNoString否活动产品编号二次交互时填写
sceneString否支付场景条码:bar_code, 二维码:qr_code
orderSubjectString否订单标题最长256
orderDescriptionString否订单描述最长256
qrcodeString是二维码内容串号、一维码或二维码内容
goodsDetailList<goodsDetail>否产品明细验证产品明细时必填
memberDetailObject<memberDetail>否会员信息会员支付时必填

请求报文举例

{
"traceNo": "9900000910001011320150201",
"totalAmount": 40.8,
"undiscountAmount": 0,
"activityProductNo": "HDCP00000000001234",
"qrcode": "280123121234567890",
"lockTime" : "300",
"afterLock" : "0",
"goodsDetail": [
{
"goodsCategory": "001",
"goodsId": "P00001",
"goodsName": "牙膏",
"price": 8,
"quantity": 2,
"rebateCode": "000"
},
{
"goodsCategory": "101",
"goodsId": "P00002",
"goodsName": "洗发水",
"price": 24.8,
"quantity": 1,
"rebateCode": "000"
}
],
"memberDetail": {
"memberId": "M000001545",
"memberName": "TONY",
"grade": "1",
"status": "1",
"balance": 1000.00,
"pointBalance": 30000
}
}

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

字段类型是否必填字段意义备注
traceNoString是收银机流水号不允许重复，必须以yyyyMMdd(当天)作为流水号开头+递增序列
orderNoString是交易订单号易百生成
transDateString是交易时间格式为：yyyyMMddHHmmss
returnCodeString是返回码00表示交易成功，其他表示失败
returnDescString是返回信息交易结果描述或错误原因
paidAmountPrice是支付成功总金额单位：元
receiptAmountPrice否商户实收金额单位：元
invoiceAmountPrice否商户开票金额单位：元
remainTimesNumber是券码当前可用次数如果有限制每天使用多少次，代表当天可使用次数｜
lockTimeString否锁定时间,单位（秒）默认：300
afterLockString否锁定和解锁，锁定：1，解锁：0默认：1，锁定返回校验参数
exchangeRateNumber(8,6)否汇率1外币等于多少人民币
currencyString否货币类型例如:CNY
discountCodeString否折扣编码由收银机分配，用于入账计折扣类型和折扣金额
discountNumNumber否固定金额折扣数量用于入账计折扣类型的数量
tenderCodeString否支付方式编码由收银机分配，用于入账计支付方式和入账金额
activityProductNoString否活动产品编号 
activityProductNameString否活动产品名称 
goodsDetailList<goodsDetail>否折抵产品明细返回后台已抵扣成功的产品明细
fundChannelList<fundChannel>否资金渠道 
printDetailObject<printDetail>否打印信息如需要在收银小票上打印信息时必填
memberDetailObject<memberDetail>否会员信息返回本次交易的会员信息
voucherDetailList<voucherDetail>否优惠券信息返回本次交易的优惠券信息
extendsDataObject<extendsData>否扩展信息与ebuy约定

返回报文举例

{
"traceNo": "9900000910001011520150201",
"orderNo": "171698602301",
"transDate": "20161231120533",
"returnCode": "00",
"returnDesc": "SUCCESS",
"paidAmount": 40.8,
"receiptAmount": 40.8,
"invoiceAmount": 40.8,
"lockTime" : "300",
"afterLock" : "0",
"exchangeRate": 6.0939,
"currency": "CNY",
"discountCode": "0001",
"discountNum": 20,
"tenderCode": "8001",
"activityProductNo": "2016123102",
"activityProductName": "支付宝支付",
"goodsDetail": [
{
"goodsCategory": "001",
"goodsId": "P00001",
"goodsName": "牙膏",
"price": 8,
"quantity": 2,
"rebateCode": "000",
"activityNo": "2016123101",
"memo": "100123456789"
},
{
"goodsCategory": "101",
"goodsId": "P00002",
"goodsName": "洗发水",
"price": 24.8,
"quantity": 1,
"rebateCode": "000",
"activityNo": "2016123101",
"memo": "100123456789"
}
],
"fundChannel": [
{
"channelNo": "001",
"channelName": "用户实付现金",
"channelAmount": "20.8"
},
{
"channelNo": "002",
"channelName": "用户积分支付",
"channelAmount": "20"
}
],
"printDetail": {
"cardNo64": "622562****8888",
"bank": "中国银行",
"paymentOrderNo": "201612315689412157458787",
"paymentUser": "139****@163.com",
"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
},
"voucherDetail": [
{
"voucherId": "001",
"voucherName": "现金优惠券",
"voucherType": "现金",
"voucherCode": "123456789",
"channelAmount": "20.8"
},
{
"voucherId": "002",
"voucherName": "买一赠一优惠券",
"voucherType": "买赠",
"voucherCode": "1232136781",
"channelAmount": "20.8"
}
]
}
Back to top