Skip to main content

Bank Acquiring

Transaction Flow

  • The requested transaction will firstly invoke MIS-POS for Card swape and password input. Once MIS-POS confirmed on both inputs, it will send back to e-Buy backend server to process.

action

  • cardPayment

Request body，Cashier POS===>e-Buy Backend

Field Type Mandatory Description Memo
traceNo String Yes Cashier terminal trace no. No repeat
totalAmount Price Yes Total transaction amount Unit : Dollar
undiscountAmount Price Yes undiscountable Amount Unit : Dollar
acquirer String Yes Acquirer Bank Example：citicCashpay
goodsDetail List<goodsDetail> Yes Goods detail Mandated on goods detail verification
memberDetail Object<memberDetail> No Member information Mandated on member payment

Request body example

{
    "traceNo": "99000009100010101732123",
    "totalAmount": 40.8,
    "undiscountAmount": 0,
    "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"
        }
    ],
    "memberDetail": {
        "memberId": "M000001545",
        "memberName": "TONY",
        "grade": "1",
        "status": "1",
        "balance": 1000.00,
        "pointBalance": 30000
    }
}

Response body，e-Buy Backend===>Cashier POS

Field Type Mandatory Description Memo
traceNo String Yes Cashier terminal trace no. No repeat
orderNo String Yes Order No. from e-Buy 易百生成
transDate String Yes Transaction time Format：yyyyMMddHHmmss
returnCode String Yes Return code 00 represent successful transaction, else represent fail
returnDesc String Yes Return message Detail explanation / error message per transaction result
paidAmount Price Yes Total amount paid Face Value. Unit : Dollar
receiptAmount Price No Merchant actual received amount Net Value. Unit : Dollar
invoiceAmount Price No Merchant invoice amount Unit : Dollar
exchangeRate Number(8,6) No Exchange Rate The rate of conversion the currency given in the request to CNY.
currency String No Currency For example: CNY
discountCode String No Discount Code assigned by Cashier POS,用于入账计折扣类型，如：2016120101|20.00表示支付20元
discountNum Number No numbers of discountCode 用于入账计折扣类型的数量
tenderCode String No Tender Code assigned by Cashier POS,用于入账计支付方式，如：2016120101|20.00表示支付20元
activityProductNo String No Activity Product no.  
activityProductName String No Activity Product name  
needSameCard Boolean No Required same card payment Such as discount upon amount reached, same credit card must be used for the payment
goodsDetail List<goodsDetail> No Paid product detail Backend response paid product detail
fundChannel List<fundChannel> No Channel of fund  
printDetail Object<printDetail> No Printing message Provided if required to print on the receipt
memberDetail Object<memberDetail> No Member information Member info return message on this transaction

Response body example

{
    "traceNo": "99000009100010101732123",
    "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": "2016123101",
    "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.xxx.com/url",
        "qrCode2": "",
        "qrCode3": "",
        "barCode1": "12345679",
        "barCode2": "",
        "barCode3": ""
    },
    "memberDetail": {
        "memberId": "M000001545",
        "memberName": "TONY",
        "grade": "1",
        "status": "1",
        "balance": 1000.00,
        "pointBalance": 30000
    }
}
No Comments
Back to top
Entity Select