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 > Running A Sales Transaction With Pin Debit
Running A Sales Transaction With Pin Debit
print icon

At KlickTrack, we know that ensuring smooth and efficient transactions is crucial to providing a positive customer experience. As such, in this article, we will go over step-by-step instructions on how to run a sales transaction with a Pin Debit terminal, ensuring that you can efficiently process debit card payments to keep your business running smoothly.


You can quickly jump to a specific section of this article by using the links below:

  1. Enabling Pin Debit as a payment method
  2. Running a sales transaction with Pin Debit
  3. Canceling the transaction 
  4. Troubleshooting sales transactions
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 version 2.20.16 and higher.

You must connect the terminal and register first before running a sales transaction.



Enabling Pin Debit as a payment method

Before you can run sales with Pin Debit, you need to enable the payment type in the App Settings.


  1. From the register or back office, click the 3-dot nav to open the App Controls panel.

  2. Select “App Settings” from the Hardware Shortcuts section of the panel.
  3. Under “Register Settings > Sales,” toggle on the Pin Debit payment type.

  4. Press Save

Pin Debit will now appear as a tender type option on the register payment method screen.


 ​​​​Surcharges and convenience fees

▪  Please note that Hypur does not recommend setting a surcharge for Pin Debit payments.

▪  If you decide to add a surcharge, make sure that the convenience fee amount set in your merchant portal matches the surcharge amount you set in KlickTrack, or you will end up with reporting discrepancies between the two.



Running a Sales Transaction with a Pin Debit Terminal

Step 1: Select Pin Debit at the register

On the register payment method screen, select Pin Debit.


Step 2: Terminal Selection

  • If you are a dispensary with multiple pin debit terminals set up, select the terminal you want to use for this transaction.
  • If you only have one terminal set up, the system will use it by default.

Step 3: Sales transaction information is sent to the terminal

Once a terminal is selected, several things will occur:

  • The register will connect to the terminal and send the sales transaction information.
  • You will be driven to an interim payment holding screen.

Step 4: Customer enters their debit card information

Switch to the terminal and have the customer tap, swipe or insert their card.

  • You can also enter the card information manually by pressing the “Enter card” button on the terminal.

Step 5: Processing the payment

The terminal will send the information to the payment processor.

Step 6: Confirmation sale is approved or declined

The terminal will receive an approval or declined response from the payment processor.

 If the payment is approved 

  • The terminal will show a success screen.
  • The KlickTrack user will be directed to the Sale Complete screen.
  • The transaction receipt will be printed.
Important Note
This receipt will contain all of the necessary references you need to marry up the information in your Spin portal with your KlickTrack reports, including the 24-digit Spin transaction ID. You can also find the transaction ID on the sale modal.


 If the payment is declined 

  • The terminal will show a declined screen

  • The KlickTrack user will be directed to the Payment Method screen and shown an error message.



Canceling a Sales Transaction

All sales transactions must be canceled from the terminal. If you need to cancel a sales transaction, you can do so before the transaction is sent to the payment provider for approval:


  1. On the terminal, press the yellow back button on the sale screen
  2. Then, confirm the cancellation by clicking the green button on the "Abort Transaction?" terminal modal


  1. Once you confirm the cancellation on the terminal, KlickTrack will pop an alert that lets you know that the transaction has been manually canceled. Click "OK" on the alert to return to the payment method screen.


Pro Tip:
Pressing the “Close” button on the KlickTrack interim payment holding screen will close the page, but it will not cancel the transaction in the terminal. The terminal will continue to wait for you to take action until it times out after 120 seconds of non-activity.

Therefore, we highly recommend that you cancel the transaction via the payment terminal rather than the Klicktrack interim payment holding screen so that you do not block the terminal from accepting another transaction.



Troubleshooting Sales Transactions

In this section, we’ll go over common errors and issues that could occur during the sales transaction process and provide you with information on how to quickly resolve these issues so that you minimize any potential downtime and ensure that your transactions continue to run smoothly.


Pro Tip
The information below covers common issues related to sales transactions, but other errors can occur. If you can't find your issue below, please check out our "Troubleshooting Pin Debit" article, which covers a broader array of potential errors. 


Error Message Overview

Error Message Potential Cause & How to Resolve

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 or the register 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




Terminal in Use

Potential Cause

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

  • The terminal not on 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.

If this error was received after a manual cancelation and no cancelation message was shown in KlickTrack:


This error is rare but can occur if the terminal cannot receive a response from Spin on the cancelation request. The terminal interface will resolve, but the server believes it is still processing the request, so no response is sent to KlickTrack. This error is generally the result of an issue with Spin.


How to Resolve

  • Check that the terminal is on the idle screen. When idle, the terminal screen will say “listening for transaction.” OR
  • Wait for the terminal to finish the previous request before trying to connect again. OR
  • Select a different terminal from the Payment Method screen.
If this error was received after a manual cancelation, check to make sure that your register and terminal are connected to Spin. 

Please Note: Step-by-step instructions for verifying your connection can be found in the "Other Potential Errors > Lack of connection to Spin" section of our Pin Debit Troubleshooting article.
This Transaction has Timed 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 causes of the time out:

  • User did not take the required action on the terminal before the default time-period expired.

  • The terminal lost connection to the internet.
  • The terminal lost power at some point during the transaction.
  • The terminal did not receive a response from the payment provider in time

How to Resolve

  • Check that you have a stable internet connection and that both your terminal and register are connected.

  • Check to make sure that your terminal is connected to a power source.

  • Turn the terminal off and turn it back on again.

  • Make sure to complete any required steps on the terminal before the default time-period expires.

  • If none of the above provide error resolution, we recommend contacting Spin support to assess if there is an issue on their side.

Invalid Reference ID




Request cannot be completed

Potential Cause:

This error can occur if the sale request was processing when it was interrupted or encountered an error for whatever reason (i.e., the internet connection dropped, the terminal powered down, etc.)


How to Resolve: 

  1. First, return to the cart, remove one product and then re-add it. This will generate a new Reference ID that can be sent through to Spin.
  2. Then, try the sales transaction again. 
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