LPT EMV Setup

LPT EMV Setup

/home/sitecon/sc Variables

  • DEBIT_YES 1
  • TERMTYPE P
  • DISABLE_FALLBACK 1
  • EMV_ENABLED 1
  • EMV_PREAUTH_AMOUNT 7500

Note: If your bank cards are set to be preauthorized for $75.00, EMV_PREAUTH_AMOUNT needs to be set to 7500. This is needed for every Crind type for outside EMV.

LPT.MAP

OS Version

The LPT has no formal firmware version but OS Version SLES 15.3 is recommended and at least SC Model 350 or newer is required.

MagTek Firmware

MagTek Odynamo (contact) the firmware needs to be 1000004854-D3

  • If running offline PIN, version REV-J and greater, after June 9, 2022. Some REV-H versions will work but are not guaranteed to work.
  • Firmware also needs to be updated for Pin Bypass to work

MagTek Dynawave (contactless) the firmware needs to be 1000004238-M0 and can only be updated via a Windows program.
Firmware, tools and instructions are available here (MagTek.zip)

CODE VERISONS

  • SC Code – 11.01.01-0147_SCEMV_Beta or newer
  • CCL Code – 11.01.01-3613_SCEMV_Beta or newer
  • LPT Code – LinuxQtLPT-11.01.01-0004 or newer

Although these versions of code utilize TCP/IP for the card reader, leave the “Crind Port: “ set as is.

Remove Debit = Yes from all Fuel Dispenser setup

FOR OUTSIDE EMV

A production LPT PDL must be placed in the /home/sitecon/sc

  1. Get the host specific EMVPDL_Golden_###_LPT.xml file from here (where ### is RBS, ATL or ADS)
  2. Load file to /home/sitecon/sc and rename to $EMVPDL.xml
  3. Make sure proper permissions and ownership are set

CCL VARIABLES

  • EMV_ENABLED 1

Tells host the system is EMV capable.

  • PDL ###

Where ### is “ADS”, “ATL”, or “RBS”

  • OUTSIDE_CARDS SvADGMmVWYZ$,17 – Be sure to add “Z” for Debit to this Line
  • OUTSIDE_TF_CARDS ScpetujhmvYGWADMVZ$,10,8,17 -- Be sure to add “Z” for Debit to this Line

***ADS specific variables***

  • ADS_EMV_AID_LIST A0000000031010,A0000000032010,A0000000033010,

A0000000041010,A0000000042203,A0000000043060,A00000002501,

A0000000980840,A0000001523010,A0000001524010,A0000003241010

  • ADS_EMVPDL_DEVICEID ###

If site is attended, set to Master POS number + 200. For example, if the Master POS is Register # 01, then set to 201. If site is unattended, set to 001.

***RBS specific variable***

  • PARAM_DATA 1

EDITAUTH

Be sure to add “Z” (Debit) to your Host that accepts Bankcards at the location

Example:

1: Service Type: ATL

2: Card IDs: ADMVmvWYGS$Z

3: Bank ID: VFS003

4: Term Type:

5: Mode: Authorization

6: Merchant ID: JZ16538923003

7: Telephone 1: 01000000100119971

8: Telephone 2: 18007812370

9: COM Port: COM2,L

10: Baud Rate: 1200

Authlimits.cfg

Be sure to add “Z” to the authlimits.cfg file for an auth limit request.

1

999.00,tpcerujGWUYxnh

100.00,Vv

125.00,S

100.00,AMmZD -------------Add Z for Debit to authlimits.cfg file

LPT Environment variables (/home/lpt/environ.dat)

General Card Reader Variables:

Environment Variable Parameter Values Example Usage Comment
MAG_IP no parameter values MAG_IP Include if connecting to the connected Magtek Card Reader via IP
DISABLE_EMV 1 1|0|true|false|yes|no|on|off DISABLE_EMV off Disables EMV Capability when enabled
NOTE: If a Magtek oDynamo is connected, to disable emv powercycle the oDynamo then add the above variable
ENABLE_EMV_QUICKCHIP 1 1|0|true|false|yes|no|on|off ENABLE_EMV_QUICKCHIP yes turn on when using quick chip
THIS IS REQUIRED TO BE ENABLED
PIN_BYPASS 1 1|0|true|false|yes|no|on|off PIN_BYPASS on turn on when using PIN bypass
ENABLE_OFFLINE_PIN 1 1|0|true|false|yes|no|on|off ENABLE_OFFLINE_PIN 1 Turn on when supporting offline PIN capability

Magtek oDynamo Contact Reader Specific Variables:

Environment Variable Parameter Values Example Usage Comment
NEW_ODYNAMO 1 1|0|true|false|yes|no|on|off NEW_ODYNAMO on turn on when using new odynamo (version D3 or greater)
LEAVE_CARD_INSERTED prompt

LEAVE_CARD_INSERTED prompt Use prompt to turn on messages to leave card inserted.
SUGGESTED IF CLAMP_CARD_READER IS DISABLED
CLAMP_CARD_READER no parameter values CLAMP_CARD_READER The presence of variable allows clamping of the card; false otherwise. THIS IS OFF BY DEFAULT

Magtek Dynawave Contactless Reader Specific Variables:

EMV_NFC_TRANS_AMOUNT {Integer Value} EMV_NFC_TRANS_AMOUNT 10000 If set to 10000, then it reads as $100.00

NOTE: Dynawave variables are CURRENTLY ONLY applicable for Worldpay and Fiserv Processors.

Cryptera EPP Pinpad Specific Variables:

Environment Variable Parameter Values Example Usage Comment
PCI5_PINPAD 1 1|0|true|false|yes|no|on|off PCI5_PINPAD yes turned on when using PCI-5 pin pad
(Used in LPT code past 10.01.02-038)
PP_COM {Integer Value [1,4] } PP_COM 3 Set to 3
defaults to 3 (/dev/ttyS2)

1 All boolean environment variables are not case sensitive. For example, Yes, yes, YEs, … can be used. Optionally, just the presence of environment variable indicates true and absence of environment variable indicates false.

LPT 10-Rules File

LPT 10-Rules File needs to be Updated or created with inst_usb_emvreader Script the script will add the Following line to the /etc/udev/rules.d/10-local.rules file

SUBSYSTEM=="usb", ATTR{idVendor}=="0801",ATTR{idProduct}=="001e",OWNER="lpt"

SUBSYSTEM=="usb", ATTR{idVendor}=="0801",ATTR{idProduct}=="001b",OWNER="lpt"

Note: 0x0801 – 0x001e is for the Dynawave Contactless Reader and 0x0801 – 0x001b is for the oDynamo Contact Reader

SC Hardware & OS Requirements

  • Must have a SC Model 350 or newer
  • SLES 15.3 is recommended

Current LPT EMV Support

  • Heartland: Contact only
  • WorldPay: Contact and Contactless
  • Fiserv: Contact only
  • NBS: Not Certified

0 Comments

Add your comment

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.