Skip to main content

Setting up the Ingenico iSelf for TCPIP

Updated

Table of Contents

  1. Overview
  2. Ingenico RBA Setup
  3. Ingenico RAM Setup
  4. Configuring the Payment Device SDK Server config file

 

Overview

This article explains how to setup and configure the Ingenico iSelf RBA and RAM models for connection via Ethernet.

Please note that before you start you will need to put the device in maintenance mode - please refer to this article here to carry this out.

 

Ingenico RBA Setup

Once you have put the device into maintenance mode, please perform the following steps to configure the RBA variant of the Ingenico iSelf for connection over Ethernet. It's a good idea to have the IP address for the iSelf device, the subnet mask, gateway IP, and port ahead of time.

  1. Select TDA
  2. Select Configuration
  3. Select Communication
  4. Select Comm. Type
  5. Select Ethernet
  6. Press yellow to go back
  7. Select Ethernet Settings
  8. Select Connection Method
  9. Select Server, press green to confirm
  10. Press yellow to go back
  11. Select DHCP
  12. Select Static, press green to confirm
  13. Press yellow to go back
  14. Scroll to IP Address and enter a valid static IP address for the iSelf device
  15. Press yellow to go back
  16. Scroll to Subnet Mask and set a valid subnet mask – usually 255.255.255.0
  17. Press yellow to go back
  18. Scroll to Gateway and enter a valid gateway IP
  19. Scroll to IP Port and enter a valid IP port (default is 12000)
  20. Press yellow to go back
  21. Scroll to SSL, ensure it is disabled
  22. Press yellow to go back 4 times
  23. When prompted say yes to saving changes by pressing green
  24. Power cycle the device to restart

 

Ingenico RAM Setup

Once you have put the device into maintenance mode, please perform the following steps to configure the RAM variant of the Ingenico iSelf for connection over Ethernet. It's a good idea to have the IP address for the iSelf device, the subnet mask, gateway IP, and port ahead of time.

  1. Press * to access the maintenance menu
  2. Scroll to RA1, press green to confirm
  3. When prompted, enter the device pin (please contact the manufacturer or device distributor if you do not have this), press green to confirm
  4. Scroll to Comms Method, press green to confirm
  5. Select TCP/IP, press green to confirm
  6. Press yellow to go back
  7. Scroll to TCP/IP Settings, press green to confirm
  8. Select Local Port and enter a valid IP port (default is 87), press green to confirm
  9. Press yellow to go back
  10. Select SSL, ensure it is disabled, press green to confirm
  11. Press yellow to go back
  12. Select to Assignment and select Static, press green to confirm
  13. Press yellow to go back
  14. Scroll to IP Settings, press green to confirm
  15. Select IP address and enter a valid static IP address for the iSelf device, press green to confirm
  16. Select Subnet Mask and enter a valid subnet mask – usually 255.255.255.0, press green to confirm
  17. Select Default Gateway and enter a valid gateway IP, press green to confirm.
  18. Primary and Secondary DNS do not need to be configured if configured on the gateway, and are optional
  19. Press yellow to go back 3 times
  20. Power cycle the device to restart

 

Configuring the Payment Device SDK Server config file

Please take note of the following changes within the Payment Device SDK config file:

  • Model tag needs to be updated to correctly reflect the Ingenico iSelf model in-use:
    • Ingenico-iSelf-RBA
    • Ingenico-iSelfLE-RBA
    • Ingenico-iSelf-RAM
  • Add the ID of the Ingenico iSelf (serial number) as documented in the Integration Guide.
  • Protocol tag needs to be set to tcpip.
  • Address tag needs to be added and must match the IP address defined in the configuration of your PIN pad.
  • Port tag needs to be set to the value that matches the TCP/IP port number defined in the configuration of the PIN pad. By default this is 12000 for the RBA variant, and 87 for RAM.
  • If you are changing the config file over from Serial to Ethernet, the following tags are not needed for Ethernet: Baudrate, Parity, Stopbits, Databits.
  • Save the file.

 

Example config:

<?xml version="1.0" encoding="utf-8"?>
<ChipDnaServer version="1.0.0">
    ...
    <Terminals>
        <Terminal>
            ...
            <PaymentDevices>
                <PaymentDevice>
                    <Model>Ingenico-iSelf-Model</Model>
                    <Id>012345678</Id>
                    <Protocol>tcpip</Protocol>
                    <Address>10.10.10.1</Address>
                    <Port>12000</Port>
                    <StandbyMessage>Standby Message</StandbyMessage>
                </PaymentDevice>
            </PaymentDevices>
        </Terminal>
    </Terminals>
    ...
</ChipDnaServer>