卡余额或权益查询

接口用途 

 银行卡积分余额查询 

 银行卡余额查询 

 银行卡权益次数查询 

 预付费卡余额查询 

 会员卡积分或余额查询 

 接口地址 

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

 action 

 balance 

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

 字段 

 类型 

 是否必填 

 字段意义 

 备注 

 traceNo 

 String 

 是 

 收银机流水号 

 不允许重复,必须以yyyyMMdd(当天)作为流水号开头+递增序列 

 onlineTid 

 String 

 否 

 线上对接使用的统一终端号 

 对接前需提前和易百技术沟通 

 activityProductNo 

 String 

 否 

 活动产品编号 

 二次交互时填写 

 cardInfo 

 Object< cardInfo > 

 是 

 卡信息 

   

 memberDetail 

 Object< memberDetail > 

 否 

 会员信息 

 会员交易时必填 

 请求报文举例 

 {

 "traceNo": "99000009100010101732123",

 "activityProductNo": "HDCP00000000001236",

 "cardInfo": {

 "cardNo": "",

 "password": "",

 "valid": "",

 "track1": "",

 "track2": "",

 "track3": "",

 "cardSn": "",

 "icData": ""

 },

 "memberDetail": {

 "memberId": "M000001545",

 "memberName": "TONY",

 "grade": "1",

 "status": "1",

 "balance": 1000.00,

 "pointBalance": 30000

 }

}

 

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

 字段 

 类型 

 是否必填 

 字段意义 

 备注 

 traceNo 

 String 

 是 

 收银机流水号 

 不允许重复,必须以yyyyMMdd(当天)作为流水号开头+递增序列 

 orderNo 

 String 

 是 

 交易订单号 

 单位：元 

 transDate 

 String 

 是 

 交易时间 

 格式为：yyyyMMddHHmmss 

 returnCode 

 String 

 是 

 返回码 

 00表示交易成功，其他表示失败 

 returnDesc 

 String 

 是 

 返回信息 

 交易结果描述或错误原因 

 rightsTimes 

 Integer 

 是 

 权益次数 

 返回可以享受的权益次数 

 moneyBalance 

 Price 

 是 

 现金余额 

 单位：元 

 pointBalance 

 Price 

 是 

 积分余额 

 单位：分 

 printDetail 

 Object< printDetail > 

 否 

 打印信息 

 如需要在收银小票上打印信息时必填 

 memberDetail 

 Object< memberDetail > 

 否 

 会员信息 

 返回本次交易的会员信息 

 返回报文举例 

 {

 "traceNo": "99000009100010101732123",

 "orderNo": "171698602301",

 "transDate": "20161231120533",

 "returnCode": "00",

 "returnDesc": "SUCCESS",

 "rightsTimes": 1,

 "moneyBalance": 40.8,

 "pointBalance": 40000,

 "printDetail": {

 "cardNo64": "622562****8888",

 "bank": "中信银行",

 "paymentOrderNo": "201612315689412157458787",

 "pointSale": "0",

 "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

 }

}