Hi. How can we help?

Setting up a Worldline Yoximo terminal on your iPad

You can set up a Yoximo (mobile) payment terminal that runs a software version 14.06.00 or later to be used with Worldline payment processing on your iPad, provided you are using the Lightspeed Retail POS app.

Note: To check the software version of your terminal, power it on and press STOP (the red button at the bottom left) > Password 5.

Yoximo terminals connect to your iPad via WLAN:

WLAN Wireless Local Area Network: the terminal will be connected to your network via wi-fi. Provided your iPad and your terminal are under the same network, they will connect to each other via wi-fi as well.


Note: If you purchased your Yoximo payment terminal from a different supplier (other than Wordline itself), please contact Worldline to verify if the terminal can be attached to Lightspeed Retail POS - some suppliers block their terminals, which can't be connected to any POS system.

What you need

Yoximo payment terminal Yoximo-terminal-side-view.png
Battery Yoximo-battery.png
AC adaptor Yoximo-AC-adapter.png
Paper roll (for the printer) Yoximo-paper-roll.png

Setup steps

  1. Turning on your Yoximo terminal
  2. Inserting the paper roll
  3. Setting Worldline as the gateway in Retail
  4. Connecting the terminal to your network (WLAN)
  5. Including the terminal in the ECR Settings
  6. Attaching the terminal to your iPad

Turning on your Yoximo terminal

  1. On the back of the terminal, put the privacy shield in the upright position and remove the battery cover by pressing with your thumb on its top to release it, then slide it backwards.


  2. Position the battery with the label facing upwards and the battery contacts facing forwards.
  3. Lower it into the socket carefully.


  4. Make sure the battery contacts touch the ones in the terminal, then press the battery down until you hear a click
  5. Put the battery cover back by placing it on the terminal and sliding it forwards until you hear a click.


  6. Plug the power cable from the AC adaptor into the socket on the left-hand side of the terminal.


  7. Connect the AC adaptor to a wall socket and wait for the terminal's keypad backlight and display to light up. This can take up to five minutes.

Inserting a paper roll

  1. On the terminal, put your fingers on the notches at both the left and right-hand sides of the printer cover, then pull the cover open.


  2. Take a paper roll and unroll about 5 centimetres of it.
  3. Insert the paper as shown on the sticker inside the printer compartment. When inserting a paper roll, make sure that:
    • the paper-holder is empty
    • the paper is not cracked, wrinkled or sealed
    • the paper comes out straight


  4. Close the printer cover. Press firmly until you hear a click.

Setting Worldline as the gateway in Retail

Note: Yoximo terminals only work on your iPad when you access the Lightspeed Retail app in Manager mode. The POS view of the app does not work with this terminal.

  1. Open the Retail app and tap Retail Manager at the bottom right of the screen to view your POS in Manager mode.


  2. On the menu on the left, tap Settings.
  3. Under the Sales row, tap Payment Processing.


  4. Tap + Add a Payment Gateway.
  5. From the Select Gateway drop-down, select Worldline.
  6. From the sub-sections that appear, configure the following:
    • Assign a Name: Enter a unique gateway configuration name that is more intuitive to you (we recommend creating a separate gateway for each shop location).
    • Select Shops: Select the shop(s) that will be using this gateway to process payments.
    • Credit Card Payment Mapping: Map all card brands to their corresponding payment types to configure how they will appear in your reporting.
  7. Tap Save at the top left corner of the screen.
  8. Sign out of the Retail POS app and then sign back in to see your changes in effect.


Connecting the terminal to your network (WLAN)

  1. Press Corr/ON to power on your Yoximo terminal.
  2. Press Menu on the terminal's screen.
  3. From the terminal menu, press 3 (Terminal Setup).
  4. Press 5 (Wireless Settings).
  5. Enter the merchant password.

Note: The merchant password is typically the last four digits of the terminal ID/serial number. You can find the terminal ID on the back of the terminal.

  1. Press OK.
  2. Press 1 (WLAN Settings) > 2 (Add WLAN) > 2 (Scan).
  3. Select your WLAN from the list of available wireless networks.
  4. Press OK.
  5. Enter your network password.
  6. Enter a priority for the network. The terminal will select the network with the highest priority (0) as it starts up.
  7. Press OK. The terminal displays a message confirming that the network has been added.

Including the terminal in the ECR Settings

Your Yoximo device works under a protocol called ECR. Ensure that this ECR protocol is set to CTEP. Doing so will allow Retail to communicate with your Yoximo terminal.

  1. Press StopOK > Menu to access the terminal menu.
  2. Press 3 (Terminal Setup).
  3. Press 0 on the terminal's keypad to select option 10 (Next).
  4. Press 9 (Technician only).
  5. Enter the Technician only password: 1235789.
  6. Press OK.
  7. Press 4 (Hardware settings).
  8. Press 2 (ECR Protocol).
  9. Check the ECR Protocol. If it is not set as CTEP, press Change at the top right.
  10. Press 9 (CTEP).
  11. Press OK twice. You should be taken to the Communications menu.

Now that you are sure the ECR Protocol is set to CTEP on the terminal, follow the steps below to include it in the ECR settings.

  1. From the Communications menu, press 9 (ECR Physical Conf.).
  2. Check the ECR Physical Configuration. If it is not set as TCP/IP, tap Change at the top right
  3. Press 2 (TCP/IP).
  4. Press OK for TCP Configuration Client.
  5. Enter the Hostname (IP address) of your iPad. Instead of using a dot, press OK after each portion of the IP address value.
    For example, if your IP address is 192 > OK > 168 > OK > 0 > OK > 123 > OK.

Note: To view your iPad's IP address, tap Settings >Wi-Fi, then select the "i" icon in blue to display the network information.


  1. On the empty screen named Hostname, press OK.
  2. Enter the port number: 9000
  3. Press OK. You should be taken back to the menu.
  4. Press Stop multiple times in order for the terminal to reboot.

Attaching the terminal to your iPad

  1. Tap the Card Reader icon from the Main Menu.


  2. In the Device Settings section, tap Payment Terminal.


  3. Select Yoximo to connect your iPad to the payment terminal. The terminal will then show as “Ready”.

Note: For all issues related to the payment terminal itself, contact Worldline Support directly.

What's next?

Was this article helpful?

0 out of 0 found this helpful