Configure an IDTech device | Payroc

After you’ve downloaded the Payroc Cloud Middleware, use the following guides to configure your IDTech payment device:

To set up an IDTech payment device on a Windows host machine, go to Configure an IDTech device for a Windows host machine.
To set up an IDTech payment device on a Linux host machine, go to Configure an IDTech device for a Linux host machine.

Integration 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 IDTech, go to libs > idtech > nativeLibsWindows > 64bit.
Copy the contents of the folder into the root folder.

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.

To run the middleware, double-click the start-idtech batch file in the root folder.

In the logs, we output the serial number of the device, which you need to integrate with Payroc Cloud.

To integrate with our API so that you can send instructions to a payment device, go to our guides:

Use Payroc Cloud to run a sale.

Use Payroc Cloud to run a refund.

Create a new file in /etc/udev/rules.d and name the file usb.rules.
Add the following contents to the file: SUBSYSTEM=="usb", ATTRS{idVendor}=="0acd", MODE="0666"
Create a new file in /etc/ld.so.conf.d and name the file idtech_libs.conf.
In the idtech_libs.conf file, add the path to the IDTech middleware package that contains the libraries for your Linux machine.
Run the following command to load the libraries: $ sudo ldconfig

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.

To run the middleware, complete the following steps:

Run the following command to make the start.sh file executable: $ chmod +x start-idtech.sh
Run the following script to start the middleware: $ ./start-idtech.sh

In the logs, we output the serial number of the device, which you need to integrate with Payroc Cloud.

To integrate with our API so that you can send instructions to a payment device, go to our guides:

Use Payroc Cloud to run a sale.

Use Payroc Cloud to run a refund.