Worldline

Worldline offers payment solutions through payment terminals to handle customer transactions.

Important

  • Connecting a Worldline payment terminal to Odoo requires an IoT system.

  • Worldline is only available in Belgium, the Netherlands, and Luxembourg with Odoo.

  • Odoo is compatible with Worldline terminals that use the CTEP protocol (e.g., the Yomani XR and Yoximo terminals). Contact the payment provider to confirm the terminal’s compatibility if necessary.

Worldline configuration

First, enable the Worldline payment terminal in the POS settings under Payment Terminals. Then connect the IoT system to Odoo and follow these steps on the terminal:

  1. Configure the ECR protocol:

    1. Press “.” ‣ 3 ‣ Stop ‣ 3 ‣ 0 ‣ 9.

    2. Enter the technician password 1235789 and press OK.

    3. Press 4 ‣ 2 ‣ CTEP (ECR protocol). Press OK to confirm each of the following checks: CTEP ticket ECR, ECR ticket width, and Character set.

    4. Press Stop three times; the terminal restarts automatically.

  2. Set the hostname:

    1. Press “.” ‣ 3 ‣ Stop ‣ 3 ‣ 0 ‣ 9.

    2. Enter the technician password 1235789 and press OK.

    3. Press 4 ‣ 9 ‣ TCP/IP (ECR physical conf.) and OK twice.

    4. Enter the IoT’s IP address on the Hostname screen by confirming each number with OK until the colon symbol, then confirm the step with OK. For example, if the IP address is 10.30.19.4:8069, press 10 ‣ OK ‣ 30 ‣ OK ‣ 19 ‣ OK ‣ 4 ‣ OK ‣ OK.

  3. Set the port number:

    1. Enter 9001 (if using an IoT box) or 9050 (if using a Windows virtual IoT) on the Network domain name screen and press OK twice.

    2. Press Stop three times; the terminal restarts automatically.

The terminal is now active and displays the Read card screen.

Important

The 9050 port must be added as a Windows Firewall exception for the Windows virtual IoT.

Tip

To check the terminal’s connection status, open the IoT app and click the IoT system’s card.

Odoo configuration

To connect the Worldline terminal with Odoo Point of Sale, follow these steps:

  1. Go to Point of Sale ‣ Configuration ‣ Payment Methods and create a payment method.

  2. Set the Journal field to Bank.

  3. Set the Integration field to Terminal.

  4. Set the Integrate with field to Worldline.

  5. Select the configured device in the Payment Terminal Device field and save.

  6. Go to Point of Sale ‣ Configuration ‣ Settings and add the created payment method to the Payment Methods list to make it available in the POS interface.

  7. Click Save.

Tip

  • If a setup uses separate cashier and customer payment terminals, configure the cashier terminal first.

  • To prevent connection loss, set a fixed IP address on the IoT Box’s router or restart the virtual IoT server.