Processing Payments
This guide explains how everyday card payments work between the Aztec POS and your Dojo devices, and what to do if a payment does not complete. It applies to ZCPS Dojo 1.3.8 and later.
For device faults, declined cards or anything shown on the Dojo device itself, please contact Dojo directly
Device & Technical Support:
0800 044 3550 | Monday to Sunday 08:00 - 23:00
For POS buttons, configuration and anything shown on the POS terminal, contact Zonal Support.
Processing Payments Topics
Before You Start
Payments will only reach a Dojo device when all of the following are true:
-
The device is switched on, connected to Wi-Fi (or 4G) and showing its home screen
-
Pay at Counter is enabled on the device (burger menu | Settings | Integrated Payments, supervisor code required)
-
The device has been mapped to a POS PIN pad, as described in the Setup & Installation Guide
-
The card payment button on the POS allows tips. Dojo requires this even if you do not take tips; without it the POS will refuse to send the payment
Taking a Payment at the Counter
-
On the POS, ring in the sale | tap Pay | tap the Card payment button
-
If prompted, select the Dojo device that will take the payment, then confirm the amount
-
The POS shows Connecting to Dojo... and the device wakes up with the payment
-
If tips are enabled on the device, the customer chooses a suggested tip, enters a custom tip or skips
-
If charity donations are enabled, the customer is offered a donation to Pennies, then asked to present their card
-
The customer taps (contactless), inserts (chip & PIN) or, from the device's bottom menu, chooses Swipe transaction
A swiped card needs a signature. The device prints a signature slip and the POS asks you to Accept or Decline it. Declining cancels the payment and leaves the account open. -
When the payment is approved the device offers Get receipt and Done. Tap Done
-
The POS shows the approval, records the tip, cashback and donation amounts taken on the device, and closes the account
Tips, Cashback & Charity Donations
Tips are always prompted on the Dojo device, never on the POS. Suggested percentages, custom amounts and whether the prompt appears at all are set on each device (burger menu | Settings | Gratuity Values or Tipping). The tip is added to the card payment and shown on the POS as a separate tip amount.
Cashback is prompted on the POS before the card is presented, and only when cashback is enabled in Aztec and on the device (Settings | Payments | Pay at Counter | Offer cashback). From Aztec 3.33 the POS can have two card buttons: EFT, which prompts for cashback, and No Cashback, which skips the prompt.
When a cashback amount is entered the customer must insert their card and enter their PIN. Contactless and swiped cards are not accepted, and the device will not offer a tip or a donation on that payment.
If the card does not support cashback the device shows an invalid cashback card message. Cancel and take the payment again without cashback.
Charity donations to Pennies are available from ZCPS Dojo 1.3.8 for counter and table payments. Once Zonal has enabled charity donations for your estate, the device offers the donation after the tip prompt. The donation is returned to the POS and shown on the customer's receipt.
Pay at Table
Pay at Table is driven entirely from the Dojo device. The table must have been saved on the POS first.
-
On the device tap Settle Table
-
Enter your POS PIN as the waiter ID and tap Continue. Only tables the PIN is allowed to see are listed
-
Select the table. The table is now locked on the POS until the payment finishes or times out
-
Choose Pay in Full, Equal Split or Custom Split. Print Bill is also available on some devices
-
The customer adds a tip and donation if offered, then presents their card
-
Tap Done. The table is paid off on the POS and your PIN is released
A table picked up on a device is held for 20 minutes by default. If it is left on the device longer than that, the lock is released and the payment should be started again rather than completed from the old screen.
Use one POS PIN per device at a time. Settling tables with the same PIN on two devices at once can duplicate a payment.
Refunds & Reversals
Refunds are started on the POS in the usual way and sent to a Dojo device. The customer presents the card the refund is going to and the device confirms the refund. The amount refunded is whatever the POS sent; a refund cannot be altered on the device.
Reversals of a Dojo card payment (voiding a payment taken earlier in the day) are processed by Dojo as a refund of the full original amount, including any tip, cashback and donation, back to the same card. The POS shows Reversing payment... and the customer will normally need to present their card on the device again.
A reversal must be for exactly the amount originally taken and the original payment must have been successful. Partial reversals are not supported; use a refund for part of a payment.
If the device that took the original payment is switched off, the POS asks you to select another device for the reversal.
Pre-authorised Bar Tabs
Where enabled by Zonal, a card can be validated on a Dojo device when a tab is opened, so the balance can be collected later. The POS sends a small validation payment (for example £1.00) to the device and the customer inserts their card and enters their PIN. When the tab is settled, the POS prompts for the same card and the final amount is captured without the customer needing to be present. If the customer leaves without paying, the Walkout button on the POS collects the outstanding balance from the validated card.
Receipts
The Dojo device offers the customer a printed or emailed receipt at the end of every payment and refund, so POS card receipts are not printed by default. This avoids the duplicate receipts that some devices produced on earlier versions.
If you use Dojo devices without a printer, or you post card payments to rooms through a PMS integration, ask Zonal Support to turn POS receipt printing on. It can be enabled for the whole site or for individual devices.
If a Payment Does Not Complete
The POS reports the following messages when a payment cannot be sent or its result is not received. In every case, check the Dojo device before taking the payment again so the customer is not charged twice.
| POS message | What it means and what to do |
|---|---|
| Select a TID to use |
The POS PIN pad is not yet linked to a Dojo device. Choose the Terminal ID shown on the device's summary slip. Make the same choice on the next payment within ten minutes to save it. |
| TID ... is not available |
The device linked to this PIN pad is switched off, not on Wi-Fi, or not registered with Dojo. Check the device and try again. If a replacement device has arrived, follow the TID Swap Guide: after three attempts within a minute the POS offers to re-map the PIN pad to the new device. |
| Pin pad ... has status BUSY |
The device is already handling a payment, or is sitting on a screen other than the home screen. Finish or cancel what is on the device, return it to the home screen and try again. |
| Check device has cashback enabled! |
A cashback amount was entered on the POS but the device does not offer cashback. Either enable Offer cashback on the device or take the payment again without cashback. |
| Timed out awaiting payment result |
The customer did not complete the payment on the device in time. The device should return to its home screen. Check it has not approved the payment, then send the payment again. |
| Lost connection to Dojo - check PED has not processed payment |
The site lost its internet connection for more than about 90 seconds while the payment was in progress. The device may still have approved the payment. Check the device's transaction history before deciding whether to take the payment again, and contact Zonal Support if the account and the card do not match. |
| Payment unsuccessful / Refund unsuccessful |
The card was declined or the customer cancelled on the device. The account stays open. Try another card or payment method. |