ID TECH - Windows | Payroc

In this configuration, your ID TECH device communicates with your Windows host machine through the Payroc Cloud middleware. To ensure your POS can communicate with the ID TECH device, you need to configure your Windows host machine.

Integration steps

Prepare your host machine for configuration.
Configure the native libraries.
Configure the payconfig.xml file.
Run the middleware.

Before you begin

Your host machine must have Java 8 or later installed. If you use a Windows 32-bit host machine, make sure you have installed 32-bit Java and configured its path.

Step 1. Prepare your host machine for configuration

To download the Payroc Cloud middleware and connect the payment device to the host machine, complete the following steps:

Connect your payment device to a USB port on your host machine.
Go to our Github repository and download Payroc Cloud middleware from the release files.

If your host machine has Java 8 up to Java 16 installed, download version 1.6.76.
If your host machine has Java 17 or later installed, download version 1.6.78+.

Extract the files from the zipped folder.

Step 2. Configure native libraries

You need to copy the libraries that match your operating system into the middleware root folder so the middleware can load them when it starts. To do this, complete the following steps:

Open the folder that you extracted the Payroc Cloud Middleware to.
Locate the folder that contains the library that you want to use, for example, to use 64-bit Windows with ID TECH, go to libs > idtech > win-native-64.
Copy the contents of the folder into the root folder.

Step 3. Configure the payconfig.xml file

The payconfig.xml file defines how the middleware communicates with the ID TECH device and our gateway, including:

Which Payroc account and integration you are working with, for example, you send your API key to authenticate your requests.
Which payment device the middleware is communicating with, for example, you send the value for the port that the ID TECH device is connected to on the host machine.
How the ID TECH device should behave in transactions, for example, you indicate if the device should accept keyed transaction details.

Use the following values to configure your payconfig.xml file:

Field	Value
apiKey	Enter your Payroc App API key.
integrationId	Enter your integrationId.
terminalId	Enter your processingTerminalId.
deviceType	Indicates the type of payment device you are using. Enter `IDTECH`.
sdkMode	Indicates the SDK mode. Enter one of the following values: – `LIVE` - Production mode – `TEST` - Test environment – `DEV` - Developer mode
logLevel	Indicates the logging level for the SDK. Enter one of the following values: – `LEVEL_FUL` - Verbose – `LEVEL_INFO` - Informational messages – `LEVEL_ERROR` - Errors only – `LEVEL_NONE` - Disables logging
portName	For an IDTech devices, do not edit this value.
emvType	Indicates the EMV processing type you want the device to support. Enter one of the following values: – `STANDARD` - Standard EMV processing. – `QUICK_CHIP` - Faster EMV transaction flow.
inputMethod	Indicates the EMV processing type you want the device to support. Enter one of the following values: – `SWIPE_OR_INSERT_OR_TAP` - Cardholder can swipe, insert, or tap their card. – `SWIPE_OR_INSERT` - Cardholder can swipe or insert their card.
debitAIDPreference	For an IDTech devices, do not edit this value.
disableOnDeviceSignature	For an IDTech devices, do not edit this value.
enableDeviceLogs	Indicates whether the device collects debug logs. Enter one of the following values: – `true` - Device collects debug logs. – `false` - Device does not collect debug logs.

Step 4. Run the middleware

To run the middleware, double-click the start-idtech batch file in the root folder. This establishes communication between your host machine, your ID TECH device, and our gateway.

After the middleware starts, the logs display the serial number of your ID TECH device. You need this serial number to send transaction requests so that the gateway can route the instructions to the correct device.

Next steps

To program your POS to send instructions to your ID TECH device, go to (Run a sale)[/guides/take-payments/payroc-cloud/run-sale.mdx].