Adyen gateways
The Adyen gateway object and the allowed CRUD operations on the related resource endpoint
Last updated
The Adyen gateway object and the allowed CRUD operations on the related resource endpoint
Last updated
Configuring an Adyen payment gateway for a market lets you safely process payments through Adyen. The Adyen gateway is compliant with the PSD2 European regulation so you can implement a payment flow that supports SCA and 3DS2 by using Adyen's official JS SDK and libraries.
Commerce Layer currently supports the latest version (v71
) of Adyen Checkout API by default and back up to v66
for backward compatibility. If you're using or have implemented an old integration that requires a version lower than v71
make sure to specify it in the api_version
attribute when creating or updating the Adyen gateway resource in Commerce Layer and to use the correct version of Adyen's JS SDK and client libraries as detailed on Adyen's website.
To create an Adyen gateway choose a meaningful name that helps you identify it within your organization and gather all the credentials requested (like merchant account, API key, etc. — contact Adyen's support if you are not sure about the requested data).
To get real orders and be able to process live transactions with Adyen make sure to get your live URL prefix and correctly set the live_url_prefix
attribute of the gateway.
If you're leveraging Adyen's native Drop-in for your integration and want to use the customer payment sources saved from their JS library (highly recommended) instead of the ones saved in Commerce Layer, you can set the native_customer_payment_sources
attribute to true
(default is false
).
Adyen's notifications are webhooks informing you of payment status updates and newly available reports. Notifications are the only way you'll receive automatic updates about requests that are processed asynchronously.
To enable Adyen's notification, first properly set up their configuration on Adyen's customer area (you'll need your webhook_endpoint_url
) and generate the webhook_endpoint_secret
. Then use the async_api
attribute as explained .