diff --git a/content/applications/sales/point_of_sale/payment.rst b/content/applications/sales/point_of_sale/payment.rst index da8819c26..fa0227665 100644 --- a/content/applications/sales/point_of_sale/payment.rst +++ b/content/applications/sales/point_of_sale/payment.rst @@ -9,4 +9,5 @@ Payment Terminals payment/ingenico payment/vantiv - payment/six \ No newline at end of file + payment/six + payment/worldline diff --git a/content/applications/sales/point_of_sale/payment/worldline.rst b/content/applications/sales/point_of_sale/payment/worldline.rst new file mode 100644 index 000000000..da8d69a43 --- /dev/null +++ b/content/applications/sales/point_of_sale/payment/worldline.rst @@ -0,0 +1,106 @@ +=============================================== +Connect a Worldline Payment Terminal to the PoS +=============================================== + +Connecting a payment terminal allows you to offer a fluid payment flow to your customers and ease +the work of your cashiers. + +.. note:: + Please note that Worldline is currently only available in Belgium. + +Configuration +============= + +Connect an IoT Box +------------------ + +Connecting a Worldline Payment Terminal to Odoo is a feature that requires an IoT Box. For more +information on how to connect one to your database, please refer to the +:doc:`IoT documentation `. + +Configure the protocol +---------------------- + +From your terminal, click on :menuselection:`"." --> 3 --> stop --> 3 --> 0 --> 9`. Enter the +technician password **"1235789"** and click on :menuselection:`OK --> 4 --> 2`. Then, click on +:menuselection:`Change --> CTEP (as Protocole ECR) --> OK`. Click on **OK** thrice on the subsequent +screens (*CTEP ticket ECR*, *ECR ticket width*, and *Character set*). Finally, press **Stop** three +times; the terminal automatically restarts. + +.. seealso:: + Here are some useful :ref:`tips `. + +Set the IP address +------------------ + +From your terminal, click on :menuselection:`"." --> 3 --> stop --> 3 --> 0 --> 9`. Enter the +technician password **"1235789"** and click on :menuselection:`OK --> 4 --> 9`. Then, click on +:menuselection:`Change --> TCP/IP` (*TCP physical configuration* screen) :menuselection:`--> OK --> +OK` (*TCP Configuration client* screen). + +Finally, set up the hostname and port number. + +Hostname +~~~~~~~~ + +| To set up the hostname, enter your IoT box's IP address' sequence numbers and press **OK** at each + "." until you reach the colon symbol. +| Then, press **OK** twice. + +.. example:: + | Here's an IP address sequence: `10.30.19.4:8069`. + | On the *Hostname screen*, type :menuselection:`10 --> OK --> 30 --> OK --> 19 --> OK --> 4 + --> OK --> OK`. + +.. note:: + Your IoT box's IP address is available in your IoT Box application's database. + +Port number +~~~~~~~~~~~ + +On the *Port number* screen, enter **"9001"** and click on :menuselection:`OK` (*ECR protocol SSL +no*) :menuselection:`--> OK`. Click on **Stop** three times; the terminal automatically restarts. + +Configure the payment method +---------------------------- + +From the Point of Sale application, go to :menuselection:`Configuration --> Settings --> Payment +terminals` and activate the *Worldline* payment terminal. + +.. image:: worldline/worldline-payment-terminals.png + :align: center + +Then, go to :menuselection:`Configuration --> Payment methods` and create a new payment method for +*Worldline*. Select the payment terminal *Worldline* and your payment terminal device on your +*Payment Method form*. + +.. _worldline/yomani-info: + +.. tip:: + - Technician password: `1235789` + - To reach Wordline's technical assistance, call `02 727 61 11` and choose "merchant". Your call + is automatically transferred to the desired service. + - Configure the cashier terminal if you have both a customer and a cashier terminal. + - To avoid blocking the terminal, check the initial configuration beforehand. + - Set a fixed IP to your IoT Box’s router to prevent losing the connexion. + +Pay with a payment terminal +=========================== + +When processing a payment, select *Worldline* as payment method. Check the amount and click on +*Send*. Once the payment is successful, the status changes to *Payment Successful*. + +Once your payment is processed, the type of card used and the transaction ID appear on the payment +record. + +.. image:: worldline/worldline-payment.png + :align: center + +.. note:: + * In case of connexion issues between Odoo and the payment terminal, force the payment by + clicking on *Force Done*, which allows you to validate the order. + This option is only available after receiving an error message informing you that the + connection failed. + * To cancel the payment request, click on **cancel**. + + diff --git a/content/applications/sales/point_of_sale/payment/worldline/worldline-form.png b/content/applications/sales/point_of_sale/payment/worldline/worldline-form.png new file mode 100644 index 000000000..f2c02b6c3 Binary files /dev/null and b/content/applications/sales/point_of_sale/payment/worldline/worldline-form.png differ diff --git a/content/applications/sales/point_of_sale/payment/worldline/worldline-ipsequence.png b/content/applications/sales/point_of_sale/payment/worldline/worldline-ipsequence.png new file mode 100644 index 000000000..42c9f0656 Binary files /dev/null and b/content/applications/sales/point_of_sale/payment/worldline/worldline-ipsequence.png differ diff --git a/content/applications/sales/point_of_sale/payment/worldline/worldline-payment-terminals.png b/content/applications/sales/point_of_sale/payment/worldline/worldline-payment-terminals.png new file mode 100644 index 000000000..f045a5dd4 Binary files /dev/null and b/content/applications/sales/point_of_sale/payment/worldline/worldline-payment-terminals.png differ diff --git a/content/applications/sales/point_of_sale/payment/worldline/worldline-payment.png b/content/applications/sales/point_of_sale/payment/worldline/worldline-payment.png new file mode 100644 index 000000000..4c9ef92fe Binary files /dev/null and b/content/applications/sales/point_of_sale/payment/worldline/worldline-payment.png differ