RevKeen Docs

Installing the Connector

Download, install, and link the RevKeen Terminal Connector to your account

The RevKeen Terminal Connector is a desktop application that bridges your PAX terminal to RevKeen Cloud. It runs on your computer and communicates with the terminal over your local network.

What you'll learn
  • How to download and install the connector for Windows and macOS
  • How to link the connector to your RevKeen account
  • How to pair a PAX terminal
  • How to set up multiple terminals
  • How auto-updates work
~ min

System Requirements

PlatformRequirements
WindowsWindows 10 or later, x64 processor
macOS (Apple Silicon)macOS 12 Monterey or later, M1/M2/M3/M4 chip
macOS (Intel)macOS 12 Monterey or later, Intel processor

The connector must be on the same local network (LAN) as your PAX terminal.

Step 1: Download the Connector

  1. Go to Apps > Marketplace > Terminal in your RevKeen Dashboard
  2. Click Add Connector to open the setup wizard
  3. Select your operating system and click Download

The dashboard auto-detects your platform and recommends the correct download.

Downloads are served from releases.revkeen.com. The latest version is always available at the manifest URL: https://releases.revkeen.com/terminal-connector/latest.json

Installation by Platform

Windows:

  1. Open the downloaded .exe installer
  2. Follow the setup prompts and click Install
  3. Launch RevKeen Terminal Connector from the Start menu

macOS:

  1. Extract the downloaded archive
  2. Drag the app into your Applications folder
  3. Open RevKeen Terminal Connector from Applications

On macOS, you may see a security prompt the first time you open the app. Go to System Settings > Privacy & Security and click Open Anyway.

The connector needs to be linked to your RevKeen account with a one-time code.

  1. In the dashboard setup wizard, click Generate Code
  2. A 6-digit linking code will appear on screen
  3. In the Terminal Connector app, enter this code when prompted
  4. The connector will register with your RevKeen account

The code expires in 10 minutes and can only be used once. If it expires, generate a new code from the dashboard.

Once linked, the connector will show as Online in your dashboard. It maintains a persistent connection to RevKeen Cloud and reconnects automatically if the connection drops.

Step 3: Pair Your PAX Terminal

Once the connector is linked, it needs to discover and pair with your PAX terminal.

Before Pairing

Ensure your PAX terminal is ready:

  1. Power on the PAX A920 terminal
  2. Connect to Wi-Fi -- On the terminal, tap the three dots menu and go to Wi-Fi Settings. Connect to the same network as the computer running the connector.
  3. Open WebLink -- Launch the WebLink app on the terminal. It should display "LISTENING (READY)".

Pairing Process

  1. The connector will automatically scan your local network for PAX terminals
  2. If the terminal is found, it will appear in the connector's device list
  3. If automatic discovery doesn't find the terminal, you can enter the terminal's IP address manually (find it in the terminal's network settings)
  4. The connector verifies communication with the terminal and confirms pairing

Once paired, the terminal appears in your dashboard with a green "Online" status.

Multi-Terminal Setup

You can connect multiple terminals through one or more connectors:

  • One connector, multiple terminals -- A single connector can pair with multiple PAX terminals on the same network
  • Multiple connectors -- Install the connector on different computers (e.g., at different locations) and link each one to the same RevKeen account

When initiating a payment, you select which terminal to send it to. Each terminal is identified by its serial number and any custom name you've assigned.

To add another connector:

  1. Go to Apps > Marketplace > Terminal in the dashboard
  2. Click Add Connector
  3. Repeat the download, install, and linking process

Auto-Updates

The Terminal Connector checks for updates automatically. When a new version is available:

  • The dashboard shows an "Update available" banner with the new version number
  • You can click Update next to each outdated connector to push the update
  • The connector downloads and installs the update, then restarts automatically

Updates cannot be pushed while a payment is in progress. Wait for any active payments to complete before updating.

You can also trigger updates from the dashboard Terminal settings page by clicking the update button next to any outdated connector.

Troubleshooting Connection Issues

IssueSolution
Connector shows "Offline"Ensure the connector app is running and your computer has internet access
Terminal not found during pairingVerify the terminal and computer are on the same Wi-Fi network. Check that WebLink is running and shows "LISTENING (READY)"
Linking code expiredGenerate a new code from the dashboard
"Cannot reach terminal" errorCheck firewall settings -- the connector needs to reach the terminal's IP on the local network

For more help, see the Troubleshooting page.

Next Steps

On this page