Install Requirements for triPOS

Document created by matthew.milner on May 9, 2016Last modified by ecorn on Sep 16, 2016
Version 8Show Document
  • View in full screen mode

triPOS Overview

 

triPOS removes payment applications form PA-DSS scope by avoiding the need to store or process cardholder data, which simplifies and helps reduce risk associated with payment acceptance. triPOS  is a semi-integrated  payment solution that connects together the software application, the point-of-entry device, and the Express interface. A one-time triPOS integration enables a wide range of POS hardware, from simple PIN pads to multi-lane devices. triPOS is an excellent choice for developers who want to take their application out of PA-DSS scope while supporting EMV and other payment features.

 

This document walks developers through the necessary steps to create a test account on the Express platform, register for triPOS SDK, and installation instructions. To view example transactions navigate to Generate a triPOS Request

 

Create a Test Account

 

If you do not already have Express test credentials, go to http://elementps.com/resources/create-a-test-account and create a test account. You will receive an email containing the credentials needed to install triPOS:

  • AccountID
  • AccountToken
  • ApplicationID
  • AcceptorID

 

Next you will need register your account to receive the triPOS install files : https://mft.elementps.com/backend/plugin/Registration

 

triPOS Acct Reg.jpg

 

After clicking Register, you will receive an email with a link to complete your registration: Click the link to complete your registration and you will receive a confirmation email. Once you have completed your registration, contact certification@vantiv.com to get access to the necessary folders.

 

 

Download triPOS

 

1. Login at https://mft.elementps.com with your email address and the password created when you registered.

 

MFT login.jpg

 

2. This will display the Product download page. Click on the Element triPOS folder.  If you do not have any folders listed once you login, please email triPOSSupport@vantiv.com so that the appropriate download permissions can be enabled.

 

triPOS download page.jpg

3. The download page looks like this:

 

triPOS and Drive page.jpg

 

Note Use this same page to download the device drivers.

4. Extract the files to the location of your choice.

 

 

Installing triPOS

 

triPOS consists of binary files, configuration files and supporting files held in a dedicated directory structure that is created by the triPOS installer. In addition, a directory for logs is created at runtime underneath the installation directory.

The triPOS installer requires that the user performing the installation be part of the local Administrators group. triPOS runs as a Windows Service under the Local System account.

 

Registry Entries

The triPOS installer writes the installation directory to the HKLM (Local Machine) section of the registry.

 

Locations

Software\Vantiv\triPOS

Software\Wow6432Node\Vantiv\triPOS

Name

InstallFolder

Data Description

The full path of the installation directory

 

Default Configuration

The triPOS installer sets some key configuration values for you. Based on the information that you provide, the installer will set the port through with you will communicate to triPOS, your credentials, your market code, and an initial lane.

To change triPOS.config settings after installation, use the available endpoints documented under http://localhost:8080/help.

 

Installation Options

There are two ways to install triPOS:

  • Setup Wizard
  • Silent Install

 

 

Setup Wizard

 

The Setup Wizard contains configuration screens that ask for initial configuration details. The same information can be passed in as arguments when run silently.

  1. Double-click on triPOS Setup.exe to launch the setup wizard.
  2. The first screen is the TRIPOS® SOFTWARE LICENSE AGREEMENT:

 

triPOS agreement.jpg

 

To select a custom installation directory, click Options and enter the desired location.

The default installation paths are:

     64-bit machine: C:\Program Files (x86)\Vantiv\TriPOS Service

     32-bit machine: C:\Program Files \Vantiv\TriPOS Service


3. Click I agree to the terms and conditions, then click Install.


4. The next screen is Configuration Information. Enter your Express credentials here. All fields are required to continue with installation. These credentials can be edited later by manually editing the triPOS.config file in Admin mode.

 

 

Note For an explanation of each field, see the table of arguments under Silent Install.

 

5. Click Next to reach the Completed the triPOS Setup Wizard screen.

 

 

Note For an explanation of each field, see the table of arguments under Silent Install.

 

6. Click Finish to reach the Setup Successful screen.

 

Silent Install

 

triPOS can also be installed silently through the command-line. Below is a sample command:

 

