1. Legacy
  2. Evosus Card Services

Install RCM

The OpenEdge Remote Client Manager (RCM) software handles the communication between the credit card reader and OpenEdge. RCM must be installed on every workstation that is attached to a card reader.


How does the communication work?

  1. Evosus requests an OpenEdge payment form.
  2. The OpenEdge payment form wakes up the RCM.
  3. RCM communicates with the card reader terminal to capture the payment card information.
  4. RCM submits the transaction to the OpenEdge Gateway.
  5. OpenEdge Gateway returns a response to the RCM.
  6. RCM notifies the OpenEdge payment form that the transaction is completed.
  7. Evosus retrieves the transaction response from the OpenEdge Gateway.


Install RCM
Follow the steps below to install RCM on a workstation.

For example, follow these steps if you have a workstation attached to a cash drawer that is used to accept customer payments.

  1. Install Microsoft Message Queuing (MSMQ) (All options, including HTTP Support)
    1. For local installations, MSMQ needs to be installed on every machine where the RCM is directly installed. See the Microsoft documentation for information on installing MSMQ on workstations.
  2. Connect the card reader terminal to the workstation
    1. Attach the Ingenico iPP320 to the workstation.
  3. Install RCM
    1. Only use the .exe installer since the .msi installer is an alpha version and has some issues.
  4. Start RCM
    1. Double click on the RCM on your desktop or select Start > Startup > RCM.
    2. The RCM icon appears in the system tray.
  5. Configure port. This only applies when multiple users are accessing the same RCM installation.
  6. Device configuration
    1. Right click on the RCM icon  in the system tray.
    2. Select Device Configuration from the menu that appears.
    3. Select Ingenico iPP320 (US EMV) in the PIN Pad Device drop down.
    4. COM Port - Select the COM port used by the device. This port must be unique to this device (it cannot be shared with other devices).
    5. Default Message - Message that appears on the credit card terminal. This must be 30 characters or less.
    6. Click Test. This tests the communication between the RCM and the card reader terminal.
    7. Click Load Forms to Device. Loading the forms to the device can take several minutes and the process should not be interrupted.
    8. Click Load Settings to Device. Loading the settings to the device can take several minutes and the process should not be interrupted.
    9. Click OK when complete.
  7. Configure USB devices to always be powered on The card reader terminal is powered by the workstation using the USB drive. It is important to set up the workstation so that it provides consistent power to the card reader terminal.
    1. Open Device Manager.
    2. Expand Universal Serial Bus controllers.
    3. For each USB Root Hub device listed:
      • Right-click on USB Root Hub.
      • Select Properties.
      • Under the Power Management tab, uncheck Allow the computer to turn off this device to save power.
      • Click OK.
      • Repeat for ALL USB Root Hubs listed.
    4. Open Control Panel.
    5. Select Power Options.
    6. Select Choose when to turn off the display.
    7. Select Change advanced power settings.
    8. In the Power Options window:
      • Expand USB Settings.
      • Expand USB selective suspend setting.
      • Click on Setting: Enabled.
      • Select Disabled in the drop down menu.
      • Click Apply.
      • Click OK.
      • On the Edit Plan Settings screen, click Save changes.