Supported Functions

Below is a list of supported functionalities of the interface to Tender Retail.

Table 9-6 Tender Retail - Supported Functions

Function Description

Sale State Notifications

Sends line items through to the device so the customer display can be updated in line with the POS.

Payment

Sends payment request to Tender Retail's application. The client will return a response message with formatted receipt strings for customer and/or merchant receipts.

In an event of referral or communication failure where authorization cannot be obtained online then a prompt for authorization code will appear; authorization code must be obtained via telephone.

Appropriate receipts will be printed at the end of transaction.

Reversal

Sends reversal requests to Tender Retail's application. The client will reverse a transaction specified by the transaction number, found on the receipt, which must be captured by the POS and passed on to EFTLink.

Refund

Sends refund requests to Tender Retail's application. The client will refund a transaction with specified amount.

Tokenized Refund

Sends refund requests to Tender Retail's application. The client software will refund a transaction with specified token id.

SVC Redeem

Sends a gift or merchandise credit card payment request to the terminal. If there are not enough funds available, only the funds available will be deducted. The POS client will have to settle the transaction with another tender in this scenario.

SVC Redeem Reversal

Sends a gift or merchandise credit card payment reversal request to the terminal.

SVC Activate

Sends a gift or merchandise credit card Issuance request to Tender Retail's MCM software.EFTLink by default for SVS Gift card sends an Issuance message for RequestType=CardActivate. To process an activate message it will be necessary to send through via a card service request a MiscellaneousData element GiftCardType=Activate.For example,

<?xml version="1.0" encoding="UTF-8"?>

<CardServiceRequest RequestType="CardActivate" ApplicationSender="POSSIM" WorkstationID="1" RequestID="1" RequestSubType="PresetValue">

<POSdata LanguageCode="en">

<POSTimeStamp>2019-05-13T16:50:03</POSTimeStamp>

<TransactionNumber>479</TransactionNumber>

<TransactionDay>2019-05-13</TransactionDay>

</POSdata>

<TotalAmount Currency="GBP">50.00</TotalAmount>

<SaleItem ItemID="_1">

<ProductCode>25</ProductCode>

<Amount>50.00</Amount>

<UnitMeasure>EA</UnitMeasure>

<UnitPrice>50.00</UnitPrice>

<Quantity>1</Quantity>

<TaxCode>A</TaxCode>

<TaxRate>0.00</TaxRate>

<AdditionalProductCode>12345678</AdditionalProductCode>

<AdditionalProductInfo>SVC Card</AdditionalProductInfo>

</SaleItem>

<MiscellaneousData>GiftCardType=Activate</MiscellaneousData>

</CardServiceRequest>

SVC Activate Reversal

Sends a gift or merchandise credit card activation request to Tender Retail's MCM software.

SVC Add Value

Sends a gift or merchandise credit card add value request to Tender Retail's MCM software. The card must be first activated before using this function.

SVC Add Reversal

Sends a gift or merchandise credit card payment request to Tender Retail's MCM software. Optionally a void will be activated in the core to avoid presenting the card for the reversal.

SVC Balance Enquiry

Sends a gift or merchandise credit card balance enquiry request to Tender Retail's MCM software.

SVC Unload (Cash Out)

Sends a gift or merchandise credit card cash out request to the Tender Retail's MCM software. All funds are deducted from the account and the cash back amount is returned to the POS. The account is not deactivated as part of this process.

Read Non-PCI Card

EFTLink sends a card swipe request to receive data for non-pci cards. The full pan is returned in clear text, unencrypted and without tokenization.

PCI cards will return a blank PAN.

As EFTLink doesn't currently have a direct mapping for requesting for a Token. As a work around to request for a token then send RequestType=CardSwipe within the CardServiceRequest. Include the string "GetToken" within the Card Value element and map the Card Type to either of the following value (taken from the tender retail technical specification document)

1 - Master Card

2 - Visa

3 - American Express

4 - Discover

6 - Enroute/Diners

7 - JCB

< - Debit

0 - Unknown

For example,

<?xml version="1.0" encoding="UTF-8"?>

<CardServiceRequest RequestType="CardSwipe" ApplicationSender="MICROS" WorkstationID="1" RequestID="1">

<POSdata LanguageCode="en">

<POSTimeStamp>2019-05-10T16:30:20</POSTimeStamp>

</POSdata>

<CardValue CardType="0">

<Token>GetToken</Token>

</CardValue>

</CardServiceRequest>

Ewallet (Flow 3) Citcon / Alipay

Payment

Sends payment request to Tender Retail's application. The client will return a response message with formatted receipt strings for customer and/or merchant receipts.

Appropriate receipts will be printed at the end of transaction.

Refund

Sends refund requests to Tender Retail's application. The client will refund a transaction with specified amount.

Cancel

Sends void/correction request for Payments or Refunds. Please note this is only supported for MCM direct to Alipay. MCM to Citon to Alipay is not supported.