This chapter describes the Merchant Link implementation.
This Merchant Link implementation is for use with any compatible terminal that has Merchant Link firmware installed, with communication based on a socket protocol.
This document assumes static EFTLink configuration. When deploying with a POS that supports dynamic configuration, all property settings referred to below should be set on the POS, and not directly into local property files.
Merchant Link is deployed as an intelligent terminal. EFTLink connects directly to the PoslynxMINI device which in turn connects to the Verifone MX925 device using a proprietary socket/XML protocol. The PoslynxMINI device acts as a message broker to the MX925 device. The MX925 device will need to know the PoslynxMINI device address. When setting up the system for the first time it is best to contact Merchant Link who will be able to talk through the process.
In addition to standard EFTLink files:
poslynxcore.jar
– executable code for the Merchant Link EFTLink core.
poslynx.properties
– configuration settings to specify which features are enabled and to define communication parameters for the interface with the terminal.
Lang<CC>_<Core>.properties
– Language translation file, for further information see Language.
Note: If the POS supports dynamic configuration, properties can be set there instead of inposlynx.properties . |
The translation files for this core should not require alteration, but if necessary then this can accomplished by amending the relevant Lang<CC>_<Core>.properties
within the base eftlink folder.
The language used will follow the language set in the EFTLink framework; see the Oracle Retail EFTLink Framework Installation and Configuration Guide, EFTLink General Information, Translation section.
EftlinkConfig.properties
DisplayLanguage = EN
Supported country codes are: CN, DE, EN, ES, FR, IT, JP, NL, PT, RU and SV.
The following should have been set in the EftlinkConfig.properties
file by installcore.bat or installcore.sh:
EPSCore0 = manito.eft.poslynx.PoslynxCore
The full set of configuration properties is defined and commented in poslynx.properties
.
Settings that may be different for each POS/PED.
The Core will connect to the PoslynxMINI device, this device is connected to the internet and the LAN and is accessible by Merchant Link. The device is DNS enabled and will have an address of the following format:
Table 5-2 Merchant Link - Secondary Settings
Setting | Description | Default | Example |
---|---|---|---|
TerminalPort |
Port number. |
5015 |
|
ConnectionTimeout |
Connection time out in seconds. |
10 |
|
ResponseTimeout |
Overall response timeout in seconds. |
300 |
|
MaintenanceTimeout |
Maintenance menu selection timeout in seconds. |
60 |
|
EmbeddedPrinting |
Option to buffer customer printout generated during the transaction and then include it in the POS authorization response so that it can be merged with the POS receipt line to form a single receipt/voucher. |
false |
|
ReceiptSignatureTriggerText |
Trigger/key in receipt text to indicate that a paper signature is required. |
X___ |
|
SignatureCaptureEnabled |
Whether to enforce an electronic signature capture for credit transactions over a designated value. |
false |
|
SignatureCheckFloorLimit |
Floor limit to be applied if SignatureCaptureEnabled is set true. |
0 |
|
SignatureCheckTimeout |
Timeout in seconds on waiting for signature. |
30 |
|
MaxLineItemTextLength |
Maximum line item description length allowed by comms protocol or visible on terminal. |
17 |
|
MaxLineItems |
Maximum number of line items allowed in a single message. |
10 |
|
MaxLineItemUpdates |
Maximum number of separate line item update messages it is practical to send before it becomes too cumbersome and slow. |
20 |
|
ShowlineItemsOnVoucher |
Whether to include line items in the voucher. |
false |
|
ReceiptLineItemStartTag |
Keyword or phrase that identifies start of item summary on voucher. |
QTY DESCRIPTION |
|
ReceiptLineItemEndTag |
Keyword or phrase that identifies start of item summary on voucher. |
Total: |
|
ShowEMVTagsOnVoucher |
Whether to remove EMV tags from the EFT voucher. |
false |
|
VoiceAuthorizationIndicators |
A comma separated list of text from the response indicating the operator to call for voice authorization. |
R001 CALL VOICE AUTH - REFERRAL |
|
AddLane |
Whether to send the Lane ID to the TL device. |
false |
|
PrintMerchantCopy |
Whether to print the merchant copy of the receipt. |
true |
|
MinimumInterMessageGap |
Enforced minimum gap interval in milliseconds between messages. |
10 |
|
MerchantAccessCode |
The client merchant access code sent to TL device. |
FFFFFFFFFFFF |
|
ClientID |
Client ID sent to TL device. |
1 |
|
GiftCardEncryptionType |
Encryption type sent to TL device. |
64 |
|
LaneID |
The lane ID sent to the TL device. |
L1 |
|
MinimumAuthCodeLength |
Minimum number of characters for the authorization code for voice authorization. |
1 |
|
MaximumGetAuthCodeAttempt |
Maximum number of attempts to capture the authorization code from the operator. |
3 |
|
EnablePOSTriggeredBatchClose |
Whether POS triggered batch close is enabled in the administrative functions. |
false |
|
MWVendor |
The vendor name of our middleware sent to the TL device. |
Oracle |
|
MWModel |
The official name of our middleware sent to the TL device. |
Oracle Retail EFT Link |
|
SendInvoiceNum |
Whether to send the InvoiceNum or POS transaction number to the TL device. |
true |
|
floorLimit |
Floor limit to be applied for payments in an offline state. If under, the transaction is resent with SAF enabled. If over, a call for authorization is required before being resent with SAF enabled. |
0 |
|
CardRangeLookup |
If true, EFTLink will use its mapping file CardRange.xml to determine the card scheme name. |
false |
|
TransactionQueryAttempts |
The maximum number of attempts to query a transaction through IDDETAIL command. |
3 |
|
The terminal has some administration/maintenance functions. These can only be invoked from a dedicated EFT Maintenance menu button.
EFTLink uses DeviceProxy messages to display input prompts on the POS to manage these functions.
Table 5-3 Merchant Link - Administration Functions
Function | Description |
---|---|
Local Connection Test |
Sends a request to test the connection to the device. This Core builds an XML request with the "CONNECTIONTEST" command and should receive a response with an "APPROVED" result if successful. |
Host Connection Test |
Sends a request to test the connection between the device to the MerchantLink gateway. This Core builds an XML request with the "CONNECTIONTEST" command and should receive a response with an "APPROVED" result if successful. |
Pin Pad Reset |
This command will terminate any pending transaction on the pin pad and return the pin pad to its 'ready' state. For the VeriFone and Equinox pin pads, the pin pad will display the 'Welcome' screen. For the Ingenico pin pads, the pin pad will display the respective offline form. |
Pin Pad Reboot |
Sends the PPREBOOT command which reboots the pin pad. |
Signature Capture |
Sends request to test the signature capture functionality on the device. |
Batch Summary |
Sends a batch summary request to the terminal. This provides a summary report of the current information for that batch of transactions prior to settlement. It should be considered as flash report typically referred to as an X read report. |
Batch Report |
Sends a batch card totals request to the terminal. This will return a report which will summarize the card type totals for the current batch prior to settlement. |
Batch Close |
Sends a batch close request to the terminal. This will initiate a batch close process on the host processor which triggers transactions to be submitted for financial settlement. This returns a day end report. |
Get Versions |
Sends a request to get the firmware versions of the TL device. The details are displayed to the operator. |
Pin Pad EMV Configuration |
Sends a request to reset the pin pad. This command will force the terminal to restart after acquiring Certificate Authority Public Key (CAPK) file from the host processor.into the pin pad. |
Contact NetVu Management Server |
Sends the CONTACTNETVU command which contacts the NetVu management server and uploads the current diagnostic and statistics log files on the TL device to NetVu. |
Run Diagnostics Utility |
This command executes the Diagnostics Utility. The Diagnostics Utility is an application on the TransactionLink device that can be used to verify if the installation/set-up is correct. The Diagnostic Utility will use the pin pad to display a sequence of system and configuration information, one parameter at a time. The user can then compare and confirm if the set-up is using the correct parameters as displayed. |
Invoice Detail |
Sends a request to retrieve the details of the most recent financial transaction. |
Below is a list of supported functionalities of the interface to Merchant Link. Many functionalities are provided by Merchant Link, such as Loyalty, Cashback and so on, (please refer to interface specification for details) but are not implemented because of the business requirement.
Table 5-4 Merchant Link - Supported Functions
Function | Description |
---|---|
Payment |
Sends payment request to the terminal. Terminal will return a response message with unformatted receipt strings for customer and/or merchant receipts. In an event of referral where authorization cannot be obtained online then a prompt for authorization code will appear; authorization code must be obtained via telephone and entered here. If successful, appropriate receipts will be printed at the end of transaction. |
Reversal |
Sends reversal request to the terminal. This will reverse a transaction specified by the transaction number, found on the receipt, which must be captured by the POS and pass on to EFTLink. |
Refund |
Sends refund request to the terminal. This will refund a transaction with specified amount. |
Sale State Notifications |
Sends line items through to the device so the customer display can be updated in line with the POS. |
SVC Payment |
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 Activate |
Sends a gift or merchandise credit card activation request to the terminal. |
SVC Deactivate |
Sends a gift or merchandise credit card deactivation request to the terminal. The account is disabled after this as the request is intended to be used for lost or stolen cards. It is not possible to use the card or account once this request has been issued and accepted |
SVC Add Value |
Sends a gift or merchandise credit card add value request to the terminal. This will only add value to an account that has been activated. |
SVC Balance Enquiry |
Sends a gift or merchandise credit card balance enquiry request to the terminal. |
SVC Unload (Cashout) |
Sends a gift or merchandise credit card cash out request to the terminal. 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. |