Setting up payment processing with Worldline's Yomani & Yoximo terminals on your iPad

Set up a Yoximo (mobile) or Yomani (non-mobile) payment terminal via WLAN for use with Worldline payment processing in Lightspeed Retail.

Please note the following when using Worldline with Lightspeed Retail POS:

  • If you purchased your Yomani/Yoximo payment terminal from a different supplier (other than Wordline), please check with Worldline if the terminal can be assigned to Lightspeed Retail POS; some suppliers block their terminals from being connected to another POS system.
  • The Yomani/Yoximo payment terminals are currently only supported on the iPad with Lightspeed Retail POS.
  • The payment terminal must be running app version 14.06.00 or later.
  • For all issues related to the payment terminal itself, contact Worldline Support directly.

Setup includes the following:

  1. Set Worldline as the Gateway in Retail POS
  2. Connect the Worldline terminal to your WLAN
  3. Include your device in the ECR Settings
  4. Assign the Worldline terminal to your iPad

Set Worldline as the Gateway in Retail POS

  1. Log on to the Retail POS app in Retail Manager mode.
  2. Open the Main Menu and tap Retail Manager.
  3. Tap Settings > 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 (optional).
    • Select Shops: Select the shops 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 the blue Save button.
  8. For you changes to take effect, sign out of Retail POS and sign back in.


Connect the Worldline terminal to your WLAN

  • Power on the Yoximo terminal by pressing the yellow Corr/ON button. To access the terminal menu, press Menu.
  • Power on the Yomani terminal by connecting the power supply. To access the terminal menu, press Stop > OK > Menu.

  1. From the terminal menu, press 3. Terminal Setup > 5. Wireless Settings.
  2. Enter the merchant password. The merchant password is typically the last four digits of the terminal ID.
  3. Press OK.
  4. Press 1. WLAN Settings > 2. Add WLAN > 2. Scan. A list of available wireless networks is shown. Select your WLAN. Enter a name for your network.
  5. Press OK.
  6. Enter your WLAN key.
  7. Enter a priority for the network. The terminal will select the network with the highest priority (0) at start up.
  8. Press OK. The terminal displays a confirmation that the WLAN has been added.

Include your device in the ECR Settings

Prior to this step, ensure that the ECR Protocol is set to CTEP and the ECR Configuration is set to TCP/IP. For assistance with these setup procedures, please contact a Worldline technician.

  1. Press StopOK > Menu to access the terminal menu.
  2. Press 3. Terminal Setup > 10. Next (0 on keypad).
  3. Press 3. Merchant Settings.
  4. Enter your merchant password. The Merchant password is typically the last four digits of the terminal ID.
  5. Press OK.
  6. Press 10. Next (0 on keypad) > 1. ECR Settings > 2. Add an ECR device.
  7. Enter a label/name for the connection. Press OK. For example: "Register 1".
  8. Enter the Hostname (IP address) of your mobile device. Between each separate number of the IP address, press OK.
    For example: 192 > OK > 168 > OK > 0 > OK > 123 > OK.
    To access your IP address on the iPad, tap Settings > Wi-Fi, then select the blue "i" button to display the network information. 

    NOTE: All IP addresses should be in static mode.

  9. Press OK again.
  10. Enter the port number (9000). Press OK.
  11. Press 1. List ECR Devices.
  12. Select the device by name.
  13. Press Select to verify the IP address.
  14. Press Yes when prompted “Select this ECR device?”.
  15. Press Stop until you have returned to the home screen.

Assign the Worldline terminal to your iPad

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

  2. The app Device Settings opens. Tap Payment Terminal.

  3. Select Yomani/Yoximo to allow incoming connections from the payment terminal. The terminal will then show as “Ready”.

You are now ready to process payments through Worldline.

What's next?

  • To do a test transaction and learn how to view your payment details, see our Configuring payment processing article.
  • To learn how to process refunds and exchanges on your iPad, click here.
Have more questions? Submit a request || || Request a callback