Skip to main content

银行卡收单

  • 接口用途

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

    接口地址

    • 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"
        }
    ]
}
No Comments
Back to top
Entity Select