Dojo UK Card Payments Interface for QUORiON POS System

This blog outlines the necessary steps and information for configuring the Dojo UK card payments interface on QUORiON POS systems running QMP 2.0 POS software in the UK.

Here are the main themes and most important ideas/facts:

1. Purpose and Scope of the Dojo UK Card Payments Interface:

• Functionality: The Dojo interface enables the operation of card payment terminals using the Dojo Pay-at-Counter interface with QUORiON POS systems (QMP 2.0 software).
• Key Capabilities: It facilitates "automatic transfer of the payment amount from the POS to the terminal and provides feedback on the success or cancellation of the payment process." It also supports "Special functions such as tipping, cancellations and returns."
• Connectivity: Communication between the POS and the terminal relies on an Internet connection established via "a fixed LAN cable or wireless WLAN to your router."
• Limitations of the Guide: This document specifically focuses on configuring the Dojo interface on QUORiON POS systems and "does not contain any instructions for configuring the card terminal itself" or "detailed instructions for setting up the Internet connection." Users are advised to contact their IT technician or terminal supplier for these external configurations.
• Applicable Models: The guide applies to various QUORiON device types, including INViCTUS, QTouch 9/11/16, QTab 9, QOrder, and QMP60/6000, all from specific software versions (e.g., QTouch_241002_v2.25.12).

2. Essential Configuration Steps:

• Licence Activation (Chargeable): To enable the Dojo interface, a "licence activation subject to a charge" is required on the POS system. This involves obtaining a license code from a QUORiON specialist dealer after noting a "K code" from the POS system's settings (Menu > Settings > Add-On Activation > EFT1 Activation).
• Network and Terminal Settings (External to Guide): A "functioning LAN/WiFi network is essential." It's "advisable to assign a fixed IP address to the terminal." The "Dojo Pay-at-Counter protocol should be selected on the terminal."
• QMP Settings (Using QUORiON Software Configurator - QSC): All necessary QMP configurations for the Dojo interface must be done using the "QUORiON Software Configurator (QSC) on a PC," as "A direct programming in P mode on the POS system is not possible." The general procedure involves opening/loading the POS system's configuration in QSC, making changes, then saving and sending the modified configuration back to the POS system.
• Drawer Totals: A new drawer total, typically named "Tip," needs to be created to "store all tip amounts for reporting" when using the Dojo gratuity/tip function.
• Payment Types (Tenders): The "Card" payment type needs to be linked to the newly created "Tip" drawer function (under "Over Tender") and assigned to "[EFT Terminal 1]" in the "EFT Terminal" list.
• Device Configuration: An "EFT-Terminal" device must be added under Hardware Configuration.
• General Settings: Select "[Network Connection]" as the connection type. Standard IP/Domain is "127.0.0.1" and Port Number is "9100."
• EFT Settings: Crucially, set the "EFT Type" to "[UK–Dojo Web]". The "User Name" and "User Password" fields require the "individual terminal name of your Dojo terminal" and "individual terminal password (API Key) of your Dojo terminal," respectively. The "Response Timer" defaults to 300 seconds.
• Cash Register Settings: The created "EFT-Terminal" must be selected in the "EFT 1" list within the Cash Register Settings for the desired POS system.

3. Operational Functions:

• Normal Payment: Pressing the configured card payment button transfers the amount to the terminal. The POS waits for a response (default 60 seconds). Success finalizes the sale; errors keep the sale open.
• Refund Payment: Negative amounts can be processed similarly to normal payments. Pressing the card payment button after a return booking will transfer the negative amount for an automatic refund.
• Tip/Gratuity: Tips can be added directly at the Dojo terminal. The POS system automatically records the payment amount and tip separately for reporting, provided a "Drawer Total to store the tip amount for reporting" is defined (as per section 3.2.1). No special settings on the cash register are needed beyond this.

4. Troubleshooting:

• The guide provides a list of common error messages and their solutions:
• E06 Invalid Function: Occurs if a card transaction is initiated without an activated license. Solution: Activate the EFT1 license.
• - Enter Code ?: Appears if EFT1 activation is attempted after it's already active. Allows deactivation code entry; tap display to close.
• E52 Declined/Canceled: Transaction declined/canceled by the terminal. Solution: Try again or use cash payment.
• E52 Comm. to PDQ failed/Error EFT: Communication failure/timeout with the card terminal or internet connection issues. Solution: Check internet/network connection and try again, or use cash payment.

FAQs - Dojo UK Card Payments & QUORiON POS

1. What is the Dojo UK card payments interface for QUORiON POS systems?

The Dojo interface enables QUORiON Point of Sale (POS) systems, running on QMP 2.0 software, to operate card payment terminals using the Dojo Pay-at-Counter interface. This integration facilitates automatic transfer of payment amounts from the POS to the terminal and provides feedback on payment success or cancellation. It also supports special functions like tipping, cancellations, and refunds. Communication between the POS and the terminal occurs via an internet connection (LAN or WiFi).

