You are using an unsupported browser. Please update your browser to the latest version on or before July 31, 2020.
Home > 2. Using the Register > 3. Pin Debit Payment Method > Connecting a Pin Debit terminal to a Register
Connecting a Pin Debit terminal to a Register
print icon

In this guide, we will provide you with step-by-step instructions on how to connect a Pin Debit terminal to your register device, ensuring that you can process debit card payments with ease.


You can quickly jump to an article section using the links below:

  1. Adding a new Pin Debit terminal
  2. Editing a terminal
  3. Deleting a Terminal
  4. Troubleshooting a Terminal Connection
Before you start
- Dispensaries interested in offering Pin Debit as a payment option must first sign-up with Hypur.
- Pin Debit is available on KlickTrack app versions 2.20.16 and higher.


Adding a new Pin Debit terminal

Step 1: Access the payment terminals page

  • In the KlickTrack back office, scroll down to the Hardware Management section and click on the new Payment Terminals page.

Step 2: Enter the terminal information

  1. Tap the blue plus-sign button to create a new terminal.
  2. In the “Create Terminal” modal, enter the below information and then click save.
    1. Terminal Name
    2. Register ID
    3. Auth Key
The Register ID and Auth Key are found in your Spin merchant portal. These IDs were generated by Spin when they configured your terminal(s).

Step 3: Register tries to establish a connection to the payment terminal

  • Once you press “Save” on the Create Terminal modal, the register will attempt to connect to the specified payment terminal.

Step 4: Confirm the connection on the terminal

  • Once the connection between the register and your terminal hardware is established, you will be asked to confirm the register connection on your Pin Debit payment terminal.
    • On the terminal, press "Connect" and then "OK"


Pro Tip
If a connection error occurs, a red error message will display on the KlickTrack page.

If the issue is due to terminal configuration (i.e. the auth key or register ID are incorrect), then the error message will give you the option to add the terminal to the page even though it’s not connected to the register. Please check out the Troubleshooting section below to learn more.

Step 5: Successful Connection

  • Once the connection is established, you will see a green success message at the top of the Payment Terminals page.

  • The newly created payment terminal should now be visible on the Payment Terminals page.


Pro Tip
You can quickly tell which terminals are actively connected and which are currently inactive via the icon on the left-hand side of the terminal name.
 Active terminals have a green circle icon
▪ Inactive terminals have a red cloud-slash icon


Editing an existing terminal

  1. Click on the blue pencil icon to the right of the terminal name.
  2. In the “Edit Terminal” modal, update the terminal information (as applicable).
  3. Click Save
  4. Upon saving, the register will send a connection request to the terminal. When prompted, confirm the connection on the terminal.
  5. Once the connection is successfully established, a green save banner will appear at the top of the page.
  6. The edited terminal is now saved to the page with the updated information.

Deleting a Terminal

  1. Select the red trash can icon to the right of the terminal name.
  2. A warning will pop up that asks you to confirm that you wish to delete this terminal.

  1. Click “Confirm” on the warning to proceed with terminal deletion.
  2. The terminal is now deleted and no longer available to use for register transactions. You should no longer see the terminal listed on the Payment Terminals page.

Troubleshooting a Terminal Connection

We know that experiencing issues with your Pin Debit terminal and register POS connection can be frustrating, which is why we've compiled a list of common connection errors to help you identify and resolve any connection issues quickly and effectively.


 Pro Tip
All terminal connection errors allow you to edit your information OR add the terminal to your list of payment terminals as an inactive device.


Error Message Potential Cause & Resolution Steps

A configuration issue has occurred 




Terminal Configuration Error

Potential Cause

The terminal and register cannot establish a connection due to an incorrect auth key and/or register ID.


How to Resolve

  • Review the terminal information in your Spin iPOSpays merchant portal.
  • Update the auth key and/or register ID in KlickTrack.

Payment Terminal Not Found




Register not found

Potential Cause

The terminal is not active and/or cannot be found. This could be due to the following:

  • The terminal is not connected to the internet.

  • The terminal is not powered on.

  • The terminal is broken or experiencing some level of hardware failure.

How to Resolve

  • Check that the terminal is powered on and has a stable internet connection.
  • Turn the terminal off and then back on again.
  • If the terminal appears to be broken, please contact Spin support for the next steps in replacing a broken terminal.
Payment Terminal is currently busy

Potential Cause

The terminal is unable to receive the connection request because it is currently busy for whatever reason, including:

  • The terminal is not on the idle screen to receive the request.
  • The terminal is busy processing a transaction.
  • The terminal had not completed the previous request when the connection request was sent.

How to Resolve

  • Check that the terminal is on the idle screen. When idle, the terminal screen will say “Listening for the transaction.”
  • Wait for the terminal to finish the previous request before trying to connect again.

Connection time out

Potential Cause

The request was sent to the terminal, and, for whatever reason, the terminal did not respond in time. The payment terminal sends a default time-out response after 120 seconds of inactivity.


Potential reasons for a time-out error include:

  • The terminal lost connection to the internet while attempting to establish a connection.
  • The terminal momentarily lost power during the connection process.
  • Spin cannot connect at this time or experienced a momentary during the connection process.

How to Resolve

  • Check that the terminal is powered on and has a stable internet connection, then try the connection again.
  • If you receive the message a second time, try restarting the terminal device before attempting to connect again.
  • If you continue to receive this error after attempting to connect multiple times, we recommend reaching out to Spin support to assess if there is an issue on their side.
An unknown failure has occurred

Potential Cause

Unknown failures can be caused by many things, including a system time-out, a dropped internet connection during the connection process, a momentary hardware error, etc.


How to Resolve

  • Try connecting the terminal again.
  • If you receive this error a second time, we recommend using the resolve steps above, such as checking to ensure your internet is not experiencing an outage, restarting your device, etc.
Did you find this article helpful?
0 out of 0 found this helpful

scroll to top icon