IPP320 Quick Start GuideThis is a quick start guide for setting up Ingenico IPP320 pinpad, injected with RBA firmware v 14.xx+ for use with 911 Software CreditLine.

Note, that if the correct firmware (RBA, not OPOS) has not been injected by the injection authority, the pinpad will not be operational. OPOS drivers are not necessary.

Please use with CreditLine Build 1186.13+ SP3 or Build 1186.12 and HOTFIX_IPP320_RBA_20151207

Table of Contents1.Change PinPad Communication option....................................................................................................2

2.Install Drivers............................................................................................................................................9

3.CreditLine Configuration.........................................................................................................................14

4.Testing the EMV PinPad in CreditLine Manager.....................................................................................18

5.API for EMV Pin Pad Operation...............................................................................................................22

1. Change PinPad Communication optionNote: This setup only needs to be executed for a brand new PinPad.

Restart PinPad.When you see the screen displayed like below, press [2] [6] [3] [4] [OK] [F], to enter the PinPad setup menu.

At first Setup menu, you will see the following options, then select [3] TDA

Then after the below options are displayed, chose [0] Configuration

And then chose [0] Communication in the following screen

After you chose [0] Commnuication, the PinPad screen will display below menu, chose [0] Select Comm.Type

And Then select [3] USB<> SerialConv to finish the setup

Finally, save the change and restart the PINPAD by pressing Red Button three times and when below screen displays, select Yes.

2. Install Drivers

IPP320 DriverClick on the link to the right to download and Install IPP320 driverUnzip the package and double click the exe file.See below for the installation flow

Leave the force COM Port feature empty, the system will assign the COM port to the PinPad. And then click Next:

USB InstallerClick on the link to the right to download and Install USB Installer

1. Unzip the package.2. Execute the exe file to install the USB driver manually, or execute the bat file to install the driver

in silent mode.

3. CreditLine Configuration

Obtaining the correct EMV Pin Pad Port Number

First, we need to check the IPP320 Comm Port setting: after connecting the PinPad to your machine, you can find the PinPad Comm Port setting in your Device Manager, as can be seen in the below snapshot.

Record the Port Number displayed and proceeds to the CreditLine Configuration below

Setting The Port Number in CreditLine and Enabling the Pin Pad for API on Server side

Now we need to match this port number in the CreditLine setup:1. Open …\911\Data\CLCAPI.INI on Server side.2. Search for the existing configurations matching [PINPAD.xxxx] and please delete all of them3. Change the PINPAD configuration according the PinPad Comm Port setting obtains from the

Device Manager, in the procedure above.4. Create or modify the following section to match the correct info.

[PINPAD]TerminalID=Enabled=1 PortDef=COM7: 9600,N,8,1Type=7UsePinpadSwipe=1QuickSetPinEntryData=0

;Note1: Make sure to enter the correct port number, obtained from the device manager. Format for the PortDef is [Com Port Number]:[Bits per second],[Parity],[Data Bits], [Stop Bits];Note2: Type 7 means PinPad is Ingenico IPP320 with RBA framework.

FINALLY, Restart the CreditLine Server to activate the CLCAPI.ini settings.

Setting The Port Number in CreditLine and Enabling the Pin Pad for API works on Terminal side.

1. After we setup the Port Number on server side, please launch your application on Terminal side which invokes the CreditLine APIs.

2. After your application launched, please open …\911\Data\CLCAPI.INI on Terminal side.3. New PinPad configuration section should be attched in the end of the CLCAPI.ini, and the

title for this section should like “[PINPAD.<your client name>]” , the client name you setup in api clcInit( LPCTSTR ClientName, LPCTSTR ServerName )

4. Refer below snap-shot, if you set the “Term001” as the client name in clcInit, then the new section title should be “[PINPAD.Term001]” and the CLCAPI.ini should like below.

5. The configuration in the new section will only works on this terminal. The default content copy from the [PINPAD] section, so the parameter may incorrect, please check the PINPAD Comm port setting on your Terminal machine from the Device Manager, in the procedure above, and correct the parameter in this new section.

6. Restart your application and CreditLine Server to make the change available.

Setting The Port Number in CreditLine and Enabling the Pin Pad for CreditLine Manager Works on Terminal

1. Startup the CreditLine Manager on terminal side2. Open …\911\Data\CLCAPI.INI on Terminal side.3. New configuration section should be attched in the end of the CLCAPI.ini, the title for this

section should like “[PINPAD.CCV_MGR_<your machine name>]” .4. Refer below snap-shot, if your terminal’s machine name is “QWE123”, the section title

should be “[PINPAD.CCV_MGR_QWE123]”.

5. The configuration in the new section will only works on this terminal. The default content copy from the [PINPAD] section, please correct the PINPAD setting according your Terminal machine’s PINPAD Comm Port setting.

6. Restart the CreditLine Manager and CreditLine Server to make the change available.

Initial Pin Pad Display

“This Lane Closed will be displayed initially by the pin pad. This is normal.

4. Testing the EMV PinPad in CreditLine ManagerAfter restarting the CreditLine Manager and the Server, click Command->Credit Cards->Sale

Click Read Card and Slide the Card when prompted in the regular side Magnetic Swipe Slot (EMV Slot is not enabled at this time)

Slide a card and then select Credit (EMV reader is not enabled at the moment).

Then the account number and exp data will be filled in CreditLine manager automatically, enter the amount and press ok to finish the transaction.

5. API for EMV Pin Pad Operation Here is a simple code example for a PINPAD swipe transaction:

//init clcapi client first

HCLOBJ hObj = clcInit( "Test123456", "CCVSRVR" );

//then setup the merchant infomationclcSetOperatorName( hObj, "JOESMITH" );clcSetTableNumString( hObj, "BAR123" );clcSetStationIdString( hObj, "GOLF88" );clcSetInvoiceNum( hObj, "BANQUET1234" );…

//set transaction amount before request swipe

clcSetAmount( hObj, 100 );

//after setup transaction amount, request pinpad to swipe

clcPinpadRequestSwipe( hObj );

//then exexute the transaction and get result

lRst = clcAuth( hObj );

At this point the pin pad will display the following:

Swipe the Credit card on the PinPad.

After the swipe, PinPad will request you input the Card type, Credit or Debit, for Credit, please select “Credit” or “Debit” by using the soft key F4. Debit Flow is the same as Credit Flow below, plus the pin and cashback prompts.

The PinPad will display the transaction amount; you can check the amount and Press “Yes” to confirm, “No” to cancel.

At this point, the transaction will send the transaction to processor and the method clcAuth or clcSale will return true or false to indicate the transaction result and PinPad will go back to “Lane Closed” Screen to finish this transaction and become ready for the next transaction.