[IMP] POS: path to configure payment terminals

task-3684488

closes odoo/documentation#7538

Signed-off-by: Loredana Perazzo (lrpz) <lrpz@odoo.com>

content/applications/sales/point_of_sale/payment_methods/terminals.rst

@@ -7,11 +7,13 @@ Payment terminals
 Connecting and integrating a payment terminal with your POS system allows you to accept multiple
 payment options, including credit and debit cards, making the payment process more efficient.
 
+.. _terminals/configuration:
+
 Configuration
 =============
 
-Go to the :doc:`application settings <../configuration>`, scroll down to the :guilabel:`Payment
+Go to the :ref:`application settings <configuration/settings>`, scroll down to the
-Terminals` section, and tick your terminal's checkbox.
+:guilabel:`Payment Terminals` section, and tick your terminal's checkbox.
 
 .. image:: terminals/settings-pt.png
    :alt: checkbox in the settings to enable a payment terminal

content/applications/sales/point_of_sale/payment_methods/terminals/adyen.rst

@@ -19,66 +19,65 @@ your terminal following the steps described on your terminal's screen.
    - `Adyen Docs - Payment terminal quickstart guides
      <https://docs.adyen.com/point-of-sale/user-manuals>`_.
 
-Configure the payment method
+.. _adyen/api:
-----------------------------
-
-First, go to :menuselection:`Point of Sale --> Configuration --> Settings --> Payment Terminals`,
-and enable :guilabel:`Adyen`.
-Then, go to :menuselection:`Configuration --> Payment Methods` and create a new payment method.
-Select :guilabel:`Adyen` in the :guilabel:`Use a Payment Terminal` field.
-
-.. note::
-   The selected journal **must** be a bank journal for the :guilabel:`Use a payment terminal` field
-   to appear.
-
-Finally, fill the mandatory fields with an :guilabel:`Adyen API key`, and an :guilabel:`Adyen
-Terminal Identifier`.
 
 Generate an Adyen API key
-~~~~~~~~~~~~~~~~~~~~~~~~~
+-------------------------
 
-The **Adyen API key** is a key used to authenticate your requests. To generate an API key, go to
+The **Adyen API key** is used to authenticate requests from your Adyen terminal. To generate an API
-your **Adyen account**.
+key, go to your :menuselection:`Adyen account --> Developers --> API credentials`, and **create**
-
+new credentials or select **existing** ones. Click :guilabel:`Generate an API key` and save the key
-Then, go to :menuselection:`Developers --> API credentials`. Create a new credential or click on an
+to paste it into the Odoo :guilabel:`Adyen API key` field at :ref:`the payment method creation
-existing one.
+<adyen/method-creation>`.
-
-Click on :guilabel:`Generate an API key` and copy-paste that key onto the Odoo mandatory field.
 
 .. seealso::
    - `Adyen Docs - API credentials
      <https://docs.adyen.com/development-resources/api-credentials#generate-api-key>`_.
 
-Locate the Adyen terminal identifier
+.. _adyen/identifier:
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-The **Adyen Terminal Identifier** is your terminal's serial number, which is used to identify the
+Locate the Adyen terminal identifier
+------------------------------------
+
+The **Adyen Terminal Identifier** is the terminal's serial number, which is used to identify the
 hardware.
 
-To find this number, go to your **Adyen account**. Then, go to :menuselection:`Point of Sale
+To find this number, go to your :menuselection:`Adyen account --> Point of Sale --> Terminals`,
---> Terminals`, select the terminal to link, and copy-paste its serial number onto the Odoo
+select the terminal to link with, and save its serial number to paste it into the Odoo
-mandatory field.
+:guilabel:`Adyen Terminal Identifier` field at :ref:`the payment method creation
+<adyen/method-creation>`.
 
 Set the Event URLs
-~~~~~~~~~~~~~~~~~~
+------------------
 
-For Odoo to know when a payment is made, you must set the terminal **Event URLs**. To do so,
+For Odoo to know when a payment is made, you must configure the terminal **Event URLs**. To do so,
 
-#. log in to `Adyen's website <https://www.adyen.com/>`_;
+#. Log in to `Adyen's website <https://www.adyen.com/>`_;
-#. go to :menuselection:`Adyen's dashboard --> Point of Sale --> Terminals` and select the connected
+#. Go to :menuselection:`Adyen's dashboard --> Point of Sale --> Terminals` and select the connected
    terminal;
