Skip to main content

交易结果查询

接口用途

  • 在中间件未收到后台返回时,可以调用此接口查询原交易的状态。
  • “电子凭证批量核销ecouponsVerify”交易目前不支持查询

接口地址

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

action

  • inquiry

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

字段 类型 是否必填 字段意义 备注
traceNo String 收银机流水号 不允许重复,必须以yyyyMMdd(当天)作为流水号开头+递增序列
onlineTid String 线上对接使用的统一终端号 对接前需提前和易百技术沟通
originalTraceNo String 原收银机流水号 传入需要查询的原交易收银机流水号
originalDate String 原交易日期 传入需要查询的原交易日期,不传默认为当天格式为yyyyMMdd

请求报文举例

{
  "traceNo": "9900000910001014320150201",
  "originalTraceNo": "9900000910001014220150201",
  "originalDate": "20170912"
}

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

字段 类型 是否必填 字段意义 备注
traceNo String 收银机流水号 不允许重复,必须以yyyyMMdd(当天)作为流水号开头+递增序列
orderNo String 交易订单号 单位:元
transDate String 交易时间 格式为:yyyyMMddHHmmss
returnCode String 返回码 00表示交易成功,其他表示失败
returnDesc String 返回信息 交易结果描述或错误原因
paidAmount Price 支付成功总金额 单位:元
receiptAmount Price 商户实收金额 单位:元
invoiceAmount Price 商户开票金额 单位:元
exchangeRate Number(8,6) 汇率 1外币等于多少人民币
currency String 货币类型 例如:CNY
discountCode String 折扣编码 由收银机分配,用于入账计折扣类型
discountNum Number 固定金额折扣数量 用于入账计折扣类型的数量
tenderCode String 支付方式编码 由收银机分配,用于入账计支付方式
activityProductNo String 活动产品编号
activityProductName String 活动产品名称
needSameCard Boolean 同一张卡支付 如满额立减类活动,需要同一张银行卡支付剩余金额
goodsDetail List<goodsDetail> 折抵产品明细 返回后台已抵扣成功的产品明细
fundChannel List<fundChannel> 资金渠道
printDetail Object<printDetail> 打印信息 如需要在收银小票上打印信息时必填
memberDetail Object<memberDetail> 会员信息 返回本次交易的会员信息
voucherDetail List<voucherDetail> 优惠券信息 返回本次交易的优惠券信息
extendsData Object<extendsData> 扩展信息 与ebuy约定
transType String 标识当笔交易类型 下发alipayQrpay  表示  支付宝二维码支付业务

返回报文举例

{
  "traceNo": "9900000910001014420150201",
  "orderNo": "171698602301",
  "transDate": "20161231120533",
  "returnCode": "00",
  "returnDesc": "SUCCESS",
  "paidAmount": 40.8,
  "receiptAmount": 40.8,
  "invoiceAmount": 40.8,
  "exchangeRate": 6.0939,
  "currency": "CNY",
  "discountCode": "0001",
  "discountNum": 20,
  "tenderCode": "8001",
  "activityProductNo": "2016123102",
  "activityProductName": "支付宝支付",
  "transType": "alipayQrpay",
  "needSameCard": true,
  "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",
    "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