# 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](https://book.e-buy.com/link/124#bkmrk-mis-pos "Installed in merchants in-store POS machine, providing the operation activity to support and exchange function") for Card swape and password input. Once [MIS-POS](https://book.e-buy.com/link/124#bkmrk-mis-pos "Installed in merchants in-store POS machine, providing the operation activity to support and exchange function") confirmed on both inputs, it will send back to [e-Buy backend](https://book.e-buy.com/link/124#bkmrk-e-buy-backend "A group /set of equipment / server to process all the transaction from e-Buy POS") server to process. #### **action** - `cardRedemption` **Request body，Cashier POS===>[e-Buy Backend](https://book.e-buy.com/link/124#bkmrk-e-buy-backend "A group /set of equipment / server to process all the transaction from e-Buy POS")**
FieldTypeMandatoryDescriptionMemo
traceNoStringYesCashier terminal trace no.No repeat，建议yyyyMMddHHmmss+10位流水号
totalAmountPriceYesTotal transaction amountUnit : Dollar
undiscountAmountPriceYesundiscountable AmountUnit : Dollar
goodsDetailList<[goodsDetail](https://book.e-buy.com/link/333#bkmrk-goods-detail "goodsDetail")>YesGoods detailMandated on goods detail verification
memberDetailObject<[memberDetail](https://book.e-buy.com/link/333#bkmrk-member-detail "memberDetail")>NoMember informationMandated 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](https://book.e-buy.com/link/124#bkmrk-e-buy-backend "A group /set of equipment / server to process all the transaction from e-Buy POS")===>Cashier POS**
FieldTypeMandatoryDescriptionMemo
traceNoStringYesCashier terminal trace no.No repeat
orderNoStringYesOrder No. from e-Buy易百生成
transDateStringYesTransaction timeFormat：yyyyMMddHHmmss
returnCodeStringYesReturn code00 represent successful transaction, else represent fail
returnDescStringYesReturn messageDetail explanation / error message per transaction result
paidAmountPriceYesTotal amount paidFace Value. Unit : Dollar
receiptAmountPriceNoMerchant actual received amountNet Value. Unit : Dollar
invoiceAmountPriceNoMerchant invoice amountUnit : Dollar
exchangeRateNumber(8,6)NoExchange RateThe rate of conversion the currency given in the request to CNY.
currencyStringNoCurrencyFor example: CNY
discountCodeStringNoDiscount Codeassigned by Cashier POS
discountNumNumberNonumbers of discountCode用于入账计折扣类型的数量
tenderCodeStringNoTender Codeassigned by Cashier POS,用于入账计支付方式，如：2016120101|20.00表示支付20元
activityProductNoStringNoActivity Product no.
activityProductNameStringNoActivity Product name
needSameCardBooleanNoRequired same card paymentSuch as discount upon amount reached, same credit card must be used for the payment
goodsDetailList<[goodsDetail](https://book.e-buy.com/link/333#bkmrk-goods-detail "goodsDetail")>NoPaid product detailBackend response paid product detail
fundChannelList<[fundChannel](https://book.e-buy.com/link/333#bkmrk-fund-channel "fundChannel")>NoChannel of fund
printDetailObject<[printDetail](https://book.e-buy.com/link/333#bkmrk-print-detail "printDetail")>NoPrinting messageProvided if required to print on the receipt
memberDetailObject<[memberDetail](https://book.e-buy.com/link/333#bkmrk-member-detail "memberDetail")>NoMember informationMember 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 } } ```