This article explains how to integrate your Pax A920 terminal provided by Dojo.
Last updated 03 Aug 2023
Jump to:
Introduction
This integration is designed with Dojo to connect your card machine and EPoS system through the cloud. This means that your Kobas server will send payment requests to the Dojo server via the Internet, which will then transmit them to your terminal. In other words, there is no local connection between them. Therefore, both your Kobas server and Dojo terminal require a live internet connection.
Top Tip: Did you know that you can still process transactions as "Cardholder Not Present" (CNP) when using your integration? Once the payment has been sent to the card machine, you can then press the menu button (three dots on the Dojo terminal top corner), and choose CNP.
Information required from Dojo
Before you can integrate your terminals on Kobas Cloud, you will need to contact Dojo to let them know you are setting up this integration, and ask for:
- Host Address (per account/venue)
- API Key (per account/venue)
- Instructions on how to set this up on the terminal itself
Dojo contacts (at time of publishing):
0800 044 3550 8am-6pm, Monday to Sunday
You will also need to know the Terminal ID for each of your terminals. You can view this by printing a summary at the terminal (will require supervisor code).
Kobas settings
To set up a new integrated terminal go to Administration > Venues > Venue Details and choose the PDQs tab.
Tick the box next to Paymentsense Connect, then enter the Host Address and API Key.
Click on New PDQ
Assign your terminal a name, select the make and model from the dropdown.
Next, you’ll need to assign your PDQ terminal to a till by going to the Tills tab.
Choose the till you want to connect, click Edit and scroll down to the PDQs section of the popup.
Select your Card Machine terminal from the dropdown.
Make sure you have also followed any steps needed on your terminal, and have Downloaded Data on your tills.
Top Tip: You can link more than one Card Machine to a till. The staff member will need to choose which Card Machine to use for each payment. They will be identified by the Name given in the settings above. This is a useful feature for iPads.
Your integration is now set up! You can test this by settling an order or tab by card.
Standalone PDQ Payment Type
When taking a payment on EPoS, pressing Card when the integration is active, will only trigger an integrated payment.
Therefore, you can choose to optionally accept standalone PDQ payments (ie. not processed through the integration) by ticking the relevant box in the Venue Manager.
This will create an Other Payment Type allowing you to record a card payment that wasn't created through the integration.
In your reporting, you will need to add together the Card and PDQ Stand alone lines to get your total card figure.