Photo: William Hook / UnsplashAdyen
Connect Adyen to accept card payments in seven currencies.
🖥️ Open in dashboard/payment-gateways/install?id=adyenAdyen is a global payment processor. Connect it with your Adyen API key, merchant account and webhook HMAC key.
Supported currencies: USD, EUR, GBP, AED, SAR, EGP, KWD
Connect Adyen
- Go to Apps and open the Payment Gateways category (or go to Store › Payment settings → Payment Gateways), then click Get or Install on Adyen.
- On the connect screen, check the permissions and click Open gateway dashboard to sign in to your Adyen merchant dashboard. Click Tutorial if you want a step-by-step guide.
- In your Adyen Customer Area, create a Standard webhook that points to the webhook URL shown in the app, and copy its HMAC key.
- Fill in the Configuration fields (see the table below).
- Optional: under Tax Settings, choose a Gateway Tax Type — None, Fixed or Percentage — to add an extra fee when customers pay with Adyen.
- Click Allow. Adyen now shows as your active gateway in Store › Payment settings.
Configuration fields
API Key
Your Checkout API key (X-API-Key), in your Adyen merchant dashboard (Customer Area).
Merchant Account
Your merchant account name, in your Adyen merchant dashboard.
HMAC Key
The HMAC key (hex) of the webhook you created in the Customer Area.
Live URL Prefix
For live payments, copy it from Customer Area → Developers → API URLs. Leave it empty while testing.
Where to find these values in Adyen
- In the live Customer Area (ca-live.adyen.com) go to Developers › API credentials and open (or create) your web service user.
- Under Server settings › Authentication › API key click Generate API key, copy it and click Save changes. You can’t copy it again later.
- Your Merchant Account name is listed under Settings › Merchant accounts (use the merchant account, not the company account).
- Go to Developers › Webhooks › Create new webhook › Standard webhook, paste the Vondera webhook URL, generate the HMAC Key under Security, copy it and click Save configuration.
- The Live URL Prefix is under Developers › API URLs › Prefix.
ℹ️ Good to knowCopy the live values (not test or sandbox). Menu names can differ slightly between accounts; if you can’t find a value, ask the gateway’s support or your account manager.
Common questions
Can I use Adyen together with another gateway?
No. Only one online gateway can be active at a time. To switch, remove the current gateway from Store › Payment settings and connect the new one. See the payment gateways overview.