diff --git a/content/applications/finance/payment_acquirers/adyen.rst b/content/applications/finance/payment_acquirers/adyen.rst index 39bad61c9..289654630 100644 --- a/content/applications/finance/payment_acquirers/adyen.rst +++ b/content/applications/finance/payment_acquirers/adyen.rst @@ -2,14 +2,14 @@ Adyen ===== -`Adyen `_ is a Dutch-based company that offers several online payment +`Adyen `_ is a Dutch company that offers several online payment possibilities. Configuration ============= .. seealso:: - - :ref:`payment_acquirers/add_new` + :ref:`payment_acquirers/add_new` Credentials tab --------------- @@ -27,8 +27,10 @@ You can copy your credentials from your Adyen account, and paste them in the rel the **Credentials** tab. .. important:: - If you are trying Adyen as a test, with a *test account*, change the **State** to *Test Mode*. We - recommend doing this on a test Odoo database, rather than on your main database. + If you are trying Adyen as a test, with an Adyen *test account*, head to + :menuselection:`Accounting --> Configuration --> Payment Acquirers`. There, click on + :guilabel:`Adyen`, enable :guilabel:`Test Mode` and enter your credentials in the + :guilabel:`Credentials` tab. .. _adyen/api_and_client_keys: @@ -39,11 +41,13 @@ In order to retrieve the API Key and the Client Key, log into your Adyen account :menuselection:`Developers --> API Credentials`. - If you already have an API user, open it. - If you don't have an API user yet, click on **Create new credential**. -Go to :menuselection:`Authentication` 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. +Go to :menuselection:`Server settings --> Authentification` and copy or generate your **API Key**. +Be careful to copy your API key as you'll not be allowed to get it later without generating a new +one. -This is also the place where you'll :ref:`allow payments to be made from your website -`. +Now, head to :menuselection:`Client settings --> Authentification` and cody or generate your +**Client Key**. This is also the place where you can :ref:`allow payments to be made from your +website `. .. _adyen/hmac_key: @@ -54,19 +58,23 @@ In order to retrieve the HMAC Key, you'll need to configure a `Standard Notifica this, log into your Adyen account then go to :menuselection:`Developers --> Webhooks --> Add webhook --> Add Standard notification`. -.. image:: adyen/adyen_add_webhook.png +.. image:: adyen/adyen-add-webhook.png :align: center :alt: Configure a webhook. -There, in :menuselection:`Transport --> URL`, enter your server address followed by -`/payment/adyen/notification`. +There, in :menuselection:`General --> Server configuration --> URL`, enter your server address +followed by `/payment/adyen/notification`. -.. image:: adyen/adyen_webhook_url.png +.. image:: adyen/adyen-webhook-url.png :align: center :alt: Enter the notification URL. -Then continue in :menuselection:`Additional Settings --> HMAC Key --> Generate new HMAC key`. Be -careful to copy it as you'll not be allowed to get it later without generating a new one. +Then enter :menuselection:`Security --> HMAC Key --> Generate`. Be careful to copy the key as you +will not be allowed to do it later without generating a new one. + +.. image:: adyen/adyen-hmac-key.png + :align: center + :alt: Generate a HMAC key and save it. You have to save the webhook to finalize its creation. @@ -76,10 +84,11 @@ URLs ~~~~ To retrieve the URLs, log into your Adyen account, go to :menuselection:`Developers --> API URLs`. -Pick one of the URLs listed next to **Recurring** as your **Recurring API URL** and one of the URLs -listed next to **Checkout API** as your **Checkout API URL**. +Select one of the URLs listed next to :guilabel:`Classic Recurring API` as your +:guilabel:`Recurring API URL` and one listed next to :guilabel:`Checkout API` as your +:guilabel:`Checkout API URL`. -.. image:: adyen/adyen_api_urls.png +.. image:: adyen/adyen-api-urls.png :align: center :alt: Get the links for the different API. @@ -92,10 +101,10 @@ Allow payments from a specific origin ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ To allow payment originated from your website, follow the steps in :ref:`adyen/api_and_client_keys` -to navigate to your API user and go to :menuselection:`Allowed Origins`, then add the URLs from +to navigate to your API user and go to :menuselection:`Add allowed origins`, then add the URLs from where payments will be made (the URLs of the servers hosting your Odoo instances). -.. image:: adyen/adyen_allowed_origins.png +.. image:: adyen/adyen-allowed-origins.png :align: center :alt: Allows payments originated from a specific domain. @@ -126,4 +135,4 @@ Then, open your Adyen Merchant Account, go to :menuselection:`Account --> Settin **revoke** it. .. seealso:: - - :doc:`../payment_acquirers` + :doc:`../payment_acquirers` diff --git a/content/applications/finance/payment_acquirers/adyen/adyen-add-webhook.png b/content/applications/finance/payment_acquirers/adyen/adyen-add-webhook.png new file mode 100644 index 000000000..627bc83f2 Binary files /dev/null and b/content/applications/finance/payment_acquirers/adyen/adyen-add-webhook.png differ diff --git a/content/applications/finance/payment_acquirers/adyen/adyen-allowed-origins.png b/content/applications/finance/payment_acquirers/adyen/adyen-allowed-origins.png new file mode 100644 index 000000000..d75f90d22 Binary files /dev/null and b/content/applications/finance/payment_acquirers/adyen/adyen-allowed-origins.png differ diff --git a/content/applications/finance/payment_acquirers/adyen/adyen-api-urls.png b/content/applications/finance/payment_acquirers/adyen/adyen-api-urls.png new file mode 100644 index 000000000..4ad7552ab Binary files /dev/null and b/content/applications/finance/payment_acquirers/adyen/adyen-api-urls.png differ diff --git a/content/applications/finance/payment_acquirers/adyen/adyen-hmac-key.png b/content/applications/finance/payment_acquirers/adyen/adyen-hmac-key.png new file mode 100644 index 000000000..a7581ea31 Binary files /dev/null and b/content/applications/finance/payment_acquirers/adyen/adyen-hmac-key.png differ diff --git a/content/applications/finance/payment_acquirers/adyen/adyen-webhook-url.png b/content/applications/finance/payment_acquirers/adyen/adyen-webhook-url.png new file mode 100644 index 000000000..98783df69 Binary files /dev/null and b/content/applications/finance/payment_acquirers/adyen/adyen-webhook-url.png differ diff --git a/content/applications/finance/payment_acquirers/adyen/adyen_add_webhook.png b/content/applications/finance/payment_acquirers/adyen/adyen_add_webhook.png deleted file mode 100644 index 23c3444bd..000000000 Binary files a/content/applications/finance/payment_acquirers/adyen/adyen_add_webhook.png and /dev/null differ diff --git a/content/applications/finance/payment_acquirers/adyen/adyen_allowed_origins.png b/content/applications/finance/payment_acquirers/adyen/adyen_allowed_origins.png deleted file mode 100644 index a184b8fec..000000000 Binary files a/content/applications/finance/payment_acquirers/adyen/adyen_allowed_origins.png and /dev/null differ diff --git a/content/applications/finance/payment_acquirers/adyen/adyen_api_urls.png b/content/applications/finance/payment_acquirers/adyen/adyen_api_urls.png deleted file mode 100644 index aff145b65..000000000 Binary files a/content/applications/finance/payment_acquirers/adyen/adyen_api_urls.png and /dev/null differ diff --git a/content/applications/finance/payment_acquirers/adyen/adyen_webhook_url.png b/content/applications/finance/payment_acquirers/adyen/adyen_webhook_url.png deleted file mode 100644 index 81ba70f80..000000000 Binary files a/content/applications/finance/payment_acquirers/adyen/adyen_webhook_url.png and /dev/null differ