All Collections
Taking payments online
Adyen
Setting up online payments with Adyen
Setting up online payments with Adyen

If you use Adyen for payment processing, here's how to connect and use your existing account to take payments on your Toggle web shop.

Oskar Smith avatar
Written by Oskar Smith
Updated over a week ago

Here's how to get your Adyen account connected to Toggle in order to take payments. Not yet got a Adyen account? Sign up for one at: adyen.com

Adyen settings...

The first thing you'll need to do is create a set of API credentials to use with Toggle.

1 - Login in to your Adyen account and head to Developers > API credentials.

3 - Select the credential for your integration, for example ws@Company.[YourCompanyAccount]:

3 - Click the option to Generate New API key.

3 - Copy the generated API Key and click to save it.

4 - Also take a copy of the Client Key:

Markup 2021-07-16 at 12.21.45.png

5 - Under the Allowed origins section, add your Toggle shop domain as an allowed origin, like this:

6 - You're also going to need to know your Merchant account name, which you can find under Account > Merchant Accounts

7 - You also need to create a "web hook" in Adyen. To do this navigate to Account > Webhooks:

8 - Click to create a new webhook

9 - Choose the Standard Notification option and click Add.

10 - Complete the URL field and leave other settings as default. The URL you'l need to enter here is:

https://api.mytoggle.io/api/adyen/webhook

11 - Under the Authentication section, for the username and password, these are unused, so just enter "none' for both:

12 - Now under the Additional Settings section, select Generate new HMAC Key and copy down the key (you'll need this later).

13 - Make sure Authorisation is set to "on" under the Test Notifications section:

Markup 2021-07-16 at 12.14.48.png

14 - To finish, click to save the webhook

Markup 2021-07-16 at 12.16.10.png

15 - Now enable the webhook:

16 - Under Developers > API URLs, grab the endpoint prefix for your account. In this example below it is pal-test but yours might look like 8497a37c9e821a82-MyAccount or similar. Again, take a copy of this - you'll need it in a moment.

Markup 2021-10-26 at 14.50.40.png

17 - Finally, we recommend that your Default 3D Secure rules are set to "Always" within your Adyen account. By default, your account may be set to "Prefer not". See here for more info or speak to your Adyen account manager about this setting.

Toggle settings...

With a note of your API Key, Client Key, Merchant Account name and Webhook HMAC key, now head over to your Toggle dashboard.

1 - Go to Settings > Payment settings and click to Connect with Adyen.

2 - Paste in your configuration details into the corresponding fields.

3 - If you mistype any details, you'll be shown an error message when you try to save your details:

4 - Once connected, you'll see a message showing the configuration was successful:

5 - You're all set!

If you're currently using a sandbox test Adyen account, don't forget to change your details over in the same manner as above once you 'go live'.

Did this answer your question?