Skip to main content

Setting up the Ingenico Self Series for TCPIP

Updated

Table of Contents

  1. Overview
  2. Ingenico UPP 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 Self UPP and RAM models for connection via Ethernet. This includes devices such as the Self/2000, Self/4000, and Self/7000-8000

Please note that before you start, you will need to put the device in maintenance mode - please refer to this article for guidance on entering maintenance mode.

The Self/3000 does not have a “maintenance mode” in the way that the other devices do. Comms method with this device must be changed using the COMM.INI file.

 

Ingenico UPP Setup

Once the device is in maintenance mode, perform the following steps to configure the UPP variant of the Ingenico Self for connection over Ethernet. Ensure that you have the following information before proceeding with the setup steps: 1. IP address for the Self device 2. the subnet mask 3. default gateway IP 4. Port number.

The UPP instructions below will only work on firmware 7.83.19 and higher. Due to a firmware issue, the maintenance menu cannot be accessed on firmware lower than that. Comms methods can be changed by using the COMM.INI file.

  1. Boot the device into maintenance mode
  2. Press the ⦿ (circle) button
  3. Select Tetra Admin
  4. Select Communication Type
  5. Select Ethernet
  6. Press yellow to go back
  7. Select Configure Ethernet
  8. Select IP Configuration
  9. Select DHCP
  10. Select Off, press green to confirm
  11. Populate the rest of the IP settings as needed.
  12. Press yellow to go back to the Configure Ethernet menu.
  13. Scroll to Connection Type, ensure it's set to Server
  14. Scroll to SSL, ensure it is disabled
  15. Scroll to Port, ensure it is set to a value the Payment SDK is configured with
  16. Press yellow to go back 4 times
  17. When prompted say yes to saving changes by pressing green
  18. Power cycle the device to restart

 

Ingenico RAM Setup

Once the device is in maintenance mode, perform the following steps to configure the RAM variant of the Ingenico Self for connection over Ethernet. Ensure that you have the following information before proceeding with the setup steps: 1. IP address for the Self device 2. the subnet mask 3. default gateway IP 4. Port number.

  1. Boot the device into maintenance mode
  2. Press the ⦿ (circle) button
  3. Select the 'RA1' option in the maintenance menu. Enter the device password when prompted (1985 - if this password fails, contact your device distributor for confirmation of the password value)
  4. Scroll to Comms Method, press green to confirm
  5. Select TCP/IP, press green to confirm
  6. Press the yellow back button to navigate back
  7. Scroll to TCP/IP Settings, press green to confirm
  8. Select Local Port and enter a valid IP port, 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 Self 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 Self model in-use. For example:
    • Ingenico-Self-4000-RAM
    • Ingenico-Self-7000-8000-UPP
  • Add the ID of the Ingenico Self (serial number) as documented in the Payment Device SDK 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. 
  • If you are adjusting the config file from USB/Serial to Ethernet/TCPIP, the following tags are not needed for Ethernet: Baudrate, Parity, Stopbits, Databits.
  • Save the file.

 

Example config file for a Self 4000 RAM device:

<?xml version="1.0" encoding="utf-8"?>
<ChipDnaServer version="1.0.0">
    ...
    <Terminals>
        <Terminal>
            ...
            <PaymentDevices>
                <PaymentDevice>
                    <Model>Ingenico-Self-4000-RAM</Model>
                    <Id>0012345678</Id>
                    <Protocol>tcpip</Protocol>
                    <Address>10.10.10.1</Address>
                    <Port>8087</Port>
                    <StandbyMessage>Welcome</StandbyMessage>
                </PaymentDevice>
            </PaymentDevices>
        </Terminal>
    </Terminals>
    ...
</ChipDnaServer>