“triPOS Setup.exe” /q USERCOMPANY=“Sample Company” LISTENINGPORT=8080 ACCEPTORID=1234 ACCOUNTID=1234 ACCOUNTTOKEN=1234 MARKETCODE=Retail TERMINALID=0000077 LANEID=1 ISMANUALENTRYALLOWED=true COMPORT=COM1
DEVKEY1=123 DEVSECRET1=456 DEVKEY2=321 DEVSECRET2=654


 

    • /q – This tells the installer to run silently so that it does not display any UI components.

 

  • USERCOMPANY – This is the company name that will be displayed on the PIN pad’s welcome message.

 

The following triPOS.config values can be set through command-line arguments during the silent install:

 

Argument

Description

Default Value

/q

This tells the installer to run silently so that it does not display any configuration screens.

NA

LANEID

The lane ID of the initial lane configured by the installer.

NA

INITIALIZEONSTARTUP

Sets whether the lane should be initialized on triPOS start up.

True

TERMINALTYPE

Sets the terminal type of the lane created during install.

PointOfSale

DRIVER

Sets the driver type of the lane created during install.

VeriFoneFormAgentXpi

COMPORT

Sets the Comport setting of the lane created during install.

COM1

DATABITS

Sets thedatabitssetting of the lane created during install.

8

PARITY

Sets the parity setting of the lane crated during install.

None

STOPBITS

Sets thestopbitssetting of the lane created during install.

One

HANDSHAKE

Sets the handshake.

 

BAUDRATE

Sets the baud rate of the lane crated during install.

115200

ISMANUALENTRYALLOWED

Sets manual entry allowed setting of the lane created during install.

true

ISCONTACTLESSMSDENTRYALLOWED

Sets contactless MSD entry setting of the lane crated during install.

false

TERMINALID

Sets terminal ID of the lane created during install.

0000001

ALLOWPARTIALAPPROVALS

Sets allow partial approvals transaction setting.

true

CONFIRMORIGINALAMOUNT

Sets confirm original amount transaction setting.

true

CREDITAVSENTRYCONDITION

Sets credit AVS entry condition transaction setting.

Keyed

CHECKFORDUPLICATETRANSACTION

Sets check for duplicate transaction setting.

true

CURRENCYCODE

Sets currency code transaction setting.

USD

ISCASHBACKALLOWED

Sets cashback allowed transaction setting.

false

ISDEBITSUPPORTED

Sets debit allowed transaction setting.

true

ISGIFTSUPPORTED

Sets gift allowed transaction setting.

True

ISCONVENIENCEFEEALLOWED

Sets convenience fee allowed transaction setting.

False

ISTIPALLOWED

Sets tip allowed transaction setting.

False

CASHBACKSELECTIONS

Sets the cashback selection transaction setting.

1, 2, 3, 4, 5, other

CASHBACKAMOUNTINCREMENT

Sets the cashback increment transaction setting.

5

MAXIMUMCASHBACKAMOUNT

Sets the maximum cashback amount transaction setting.

100

TIPSELECTIONS

Sets the tip selection transaction setting.

15%, 18%, 20%, none

DEBITSURCHARGE

Sets the debit surcharge transaction setting.

0.00

CREDITSALESIGNATURETRESHOLDAMOUNT

Sets the credit sale signature threshold transaction setting.

0.00

SIGNATUREFORMAT

Sets the signature format transaction setting.

PointsLittleEndian

USERCOMPANY

The name of your company that you’d like to see on the PIN pad welcome message. If you set this value to “Sample Company,” the PIN pad welcome message will read “Welcome to Sample Company.”

NA

LISTENINGPORT

The port through which your client application will communicate to triPOS.

NA

ACCEPTORID

Your account acceptorID.

NA

ACCOUNTID

Your accountID.

NA

ACCOUNTTOKEN

Your account token.

NA

MARKETCODE

The market code of your account.

NA

TERMINALID

The terminal ID of the initial lane configured by the installer.

NA

DEVKEY1

This parameter is optional and allows the installer to set the first developer key. If this parameter is not provided one will be generated.

NA

DEVSECRET1

This parameter is optional and allows the installer to set the first developer secret. If this parameter is not provided the developer secret will be generated.

NA

DEVKEY2

This parameter is optional and allows the installer to set the second developer key. If this parameter is not provided one will be generated.

NA

DEVSECRET2

This parameter is optional and allows the installer to set the second developer secret. If this parameter is not provided the developer secret will be generated.

NA

 

 

View next Generate a triPOS Request

https://developer.vantiv.com/docs/DOC-1253?et=watches.email.document#comments

2 people found this helpful

Attachments

    Outcomes