Documentation

Install and pair

Before starting, check that your POS machine satisfies the system requirements, then install Spice and the Gecko Bank app, and pair them together.

Suggest Edits

System requirements

Spice can only be used on POS machines that satisfy the following requirements.

Operating system Windows 10 or newer
Processor 1.6 GHz or faster (32-bit or 64-bit)
Memory 2 GB or more
Storage 2 GB or more
Internet connection Spice can operate offline; however, some features require an internet connection.

Your Spice integration will have an architecture similar to the following.

A flowchart diagram of the Spice integration architecture.

📘

See what's changed in the release notes.

Step 1. Install Spice

  1. Check that your computer satisfies the system requirements above.

  2. Download Spice from the following link.

    Spice (latest version) Download the EXE 

  3. Run the EXE file on your POS machine. It will guide you through the installation process.

📘

Note:

  • Spice is installed for the Windows user (not globally). It can be found at %APPDATA%\Spice\bins, which is C:\Users\%USERNAME%\AppData\Roaming\Spice\bins
  • When running Spice, if there is a prompt to Always ask before opening this file, disable this option. Or, if there is a prompt to Do not show this message again, enable this option.

Step 2. Get Gecko Bank

To get Gecko Bank, see the Gecko Bank guide.

Step 3. Pair Spice with Gecko Bank

'Pairing' is the way of connecting Spice to an EFTPOS terminal, allowing them to communicate. To pair Spice with Gecko Bank, do the following.

  1. Ensure your mobile phone and computer are on the same local network (e.g. the same Wi-Fi network).
  2. On your local computer, open Spice, which can be found at %APPDATA%\Spice\bins
  3. On your mobile phone, open Gecko Bank > click Menu > Manage POS pairing > click the '+' button.
  4. In Spice, on the Status tab, enter the EFTPOS terminal pairing details.
    • Payment provider — the bank that services the EFTPOS terminal. Select Gecko Demo Bank.
    • POS ID — the ID that identifies the POS machine. E.g. T1
    • EFTPOS address — the IP address of the EFTPOS terminal. Find this by looking at Gecko Bank which displays the IP address field. E.g. 192.168.0.1
    • Auto address resolution — when enabled, if the EFTPOS terminal's IP address changes (usually due to a network disconnection), Spice will try to find the new IP address automatically. We recommend enabling this, as it can fix some network issues automatically.
  5. In Gecko Bank, click Start, then in Spice, click Pair.
  6. Check that the same 'pairing code' is displayed by both Spice and Gecko Bank, then in Gecko Bank, click Yes; in Spice, click Ok; and in Gecko Bank, click Finish.
  7. If pairing succeeded, Spice's Status tab will show a 'Connected' status. Otherwise, see the frequently asked questions and troubleshooting steps.

The 'EFTPOS terminal pairing' page in Spice's UI. This shows in the 'Status' tab when no EFTPOS terminal is paired.

📘

Note:

  • When enabled, Auto address resolution is only used when the EFTPOS IP address cannot be found.
  • For advanced setups, we recommend setting a static IP address for the terminal on your router instead of using auto-address resolution. This allows automatically finding the address without an internet connection.

📘

Looking for more answers? See the frequently asked questions about EFTPOS pairing.

Having an issue with pairing? Find out how to troubleshoot a pairing issue.

Updated 4 months ago