[MOV] payment acquirers: from /general/ (misc. section) to /finance/

The "Payment Acquirers" category was moved to the /general/ folder (Miscellaneous section) when the super-categories such as "Finance" didn't exist yet. Now, it makes more sense to move this category to "Finance". task-id 2743227 X-original-commit: cbe6aad9e9 Part-of: odoo/documentation#1507
2022-01-24 08:11:15 +00:00
parent 0222285869
commit 4e0c62ae03
32 changed files with 29 additions and 16 deletions
@@ -0,0 +1,88 @@
+=====
+Ogone
+=====
+
+`Ogone <https://www.ingenico.com/>`_, also known as **Ingenico Payment Services** is a France-based
+company that provides the technology involved in secure electronic transactions.
+
+Configuration on Odoo
+=====================
+
+.. seealso::
+   - :ref:`payment_acquirers/add_new`
+
+Credentials tab
+---------------
+
+Odoo needs your **API Credentials** to connect with your Ogone account, which comprise:
+
+- **PSPID**: The ID solely used to identify the account with Ogone. You chose it when you opened
+  your account.
+- :ref:`API User ID <ogone/api_user>`: The ID solely used to identify the user with Ogone.
+- :ref:`API User Password <ogone/api_user>`: Value used to identify the user with Ogone.
+- :ref:`SHA Key IN <ogone/sha_key_in>`: Key used in the signature Odoo send to Ogone.
+- :ref:`SHA Key OUT <ogone/sha_key_out>`: Key used in the signature Ogone send to Odoo.
+
+You can copy your credentials from your Ogone account, and paste them in the related fields under
+the **Credentials** tab.
+
+.. _ogone/api_user:
+
+API User ID and Password
+~~~~~~~~~~~~~~~~~~~~~~~~
+
+If you already created a user and have both its ID and password, just copy them. You can also
+generate a new password from :menuselection:`Configuration --> Users --> Your chosen user --> change
+password`.
+
+If you don't have a user, create one by going to :menuselection:`Configuration --> Users -->
+New User`. Set your **User ID** to get your **password** when you save your new user.
+
+.. image:: media/ogone_new_user.png
+   :align: center
+   :alt: Get your password when you save the new user.
+
+.. _ogone/sha_key_in:
+
+SHA Key IN
+~~~~~~~~~~
+
+In order to retrieve the SHA Key IN, log into your ogone account, go to
+:menuselection:`Configuration --> Technical Information --> Data and origin verification -->
+Checks for e-Commerce & Alias Gateway`, and retrieve **SHA Key IN**.
+
+.. _ogone/sha_key_out:
+
+SHA Key OUT
+~~~~~~~~~~~
+
+In order to retrieve the SHA Key OUT, log into your ogone account, go to
+:menuselection:`Configuration --> Technical Information --> Transaction feedback --> All transaction
+submission modes`, and get or generate your **API Key** and **Client Key**. Be careful to copy your
+API key as you'll not be allowed to get it later without generating a new one.
+
+.. important::
+   If you are trying Ogone as a test, with the Test Account, change the **State** to *Test Mode*. We
+   recommend doing this on a test Odoo database, rather than on your main database.
+
+Configuration on Ogone
+======================
+
+Now that Odoo can communicate with Ogone, we need to make sure that Ogone can send information to
+your database.
+
+To do so, log into your Ogone account and go to :menuselection:`Configuration --> Technical
+Information --> Transaction feedback --> Direct HTTP server-to-server request`.
+
+Then, fill the form with the following data:
+
+- In the **Timing of the request**, select *Online but switch to a deferred request when the online
+  requests fail*.
+- | Enter your Odoo databases URL in both **URLs** followed by ``/payment/ogone/return``.
+  | For example: ``https://yourcompany.odoo.com/payment/ogone/return``
+- Select *POST* for the **Request Method**.
+
+Save, and you are ready to go!
+
+.. seealso::
+   - :doc:`../payment_acquirers`