Status: active

Revo HANDY is our all-in-one terminal. It lets you manage orders, print receipts and process payments from a single device.

1Before you start

Bank card terminal

To add Revo HANDY, the customer must request a compatible card terminal from their bank (see card terminals) and install the corresponding payment app.

Licence and devices

Adding Revo HANDY (ordering device and card terminal) counts as an extra device in the Revo XEF account.

PMS limitations

Revo HANDY does not currently support sending payments to a PMS.

Redsys

You will receive an email with the FUC number when you start the setup. Use the Redsys administration module to manage data and transactions.

If you receive the card terminal without the Revo HANDY app, follow the steps in the article Installing apps on card terminals.

2How do I set up Revo HANDY?

To use Revo HANDY, first ask your distributor to activate the corresponding licence in your Revo XEF account.

Integration setup

Once the licence is active, follow these steps to set up the integration:

  1. Open the Revo XEF back-office.
  2. Press Integrations.
  3. From the Add button, search for Handy and press Add.
  4. Fill in the basic integration settings.
Handy integration in the back-office
Handy integration settings
FieldDescription
ActiveActivates the integration in the account.
NameIdentifying name (e.g. Handy).
TestKeep it off to operate in production.
Working methodQuick sale: Lets you place orders quickly without linking them to any table.

Events: Does not ask for the employee PIN when the terminal is locked and turns off kitchen printing.
Payment gatewaySelect the gateway that will process the payments.
Payment methodsSelect the payment methods shown in the Revo HANDY app (they can differ from those in Revo XEF).
PrinterSelect the connection or printer type (the network settings appear automatically if you select a TCP/IP connection).
Payment referenceTurn it on to automatically print the payment reference on invoices.
  1. Press Save.

Setup by printer

Depending on the printer type selected in the previous step, the integration requires different details. Select your connection type to see the corresponding setup:

3How does it work?

1. Open tables and manage orders

Open tables, add products and edit orders. Our whole Revo XEF product catalogue is also available in Revo HANDY.

Managing orders in Revo HANDY
2. Quick view

The key information of every order is always at hand:

  • Table number and name.
  • Number of guests.
  • Waiter and opening time.
  • Reference, products and bill total.
Quick view of an order
3. Payment and closing from the device

Process the payment (card or cash), add a tip or split the bill (into parts or by items) and close the order directly in Revo HANDY.

Payment from Revo HANDY
4. Print receipts and payment slips

You can use the same device to print both purchase receipts and payment slips.

DOJO: The DOJO DUO terminal has a built-in printer. For the DOJO POCKET V2 you need to connect an EPSON TM-M30 or a STAR SM-S230i via Bluetooth.

Receipt printed with Revo HANDY
5. Manage take-away orders

All Revo XEF orders are available in Revo HANDY, even take-away orders, so you can manage them quickly.

Take-away orders in Revo HANDY
6. Your restaurant at a glance

View the table map with status colours, guests and sync access, or the list of open orders to manage them quickly.

Table map in Revo HANDY

Revo HANDY menu

Revo HANDY has a menu with several options for setting up and checking data. Open it by tapping the REVO r.

Revo HANDY menu

4Kitchen printing with Revo HANDY

To print Revo HANDY orders correctly in the kitchen, the Print Revo HANDY orders option must be on in the Preferences section of the REVO menu in the Revo XEF app.

Print Revo HANDY orders option in Revo XEF
Important

Products must have a course assigned; otherwise, they will not be sent to the kitchen.

  1. Go to Settings → Course in the back-office.
  2. Create or edit a course, making sure you set Automatic print type to Yes.
  3. Assign this course to the corresponding products.

5How to make order refunds in HANDY

You can refund orders paid in cash with any bank integration. For refunds of orders paid by card, the process depends on your bank:

  1. Go to the REVO r in the Handy menu and tap History.
  2. Select the order and tap the three-dot icon.
    Order options in the history
  3. Tap the Make a refund.
    Make a refund button
  4. Select the corresponding invoice and tap OK.
    Selecting the invoice for the refund

The bank's native app opens automatically on the terminal to process and complete the refund.

You can make Comercia CaixaBank refunds using the Revo XEF app. The Redsys Pinpad integration must be turned on and set up. Revo XEF needs this integration to communicate with the card terminal and refund the customer's bank or card.

Warning

If the Redsys Pinpad integration has not been created in the back-office and you try to refund in Revo XEF an order made with Revo HANDY, the refund will be completed in the Revo XEF app, but the amount will not have been returned to the bank. The customer will therefore need to make the refund manually on the card terminal using the bank's app.

6Possible errors and how to fix them

Products sent from HANDY are not printed in the kitchen.

Cause: A course is missing or automatic printing is turned off.

Solution: Check that the product has a course assigned. In the back-office, go to Settings → Course and check that Automatic print type is set to Yes.

"Device not active" warning when logging in.
Device not active warning

Cause: The device is not active or the account's device limit has been reached. Revo HANDY works as an additional Revo XEF device.

Solution: Check the licences and active devices in the back-office.

"Incorrect user or password" warning when logging in.
Incorrect user or password warning

Cause: The credentials entered are not correct.

Solution: Enter the login details again, paying attention to upper and lower case.

"Data could not be sent or received" warning.
Data could not be sent or received warning

Cause: The device has no internet connection.

Solution: Check the card terminal's Wi-Fi or data connection.

The app closes or goes to the background when paying.

Cause: The Smartpay (BBVA) or SmartPOSComercia (CaixaBank) payment app is not installed, or it is not set up correctly on the card terminal.

Solution: When you tap the card icon, the payment app should open automatically. Make sure the bank's app is installed and set up.

DOJO: payment processed on the terminal but table still open in XEF.

Cause: The operation may have been completed on the DOJO gateway and the connection lost before tapping Continue. In that case, Revo HANDY may not receive or correctly record the payment result.

Solution: Before charging again, check the DOJO Transactions section and see whether the payment has already been made. Avoid starting several payment attempts without first checking the transaction status.

The STAR TCP/IP printer does not print the receipt.

Cause: The printer type or the selected emulation does not match the model's configuration, or the model uses another connection type.

Solution: Check that STAR TCP/IP is selected in the integration and that Printer Emulation (printer_emulation) exactly matches your model according to the emulation table in this article.

Revo HANDY app frozen
  1. Close the Revo HANDY app from the background apps and open it again.
  2. Once it is open, tap the version number twice in a row (for example, v2.1.1) at the bottom right.
  3. On the Debug Mode screen, make sure that Server is set to Production and tap SAVE to reset the app.
  4. Log in again.

If this does not work, go back to the same screen and tap DELETE APP’S DATA. As a last resort, restart the device.