银行卡收单

• 接口用途

  • 银行卡收单
  • 预付费卡消费

  接口地址

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

  action

  • cardPayment

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

  字段	类型	是否必填	字段意义	备注
  traceNo	String	是	收银机流水号	不允许重复，必须以yyyyMMdd(当天)作为流水号开头+递增序列
  onlineTid	String	否	线上对接使用的统一终端号	对接前需提前和易百技术沟通
  totalAmount	Price	是	交易总金额	单位：元
  undiscountAmount	Price	是	不可打折金额	单位：元
  activityProductNo	String	否	活动产品编号	二次交互时填写
  orderSubject	String	否	订单标题	最长256
  orderDescription	String	否	订单描述	最长256
  acquirer	String	是	收单机构	如：citicCashpay表示中信收单
  request8583	String	否	请求报文HEX	MIS-POS灌其他机构密钥，需要组包并填写该域
  goodsDetail	List<goodsDetail>	是	产品明细	验证产品明细时必填
  cardInfo	Object<cardInfo>	是	卡信息
  memberDetail	Object<memberDetail>	否	会员信息	会员支付时必填

  请求报文举例

  {
      "traceNo": "9900000910001011820150201",
      "totalAmount": 40.8,
      "undiscountAmount": 0,
      "activityProductNo": "HDCP00000000001234",
      "acquirer": "citicCashpay",
      "goodsDetail": [
          {
              "goodsCategory": "001",
              "goodsId": "P00001",
              "goodsName": "牙膏",
              "price": 8,
              "quantity": 2,
              "rebateCode": "000"
          },
          {
              "goodsCategory": "101",
              "goodsId": "P00002",
              "goodsName": "洗发水",
              "price": 24.8,
              "quantity": 1,
              "rebateCode": "000"
          }
      ],
      "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	是	返回信息	交易结果描述或错误原因
  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	否	同一张卡支付	如满额立减类活动，需要同一张银行卡支付剩余金额
  response8583	String	否	返回报文HEX	MIS-POS灌其他机构密钥，后台透传该域。（部分收单业务占用此字段下发pos指令）
  goodsDetail	List<goodsDetail>	否	折抵产品明细	返回后台已抵扣成功的产品明细
  fundChannel	List<fundChannel>	否	资金渠道
  printDetail	Object<printDetail>	否	打印信息	如需要在收银小票上打印信息时必填
  cardInfo	Object<cardInfo>	否	卡信息	如果是IC卡，需要返回IC卡数据信息，用于IC卡检验
  memberDetail	Object<memberDetail>	否	会员信息	返回本次交易的会员信息
  voucherDetail	List<voucherDetail>	否	优惠券信息	返回本次交易的优惠券信息
  cashBank	String	否	收单机构编号	收单机构编号，详情参考收单标识说明
  cashOrderNo	String	否	收单机构订单号	反交易时下发
  cashAmount	Price	否	收单实际金额	pos机请求收单机构时使用的金额
  purchaseOrder	List<purchaseOrder>	否	收单签购单内容	签购单信息

  返回报文举例

  {
      "traceNo": "9900000910001011920150201",
      "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": "00000000089349",
      "activityProductName": "中信365权益",
      "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": ""
      },
      "cardInfo": {
          "cardNo": "",
          "password": "",
          "valid": "",
          "track1": "",
          "track2": "",
          "track3": "",
          "cardSn": "",
          "icData": ""
      },
      "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"
          }
      ]
  }