Ingenico

Connecting a payment terminal allows you to offer a fluid payment flow to your customers and ease the work of your cashiers.

Important

  • Worldline payment terminals require an IoT Box.

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

  • Odoo works with the Ingenico Lane/, Desk/, and Move/ payment terminals as they support the TLV communication protocol through TCP/IP.

Configuration

Connect an IoT Box

Connecting an Ingenico Payment Terminal to Odoo is a feature that requires an IoT Box. For more information on how to connect an IoT Box to your database, please refer to the IoT documentation.

Configure the Lane/5000 for Ingenico BENELUX

Click on the F button of the terminal, then go in the PoS Menu ‣ Settings and enter the settings password.

Now, click on connection change and TCP/IP. Type the IP of your IoT Box (you can find it on the form view of your IoT Box). Then, enter 9000 as port. The terminal will restart. Once it is done, go on your IoT Box form in Odoo and verify that the terminal has been found.

../../../../../_images/payment_terminal_02.png

Configure the payment method

Enable the payment terminal in the application settings and create the related payment method. Set the journal type as Bank and select Ingenico in the Use a Payment Terminal field. Then, select your terminal device in the Payment Terminal Device field.

../../../../../_images/payment-method2.png

Once the payment method is created, you can select it in your POS settings. To do so, go to the POS’ settings, click Edit, and add the payment method under the Payments section.

Pay with a payment terminal

In your PoS interface, when processing a payment, select a Payment Method using a payment terminal. Check that the amount in the tendered column is the one that has to be sent to the payment terminal and click on Send. When the payment is successful, the status will change to Payment Successful.

../../../../../_images/payment_terminal_05.png

If you want to cancel the payment request, click on cancel. You can still retry to send the payment request.

If there is any issue with the payment terminal, you can still force the payment using the Force Done. This will allow you to validate the order in Odoo even if the connection between the terminal and Odoo has issues.

Note

This option will only be available if you received an error message telling you the connection failed.

Once your payment is processed, on the payment record, you’ll find the type of card that has been used and the transaction ID.

../../../../../_images/payment_terminal_06.png