IngenicoBack to Devices

Our Ingenico plugin supports multiple Ingenico devices running on the RBA, UPP, and Axium platforms. We support 2 main devices for 2 different configurations; attended (iPP320/350/Lane3000) and unattended (iUC285). If you have another RBA device please contact %CompanyContact for assistance in setting up.

Supported devices

Windows Linux Android
Axium DX4000 ✘ ✘ ✔
Axium DX8000 ✘ ✘ ✔
Axium RX7000 ✘ ✘ ✔
IPP320/350 ✔ ✔ ✔
IUC285 ✔ ✔ ✔
Lane3000 ✔ ✔ ✔
Lane5000 ✔ ✔ ✔
Lane7000 ✔ ✔ ✔
Self 2000 ✔ ✔ ✔
Self 3000 ✔ ✔ ✔
Self 4000 ✔ ✔ ✔
Self 5000 ✔ ✔ ✔

Check the Troubleshooting section to view what RBA/UPP/Axium version is supported on Ingenico devices

Installation Instructions

SDK

Below you can find the different platforms where you can integrate the SDK. Please proceed to the platform you have chosen to integrate with.

Before proceeding, please download all necessary files for your device. You can find all the necessary files in the Downloads section.

Linux

  1. Download sample app as well as ingenico plugin from here
  2. Unzip both zip files
  3. Open up SwingSample folder located in Sample app in some IDE
  4. Open MainForm.java and run it
  5. Edit configuration on MainForm.java
  6. Depending on architecture unzip the 32 or 64 bit RBA native libs that are bundled.
  7. Point your environment to the library files:
    • For Java: Set the -Djava.library.path=<native libs folder>
  8. Set the permissions for the user to have access to usb TTY devices where <user> is the user that will be running your payment application. N.B. you need to re login to take effect!
        sudo usermod -a -G uucp <user>
        sudo usermod -a -G dialout <user>
        sudo usermod -a -G lock <user>
        sudo usermod -a -G tty <user>

  • Note: If you see the error libudev.so.0: cannot open shared object file: No such file or directory

    Please link the existing libudev.so.1 to the requested libudev.so.0: sudo ln -s /lib/x86_64-linux-gnu/libudev.so.1 /lib/x86_64-linux-gnu/libudev.so.0

Done! With your ENVIRONMENT properly configured you are now ready to perform your first sales transaction. Check out the Coding 101 section for more information.

Windows

  1. Depending on architecture unzip the 32 or 64 bit RBA native libs that are bundled.
  2. Copy the dlls from Resources folder to C:\Windows\SysWow64
  3. Install ‘Microsoft Visual C++ Redistributable Package (x86)’ or alternatively copy the included windows dll files to C:\Windows\Syswow64.

Done! With your ENVIRONMENT properly configured you are now ready to perform your first sales transaction. Check out the Coding 101 section for more information.

Android

RBA/UPP Platforms

  1. Extract libraries from “jniLibs” folder and copy them into your app/src/main/jniLibs directory.
  2. Ingenico device requires USB access, to do this :

    1. Create a new file under res/xml folder called device_filter.xml

      <?xml version="1.0" encoding="utf-8"?>
<resources>
    <!-- INGENICO-->
    <usb-device vendor-id="1947"/>
    <usb-device vendor-id="2816"/>
    <usb-device vendor-id="4096"/>
</resources>

    2. Add the following contents into AndroidManifest.xml file

      <intent-filter>
    <action android:name="android.hardware.usb.action.USB_DEVICE_ATTACHED" />
</intent-filter>
<meta-data android:name="android.hardware.usb.action.USB_DEVICE_ATTACHED" android:resource="@xml/device_filter" />

Done! With your ENVIRONMENT properly configured you are now ready to perform your first sales transaction. Check out the Coding 101 section for more information.

Axium Platform

Axium platform is different as the application, with the GoChip integration, will run on the device itself.

Please refer to the Axium Debug Unit Installing Firmware and Configuration Files.pdf file from here on how to configure an Axium debug unit.

Need further assistance?

Please check our Device Configuration section in the Support menu.