-#. from the terminal settings, click :guilabel:`Integrations`;
+#. From the terminal settings, click :guilabel:`Integrations`;
-#. set the :guilabel:`Switch to decrypted mode to edit this setting` field as :guilabel:`Decrypted`;
+#. Set the :guilabel:`Switch to decrypted mode to edit this setting` field as :guilabel:`Decrypted`;
-#. click the **pencil icon** button and enter your server address, followed by
+#. Click the **pencil icon** button and enter your server address, followed by
-   `/pos_adyen/notification` in the :guilabel:`Event URLs` field; and
+   `/pos_adyen/notification` in the :guilabel:`Event URLs` field;
-#. click :guilabel:`Save` at the bottom of the screen to save the changes.
+#. Click :guilabel:`Save` at the bottom of the screen to save changes.
 
-Add a new payment method
+.. _adyen/method-creation:
-========================
 
-To add a new **payment method** to a point of sale, go to :menuselection:`Point of Sale -->
+Configure the payment method
-Configuration --> Point of Sale`. Then, select the POS and go to :menuselection:`Payments -->
+----------------------------
-Payment Methods`, and add your new method for Adyen.
+
+Enable the payment terminal :ref:`in the application settings <configuration/settings>` and
+:doc:`create the related payment method <../../payment_methods>`. Set the journal type as
+:guilabel:`Bank` and select :guilabel:`Adyen` in the :guilabel:`Use a Payment Terminal` field.
+
+Finally, fill in the mandatory fields with your :ref:`Adyen API key <adyen/api>`, :ref:`Adyen
+Terminal Identifier <adyen/identifier>`, and :guilabel:`Adyen Merchant Account`.
+
+.. image:: adyen/payment-method.png
+
+Once the payment method is created, you can select it in your POS settings. To do so, go to the
+:ref:`POS' settings <configuration/settings>`, click :guilabel:`Edit`, and add the payment method
+under the :guilabel:`Payments` section.
 
 Pay with a payment terminal
 ===========================

content/applications/sales/point_of_sale/payment_methods/terminals/ingenico.rst

@@ -35,19 +35,16 @@ Box* (you can find it on the form view of your IoT Box). Then, enter
 Configure the payment method
 ----------------------------
 
-First, go in the general settings of the POS app, and activate the
+Enable the payment terminal :ref:`in the application settings <configuration/settings>` and
-Ingenico setting.
+:doc:`create the related payment method <../../payment_methods>`. Set the journal type as
+:guilabel:`Bank` and select :guilabel:`Ingenico` in the :guilabel:`Use a Payment Terminal` field.
+Then, select your terminal device in the :guilabel:`Payment Terminal Device` field.
 
-.. image:: ingenico/payment_terminal_03.png
+.. image:: ingenico/payment-method.png
-   :align: center
 
-Go back in :menuselection:`Point of Sale --> Configuration --> Point of Sale`,
+Once the payment method is created, you can select it in your POS settings. To do so, go to the
-go in the payments section and access your payment methods. Create a new
+:ref:`POS' settings <configuration/settings>`, click :guilabel:`Edit`, and add the payment method
-payment method for Ingenico, select the payment terminal option Ingenico, and
+under the :guilabel:`Payments` section.
-select your payment terminal device.
-
-.. image:: ingenico/payment_terminal_04.png
-   :align: center
 
 Pay with a payment terminal
 ===========================

content/applications/sales/point_of_sale/payment_methods/terminals/worldline.rst

@@ -62,15 +62,16 @@ the terminal automatically restarts.
 Configure the payment method
 ----------------------------
 
-From the Point of Sale application, go to :menuselection:`Configuration --> Settings --> Payment
+Enable the payment terminal :ref:`in the application settings <configuration/settings>` and
-terminals` and activate the *Worldline* payment terminal.
+:doc:`create the related payment method <../../payment_methods>`. Set the journal type as
+:guilabel:`Bank` and select :guilabel:`Worldline` in the :guilabel:`Use a Payment Terminal` field.
+Then, select your terminal device in the :guilabel:`Payment Terminal Device` field.
 
 .. image:: worldline/worldline-payment-terminals.png
-   :align: center
 
-Then, go to :menuselection:`Configuration --> Payment methods` and create a new payment method for
+Once the payment method is created, you can select it in your POS settings. To do so, go to the
-*Worldline*. Select the payment terminal *Worldline* and your payment terminal device on your
+:ref:`POS' settings <configuration/settings>`, click :guilabel:`Edit`, and add the payment method
-*Payment Method form*.
+under the :guilabel:`Payments` section.
 
 .. _worldline/yomani-info: