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
    }
}