2. Which QUORiON POS system models and software versions are compatible with the Dojo interface?

The Dojo interface is compatible with various QUORiON POS system models and requires QMP 2.0 software. The supported device types include INViCTUS, QTouch 9, QTouch 11, QTouch 16, QTab 9, QOrder, and QMP60 / 6000. For specific software versions, INViCTUS, QTouch 9/11/16, and QTab 9 require version QTouch_241002_v2.25.12 or newer. QOrder requires version QOrder_241002_v2.25.12 or newer, and QMP60 / 6000 requires version K4A241002_v2.25.12 or newer.

3. How do I activate the Dojo interface license on my POS system?

To activate the Dojo interface, your POS system needs a charged license. First, press the Menu button, then navigate to "Settings" -> "Add-On Activation" -> "EFT1 Activation." Take note of the displayed code number (K code) and request the corresponding license code from your authorized QUORiON specialist dealer. Finally, enter the received license code into the input mask and confirm by pressing the Enter button. A "Activated" message confirms successful activation.

4. What are the key configuration steps for integrating the Dojo interface with QUORiON POS systems?

Configuring the Dojo interface involves several crucial steps, primarily done using the QUORiON Software Configurator (QSC) on a PC, as direct programming on the POS system is not possible. Key steps include:

Network and Terminal Settings: Ensure a functioning LAN/WiFi network with a fixed IP address for the terminal. The Dojo Pay-at-Counter protocol must be selected on the terminal.
QMP Settings (using QSC):Drawer Totals: Create a new drawer total, typically named "Tip," to store gratuity amounts for reporting.
Payment Types (Tenders): Link the "Card" payment type to the newly created "Tip" drawer function and select "[EFT Terminal 1]" for the EFT Terminal setting.
Device Configuration: Add a new device of type "[EFT-Terminal]," set the connection type to "[Network Connection]," and input the terminal's IP/Domain (default 127.0.0.1) and Port Number (default 9100). Crucially, in the EFT Settings tab, select "[UK–Dojo Web]" for EFT Type, and enter the individual terminal name (User Name) and API Key (User Password) of your Dojo terminal.
Cash Register Settings: Select the previously configured EFT-Terminal name from the "EFT 1" list for your specific POS system. After all settings are complete, save the modified configuration in QSC and send it to your POS system.

5. How are normal payments, refunds, and tips handled through the Dojo interface?

The Dojo interface streamlines various transaction types:

Normal Payment: Simply press the configured button for card payment on the POS. The amount is automatically transferred to the terminal. The POS waits for a response (usually 60 seconds), and if successful, the payment is processed. If there's an error, an error message appears, and the sale remains open, allowing for re-attempts or cash payment.
Refund Payment: Refunds (negative amounts) are processed similarly to normal payments. After entering the return booking, pressing the card payment button transfers the negative amount to the terminal for automatic refund processing.
Tip/Gratuity: Tips can be added directly at the Dojo terminal. The payment process starts as usual from the POS, and a prompt for a tip appears on the card terminal. Both the payment amount and the tip entered at the terminal are recorded separately in the cash register, provided a "Drawer Total" for tips has been defined in the POS configuration.

6. What types of error messages might occur when using the Dojo interface, and how can they be resolved?

Common error messages and their solutions include:

E06 Invalid Function: This indicates the card transaction was initiated without an activated license. The solution is to activate the EFT1 license as per the license activation instructions.
"Enter Code ?": This appears if you try to reactivate an already activated EFT1 license. You can enter a code to deactivate it, or simply tap the operator display area to close the message if deactivation is not intended.
E52 Declined: The card payment was declined by the terminal. Users should try again or finalize the transaction with cash.
E52 Canceled: The card payment was canceled by the terminal. Users should try again or finalize the transaction with cash.
E52 Comm. to PDQ failed: Communication with the card terminal failed due to a timeout. Check the internet connection and try again, or close the transaction with cash.
E52 Error EFT: Communication to the internet failed, meaning the card terminal could not be reached. Check your network and internet connection and try again, or close the transaction with cash.

7. What is the "Over Tender" setting in the payment types configuration, and why is it important for the Dojo interface?

In the context of configuring payment types (tenders) for the Dojo interface, "Over Tender" refers to how any amount exceeding the initial transaction total is handled. When linking the "Card" payment type to Dojo, the "Over Tender" setting is used to associate it with the "Tip" drawer function. This is crucial because it ensures that any gratuity or tip amount entered on the Dojo terminal (which is "over" the base transaction amount) is correctly recognized and stored separately in the designated "Tip" drawer total for accurate reporting and financial tracking within the QUORiON POS system.

8. Who should I contact for technical problems with the product or questions regarding network/terminal configuration?

For technical problems related to the QUORiON product itself, you should contact your authorized dealer directly. For specific questions concerning the configuration of the card terminal, such as its internal settings or WiFi registration, you should reach out to the supplier or manufacturer of the card terminal. Similarly, if you have questions about setting up the internet connection via LAN/WiFi network or router configuration, it is recommended to contact your IT technician.