diff --git a/content/applications/sales/point_of_sale/payment_methods/terminals/six.rst b/content/applications/sales/point_of_sale/payment_methods/terminals/six.rst index 42cfef667..51189cfa3 100644 --- a/content/applications/sales/point_of_sale/payment_methods/terminals/six.rst +++ b/content/applications/sales/point_of_sale/payment_methods/terminals/six.rst @@ -2,56 +2,83 @@ SIX === -Connecting a SIX payment terminal allows you to offer a fluid payment flow to your customers and +Connecting a **SIX payment terminal** allows you to offer a fluid payment flow to your customers and ease the work of your cashiers. .. warning:: - - Starting in July 2022, it will **not** be possible anymore to connect and use a Six payment - terminal in PoS. - - Even though Worldline has recently acquired SIX Payment Services and both companies use Yomani - payment terminals, the firmware they run is different. Terminals received from Worldline are - therefore not compatible with this integration. + Even though Worldline has acquired SIX Payment Services and both companies use Yomani payment + terminals, the firmware they run is different. Terminals received from Worldline are, therefore, + not compatible with this integration. Configuration ============= -Configure the Payment Method +Install the POS IoT Six module +------------------------------ + +To activate the POS IoT Six module, go to :guilabel:`Apps`, remove the :guilabel:`Apps` filter, and +search for **POS IoT Six**. This module adds the necessary driver and interface to your database to +detect Six terminals. + +.. note:: + This module replaces the **POS Six** module. + +Connect an IoT box +------------------ + +Connecting a Six payment terminal to Odoo is requires :doc:`using a Raspberry Pi or virtual (for +Windows OS only) IoT box `. + +Configure the terminal ID +------------------------- + +Navigate to your IoT Box homepage, where you can find the :guilabel:`Six payment terminal` field +once your database server is connected to the IoT box. Click :guilabel:`Configure`, fill in the +:guilabel:`Terminal ID` field with the ID received from Six, and click :guilabel:`Connect`. Your +Six terminal ID should appear in the :guilabel:`Current Terminal Id` section. + +.. image:: six/terminal-id.png + :alt: Setting the Six terminal ID + +Odoo automatically restarts the IoT box when the Six terminal ID is configured. If your Six terminal +is online, it will be automatically detected and connected to the database. Check the IoT box +homepage under the :guilabel:`Payments` section to confirm the connection. + +.. image:: six/id-configured.png + :alt: Confirming the connection to the Six payment terminal + +.. _six/configure: + +Configure the payment method ---------------------------- -First, make sure that the :guilabel:`POS Six` module is installed. For this, go to -:guilabel:`Apps`, remove the :guilabel:`Apps` filter, and search for *POS Six*. - -.. image:: six/pos-six-module.png - :align: center - :alt: The POS Six module. - -Back in :menuselection:`Point of Sale --> Configuration --> Payment Methods`, click -:guilabel:`Create` to create a new payment method for SIX, select the payment terminal option -:guilabel:`SIX`, and enter the payment terminal IP address. +From your database, go to :menuselection:`Point of Sale --> Configuration --> Payment Methods` to +create a new payment method specifically for Six. Click :guilabel:`New`, enter a :guilabel:`Name`, +set the :guilabel:`Journal` field as :guilabel:`Bank`, the :guilabel:`Use a Payment Terminal` field +as :guilabel:`SIX IOT`, and select the corresponding device in the :guilabel:`Payment Terminal +Device` field. .. image:: six/new-payment-method.png - :align: center - :alt: Create a new payment method for the SIX payment terminal. + :alt: Creating a new payment method for the SIX payment terminal -Pay with a Payment Terminal +Pay with a payment terminal =========================== -In the :abbr:`PoS (Point of Sale)` interface, at the moment of the payment, select a payment method -using a payment terminal. Verify that the amount in the tendered column is the one that has to be -sent to the payment terminal and click on :guilabel:`Send`. To cancel the payment request, click on -:guilabel:`Cancel`. +When processing a payment, select :ref:`your Six payment method ` in the +:guilabel:`Payment Method` section and click :guilabel:`Send`. To cancel the payment request, click +:guilabel:`Cancel`. Once the payment is successful, the status switches to :guilabel:`Payment +Successful`. -.. image:: six/pos-send-payment.png - :align: center - :alt: The PoS interface. +.. image:: six/payment.png + :alt: Paying with Six -When the payment is done, the status will change to :guilabel:`Payment Successful`. If needed, -reverse the last transaction by clicking on :guilabel:`Reverse`. +.. note:: + - Once your payment is processed, the type of card used and the transaction ID appear on the + payment record. + - The language used for error messages is the same as the Six terminal. Configure the terminal to + change the language or contact Six. + - By default, the port used by the Six terminal is `7784`. -.. image:: six/pos-reverse-payment.png - :align: center - :alt: The Reverse button on the PoS interface. - -If there is any issue with the payment terminal, you can still force the payment using the -:guilabel:`Force Done` button. This will allow you to validate the order in Odoo even if there are -connection issues between the payment terminal and Odoo. +.. tip:: + If there are connection issues between the payment terminal and Odoo, you can still force the + payment validation in Odoo using the :guilabel:`Force Done` button. diff --git a/content/applications/sales/point_of_sale/payment_methods/terminals/six/id-configured.png b/content/applications/sales/point_of_sale/payment_methods/terminals/six/id-configured.png new file mode 100644 index 000000000..0f31aeab8 Binary files /dev/null and b/content/applications/sales/point_of_sale/payment_methods/terminals/six/id-configured.png differ diff --git a/content/applications/sales/point_of_sale/payment_methods/terminals/six/new-payment-method.png b/content/applications/sales/point_of_sale/payment_methods/terminals/six/new-payment-method.png index 927feff40..d08588e83 100644 Binary files a/content/applications/sales/point_of_sale/payment_methods/terminals/six/new-payment-method.png and b/content/applications/sales/point_of_sale/payment_methods/terminals/six/new-payment-method.png differ diff --git a/content/applications/sales/point_of_sale/payment_methods/terminals/six/payment.png b/content/applications/sales/point_of_sale/payment_methods/terminals/six/payment.png new file mode 100644 index 000000000..8e6a2131d Binary files /dev/null and b/content/applications/sales/point_of_sale/payment_methods/terminals/six/payment.png differ diff --git a/content/applications/sales/point_of_sale/payment_methods/terminals/six/pos-reverse-payment.png b/content/applications/sales/point_of_sale/payment_methods/terminals/six/pos-reverse-payment.png deleted file mode 100644 index e3501711c..000000000 Binary files a/content/applications/sales/point_of_sale/payment_methods/terminals/six/pos-reverse-payment.png and /dev/null differ diff --git a/content/applications/sales/point_of_sale/payment_methods/terminals/six/pos-send-payment.png b/content/applications/sales/point_of_sale/payment_methods/terminals/six/pos-send-payment.png deleted file mode 100644 index 31a133618..000000000 Binary files a/content/applications/sales/point_of_sale/payment_methods/terminals/six/pos-send-payment.png and /dev/null differ diff --git a/content/applications/sales/point_of_sale/payment_methods/terminals/six/pos-six-module.png b/content/applications/sales/point_of_sale/payment_methods/terminals/six/pos-six-module.png deleted file mode 100644 index 1a678a0bc..000000000 Binary files a/content/applications/sales/point_of_sale/payment_methods/terminals/six/pos-six-module.png and /dev/null differ diff --git a/content/applications/sales/point_of_sale/payment_methods/terminals/six/terminal-id.png b/content/applications/sales/point_of_sale/payment_methods/terminals/six/terminal-id.png new file mode 100644 index 000000000..945ba2916 Binary files /dev/null and b/content/applications/sales/point_of_sale/payment_methods/terminals/six/terminal-id.png differ