Skip to main content

券码预核销

基本信息

券码预核销，前置校验相关核销逻辑，不会改变券码状态。

请求参数

Headers

参数名称 参数值 是否必填
Content-Type application/json 是



Body

参数名称 类型 必填 默认值 备注 其他信息
traceNo String 是 收银机流水号 不允许重复，必须以yyyyMMdd(当天)作为流水号开头+递增序列  
onlineTid String 否 线上对接使用的统一终端号 对接前需提前和易百技术沟通  
totalAmount Price 是 交易总金额 单位：元  
undiscountAmount Price 是 不可打折金额 单位：元，没有填写0  
verifyType String 是 核销类型 请与易百技术确认，枚举值：online为线上场景，offline为线下POS场景  
activityProductNo String 否 活动产品编号 二次交互时填写  
scene String 否 支付场景 条码:bar_code, 二维码:qr_code  
orderSubject String 否 订单标题 最长256  
orderDescription String 否 订单描述 最长256  
qrcode String 是 二维码内容 串号、一维码或二维码内容  
goodsDetail List<goodsDetail> 否 产品明细 验证产品明细时必填  

    |__goodsCategory
String
是
商品类别
 

    |__goodsId
String
是
商品编号
 

    |__goodsName
String
是
商品名称
用于报表、小票等显示

    |__goodsSpec
String
否
商品规格
用于报表、小票等显示

    |__price
Price
是
单价
单位：元

    |__quantity
Integer
是
数量
 

    |__rebateCode		String否折扣代码收银机上已设置折扣，则必填,长度大于3位小于32位

    |__activityNo		String否活动编号易百后台交易成功，会返回本交易所属的活动编号
    |__memoString否备注易百后台交易成功，会返回部分信息，如电子凭证号码
    |__voucherIdString否优惠券ID当有优惠券信息时返回
memberDetail Object<memberDetail> 否 会员信息 会员支付时必填  
    |__memberId  String  是  会员编号    
    |__memberCode  String  是  会员卡号    
    |__memberName  String  是  会员名称    
    |__memberPhone  String  否  会员手机号码    
    |__grade  String  否  会员等级    
    |__status  String  否  会员状态    
    |__balance  Price  否  会员卡余额    
    |__pointBalance  Price  否    
      
      
      
      
      
      
      
      
      
      
      
      
      
      
      
      
      
      
      
      
      
      
      
      
      
      
    会员积分余额

 

请求示例

{
  "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,
    "pointBalance": 30000
  }
}

响应

响应参数

参数名称 类型 必填 默认值 备注 其他信息
code string 是
响应码
message string 否
响应消息

响应示例

{"code":"EB_SUCCESS","message":"操作成功"}

注意：

响应码不为EB_SUCCESS 或 EB_FAIL 易百将会进行重试，请保证接口幂等性。

  • {"code":"EB_SUCCESS","message":"操作成功"}  // 业务处理成功，不重试
  • {"code":"EB_FAIL","message":"操作失败"}  // 业务处理失败，不重试
  • 其他未知失败   // 重试

Back to top