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:
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:
14 - To finish, click to save the webhook
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.
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'.