[IMP] accounting: Adyen's backend changes for the webhook creation
Adyen's backend had slightly changed and the previous doc version was outdated (URL and HMAC key fields) task - 2810213 closes odoo/documentation#2241 Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
@ -2,14 +2,14 @@
|
||||
Adyen
|
||||
=====
|
||||
|
||||
`Adyen <https://www.adyen.com/>`_ is a Dutch-based company that offers several online payment
|
||||
`Adyen <https://www.adyen.com/>`_ 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
|
||||
<adyen/allowed_origins>`.
|
||||
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/allowed_origins>`.
|
||||
|
||||
.. _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,12 +101,12 @@ 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.
|
||||
|
||||
.. seealso::
|
||||
- :doc:`../payment_acquirers`
|
||||
:doc:`../payment_acquirers`
|
||||
|
After Width: | Height: | Size: 7.7 KiB |
After Width: | Height: | Size: 7.0 KiB |
After Width: | Height: | Size: 29 KiB |
After Width: | Height: | Size: 8.2 KiB |
After Width: | Height: | Size: 12 KiB |
Before Width: | Height: | Size: 13 KiB |
Before Width: | Height: | Size: 3.6 KiB |
Before Width: | Height: | Size: 15 KiB |
Before Width: | Height: | Size: 4.0 KiB |