Skip to main content

Configuration

For Adyen to appear as available payment gateway, you need to install it in the Saleor Dashboard. You must obtain the API key from Adyen and paste it into the Adyen App configuration form. Then, a wizard will guide you through the process of configuring the Adyen App, setting up the webhook to receive notifications from Adyen, generating the HMAC key, and adding allowed origins for the Client Key that's used on your Storefront.

Configuring Adyen​

Video introduction to Adyen configuration in Saleor:

You can install the Adyen app directly from your Saleor Dashboard. Go to the Apps section and click the Install button next to the Adyen app. Follow the instructions on the screen. After the installation is complete, select the Adyen app from the list of installed applications.

Creating new API Credentials​

To create new Adyen API credentials head over to the Adyen dashboard, then Developers -> API credentials. Click Create new credential and choose Web service user.

In Server settings -> Authentication section generate a new API key.

In Client settings -> Authentication section generate a new client key.

Go back to the Adyen app configuration in the Saleor Dashboard. Provide a configuration name that you will be familiar with. In the API Key field provide the key from Server settings -> Authentication section. Select TEST environment.

caution

The configuration will not work until you save API credentials in the Adyen dashboard.

Save API credentials in the Adyen dashboard, head over to the Adyen app configuration, and click Save. The rest of the form fields have been enabled.

In Client key field provide key from Client settings -> Authentication section. Select the merchant account you want to use from the dropdown.

Webook configuration​

In Adyen dashboard head over to Developers -> Webhooks. Click the + Webhook button and choose Standard webhook. Provide a description for the webhook.

In the Server configuration section provide URL the Saleor Adyen app has generated for you. You can copy it from the Webhook URL input in the Adyen configuration form. Leave default settings and click Apply.

In Merchant accounts select Include only specific merchant accounts and choose the merchant account you would like to use.

In Events, apart from events selected by default, select EXPIRE. Deselect ORDER_OPENED event.

In Additional settings -> Risk select Include the originalReference for CHARGEBACK_REVERSED events.

In Security -> Basic authentication provide username and password. Apply changes. Use the same username and password in the webhook username and webhook password fields in the Adyen application.

Generate a new HMAC key in the Security -> HMAC Key section and copy it.

Apply the configuration details in the Saleor Adyen app then in Adyen dashboard save the new Adyen webhook. Save the configuration. If everything went well, you should see a new button Make test webhook call. Use it to test if your configuration is correct.

caution

API Key provided inside the configuration must have the following permissions set in Adyen Dashboard:

  • "Management API - Accounts read and write"
  • "Management API - API credentials read and write"
  • "Management API - Payment methods read"
  • "Management API - Stores read and write"
  • "Management API - Webhooks read and write"
  • "Checkout encrypted cardholder data"
  • "Merchant Recurring role"
  • "Checkout webservice role"
  • "Merchant PAL Webservice role"