Skip to main content

Card Redemption

Usage

  • Bank loyalty point redemption
  • Bank Loyalty point redemption + Cash payment
  • Bank privilege verification
  • Bank privilege verification + Cash Payment
  • Prepay Card payment
  • Member Card payment

Transaction Flow

  • The requested transaction will 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

  • cardRedemption

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

Field Type Mandatory Description Memo
traceNo String Yes Cashier terminal trace no. No repeat，建议yyyyMMddHHmmss+10位流水号
totalAmount Price Yes Total transaction amount Unit : Dollar
undiscountAmount Price Yes undiscountable Amount Unit : Dollar
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,
    "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
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