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:
- Adding a new Pin Debit terminal
- Editing a terminal
- Deleting a Terminal
- Troubleshooting a Terminal Connection
- 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
- Tap the blue plus-sign button to create a new terminal.
- In the “Create Terminal” modal, enter the below information and then click save.
- Terminal Name
- Register ID
- Auth Key
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"
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.
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
- Click on the blue pencil icon to the right of the terminal name.
- In the “Edit Terminal” modal, update the terminal information (as applicable).
- Click Save
- Upon saving, the register will send a connection request to the terminal. When prompted, confirm the connection on the terminal.
- Once the connection is successfully established, a green save banner will appear at the top of the page.
- The edited terminal is now saved to the page with the updated information.
Deleting a Terminal
- Select the red trash can icon to the right of the terminal name.
- A warning will pop up that asks you to confirm that you wish to delete this terminal.
- Click “Confirm” on the warning to proceed with terminal deletion.
- 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.
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
OR
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
|
Payment Terminal Not Found
OR
Register not found |
Potential Cause The terminal is not active and/or cannot be found. This could be due to the following:
How to Resolve
|
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:
How to Resolve
|
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:
How to Resolve
|
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
|