Skip to main content

卡余额或权益查询

接口用途

  • 银行卡积分余额查询
  • 银行卡余额查询
  • 银行卡权益次数查询
  • 预付费卡余额查询
  • 会员卡积分或余额查询

接口地址

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

action

  • balance

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

字段类型是否必填字段意义备注
traceNoString是收银机流水号不允许重复,必须以yyyyMMdd(当天)作为流水号开头+递增序列
activityProductNoString否活动产品编号二次交互时填写
cardInfoObject<cardInfo>是卡信息 
memberDetailObject<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
    }
}

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

字段类型是否必填字段意义备注
traceNoString是收银机流水号不允许重复,必须以yyyyMMdd(当天)作为流水号开头+递增序列
orderNoString是交易订单号单位：元
transDateString是交易时间格式为：yyyyMMddHHmmss
returnCodeString是返回码00表示交易成功，其他表示失败
returnDescString是返回信息交易结果描述或错误原因
rightsTimesInteger是权益次数返回可以享受的权益次数
moneyBalancePrice是现金余额单位：元
pointBalancePrice是积分余额单位：分
printDetailObject<printDetail>否打印信息如需要在收银小票上打印信息时必填
memberDetailObject<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
    }
}
Back to top