Skip to main content

Configuration

For Adyen to appear as an 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 the Client key field, provide a key from the Client settings -> Authentication section. Select the merchant account you want to use from the drop-down.

Webhook configuration

caution

Before you begin configuration, make sure that you have disabled the Delayed Capture option in the Adyen Dashboard. Read more details on how to do this on the Overview docs page

In the Adyen dashboard, first go to Developers -> Additional data. Click on the following checkboxes:

  • Authorization amount
  • Authorisation amount (dynamic zero authorisation)
  • Recurring details
  • Merchant reference

Your "Response preview" should look like this:

{
"additionalData": {
"authorisedAmountCurrency": "EUR",
"authorisedAmountValue": "1000",
"recurring.shopperReference": "testshopper",
"recurring.recurringDetailReference": "1111111111111111",
"merchantReference": "ref_1234"
}
}

Click the "Save configuration" button to save your settings.

tip

Adyen webhook will set TransactionItem metadata based on fields received in NotifiactionItem.additionalData.

To configure additional fields that will be set when users make payments, go to Developers > Additional data and choose fields you want to have in your metadata. Read more about this on the Architecture docs page

Then 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 the URL the Saleor Adyen app has generated for you. You can copy it from the Webhook URL input in the Adyen configuration form. Leave the 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 the ORDER_OPENED event.

In Additional settings -> Risk select:

  • Include the originalReference for CHARGEBACK_REVERSED events
  • Include a success boolean for the payments listed in an ORDER_CLOSED event
  • Include Authorised Amount (dynamic zero auth)
  • Include Capture Delay Hours
  • Include card info for recurring contract events)
  • Include zero auth flag
  • Include Shopper Interaction
  • Include Mandate Details
  • Add capture reference to dispute event

In Security -> Basic authentication provide a username and a 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 the 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

The API Key provided inside the configuration must have the following permissions set in the 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"