IntegratePayroc CloudConfigure your payment deviceConfigure a non-Android device

Configure an Ingenico device

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

Integration steps

  1. Configure the native libraries.
  2. Configure the payconfig.xml file.
  3. Run the middleware.

Step 1. Configure the native libraries

  1. Open the folder that you extracted the Payroc Cloud Middleware to.
  2. Locate the folder that contains the library that you want to use, for example, to use 64-bit Windows with Ingenico, go to libs > ingenico > nativeLibsWindows > 64bit.
  3. Copy the contents of the folder into the root folder.

Step 2. Configure the payconfig.xml file

FieldValue
apiKeyEnter your Payroc App API key.
integrationIdEnter your integrationId.
terminalIdEnter your processingTerminalId.
deviceTypeIndicates the type of payment device you are using. Enter INGENICO.
sdkModeIndicates the SDK mode. Enter one of the following values:
– LIVE - Production mode
– TEST - Test environment
– DEV - Developer mode
logLevelIndicates 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
portNameIndicates the Serial/COM port name of the USB port that you connected the Ingenico device to.
emvTypeIndicates 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.
inputMethodIndicates the EMV processing type you want the device to support. Enter one of the following values:
– SWIPE_OR_INSERT_OR_TAP_OR_KEYED - Cardholder can swipe, insert, tap, or key in their card number manually.
– SWIPE_OR_INSERT_OR_TAP - Cardholder can swipe, insert, or tap their card.
– SWIPE_OR_INSERT - Cardholder can swipe or insert their card.
debitAIDPreferenceIndicates the Debit Application Identifier (AID). Applies to dual banded cards. The value must be one of the following:
–PREFER_GLOBAL_DEBIT_AID - Prioritize global AID.
–PREFER_US_COMMON_DEBIT_AID - Prioritize U.S. debit AID.
–APPLICATION_SELECTION - Cardholder can choose between debit or credit.
disableOnDeviceSignatureFor Ingenico 5000 and 7000 devices, enter one of the following values:
–true - Device does not support cardholder signatures.
–false - Device supports cardholder signatures.

For other Ingenico devices, do not edit this value.
enableDeviceLogsIndicates 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 3. Run the middleware

To run the middleware, double-click the start-ingenico 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.

Guides

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

Run a sale

Use Payroc Cloud to run a sale.

Run an unreferenced refund

Use Payroc Cloud to run a refund.

Step 1. Configure the native libraries

  1. Add a new file in /etc/udev/rules.d and name it usb.rules.
  2. Add the following contents to the file: SUBSYSTEM=="usb", MODE="0666"
  3. Run the following command to load the libraries: $ sudo ldconfig

Step 2. Configure the payconfig.xml file

FieldValue
apiKeyEnter your Payroc App API key.
integrationIdEnter your integrationId.
terminalIdEnter your processingTerminalId.
deviceTypeIndicates the type of payment device you are using. Enter INGENICO.
sdkModeIndicates the SDK mode. Enter one of the following values:
– LIVE - Production mode
– TEST - Test environment
– DEV - Developer mode
logLevelIndicates 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
portNameIndicates the Serial/COM port name of the USB port that you connected the Ingenico device to.
emvTypeIndicates 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.
inputMethodIndicates the EMV processing type you want the device to support. Enter one of the following values:
– SWIPE_OR_INSERT_OR_TAP_OR_KEYED - Cardholder can swipe, insert, tap, or key in their card number manually.
– SWIPE_OR_INSERT_OR_TAP - Cardholder can swipe, insert, or tap their card.
– SWIPE_OR_INSERT - Cardholder can swipe or insert their card.
debitAIDPreferenceIndicates the Debit Application Identifier (AID). Applies to dual banded cards. The value must be one of the following:
–PREFER_GLOBAL_DEBIT_AID - Prioritize global AID.
–PREFER_US_COMMON_DEBIT_AID - Prioritize U.S. debit AID.
–APPLICATION_SELECTION - Cardholder can choose between debit or credit.
disableOnDeviceSignatureFor Ingenico 5000 and 7000 devices, enter one of the following values:
–true - Device does not support cardholder signatures.
–false - Device supports cardholder signatures.

For other Ingenico devices, do not edit this value.
enableDeviceLogsIndicates 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 3. Run the middleware

To run the middleware, complete the following steps:

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

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

Guides

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

Run a sale

Use Payroc Cloud to run a sale.

Run an unreferenced refund

Use Payroc Cloud to run a refund.