Revo HANDY is our all-in-one terminal. It lets you manage orders, print receipts and process payments from a single device.
Check the card terminal, the licence and the limitations before adding Revo HANDY.
1Before you start
To add Revo HANDY, the customer must request a compatible card terminal from their bank (see card terminals) and install the corresponding payment app.
Adding Revo HANDY (ordering device and card terminal) counts as an extra device in the Revo XEF account.
Revo HANDY does not currently support sending payments to a PMS.
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.
Request the licence, add the integration in the back-office and set up the printer.
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:
- Open the Revo XEF back-office.
- Press Integrations.
- From the Add button, search for Handy and press Add.
- Fill in the basic integration settings.


| Field | Description |
|---|---|
| Active | Activates the integration in the account. |
| Name | Identifying name (e.g. Handy). |
| Test | Keep it off to operate in production. |
| Working method | Quick 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 gateway | Select the gateway that will process the payments. |
| Payment methods | Select the payment methods shown in the Revo HANDY app (they can differ from those in Revo XEF). |
| Printer | Select the connection or printer type (the network settings appear automatically if you select a TCP/IP connection). |
| Payment reference | Turn it on to automatically print the payment reference on invoices. |
- 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:
The following printers do not need any additional network setup in the integration:
| Type | Connection | Setup / Use |
|---|---|---|
| Adyen (built-in) | Built-in | Uses the built-in printer of the Adyen terminal. |
| Comercia (built-in) | Built-in | Uses the built-in printer of the Comercia terminal. |
| Pax (built-in) | Built-in | Uses the built-in printer of the Pax terminal. |
| Redsys (built-in) | Built-in | Uses the built-in printer of the Redsys terminal. |
| Dojo (built-in) | Built-in | Uses the built-in printer of the Dojo terminal (if the device has one). |
| Abanca (built-in) | Built-in | Uses the built-in printer of the Abanca terminal. |
| Bluetooth | Bluetooth | For external printers connected to the terminal via Bluetooth. |
For network printers that work with ESC/POS, the following additional fields appear in the integration:
| Field | Description |
|---|---|
| IP | IP address assigned to the network printer. |
| Port | If you leave this field empty or enter 0 when saving, the system automatically assigns the default port 9100. |
| Characters | Number of characters per line supported by the printer. |
For STAR printers connected to the network via STAR TCP/IP, set up the following fields:
| Field | Description |
|---|---|
| IP | IP address assigned to the network printer. |
| Port | If you leave this field empty or enter 0 when saving, the system automatically assigns the default port 9100. |
| Printer Emulation | Select the correct emulation for your STAR printer model (see the reference table below). |
The following table is a technical reference for setting the printer_emulation emulation on STAR models. It is not a guaranteed compatibility list. Some models may use other connections and not be supported via TCP/IP.
| STAR model | Printer Emulation | Constant |
|---|---|---|
| mC-Print2 / mC-Print3 | StarPRNT | StarPRNT |
| mC-Label2 / mC-Label3 | StarPRNT | StarPRNT |
| mPOP | StarPRNT | StarPRNT |
| FVP10 | StarLine | StarLine |
| TSP100IV / TSP100IV SK | StarPRNT | StarPRNT |
| TSP100IIIW / LAN / BI / U | StarGraphic | StarGraphic |
| TSP100IIU+ / ECO / GT / LAN | StarGraphic | StarGraphic |
| TSP650II / IISK / 700II / 800II | StarLine | StarLine |
| BSC10II | StarPRNT | StarPRNT |
| SM-S210i / S220i / S230i | EscPosMobile | EscPosMobile |
| SM-T300i / T400i | EscPosMobile | EscPosMobile |
| SM-L200 / L300 | StarPRNTL | StarPRNTL |
Find out what you can do from Revo HANDY and the options in its menu.
3How does it work?
Open tables, add products and edit orders. Our whole Revo XEF product catalogue is also available in Revo HANDY.

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.

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.

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.

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

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

Turn on printing of Revo HANDY orders and assign a course to the products.
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.

Products must have a course assigned; otherwise, they will not be sent to the kitchen.
- Go to Settings → Course in the back-office.
- Create or edit a course, making sure you set Automatic print type to Yes.
- Assign this course to the corresponding products.
The card refund process depends on the bank.
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:
- Go to the REVO r in the Handy menu and tap History.
- Select the order and tap the three-dot icon.

- Tap the Make a refund.

- Select the corresponding invoice and tap OK.

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.
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.
See the cause and solution of each Revo HANDY warning or error.
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.

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.

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.

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
- Close the Revo HANDY app from the background apps and open it again.
- Once it is open, tap the version number twice in a row (for example, v2.1.1) at the bottom right.
- On the Debug Mode screen, make sure that Server is set to Production and tap SAVE to reset the app.
- 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.




