Lago’s native integration with Adyen allows you to collect payments automatically when new invoices are generated.
Lago’s seamless integration with Adyen offers a wide range of payment options, enabling you to conveniently collect payments from your customers. Supported payment methods include:
And many more! With Lago’s native Adyen integration, you can offer your customers a variety of payment options, enhancing their convenience and flexibility during transactions.
Please ensure that you have added payment methods to your Adyen account before setting up the integration (see Adyen documentation).
To set up the Adyen integration in Lago from our user interface, follow these steps:
When connecting Lago to Adyen, you need to provide information for the following fields.
1. API Key (mandatory)
The API Key is a mandatory field and can be found in your Adyen account. Follow these steps to retrieve the API Key:
2. Merchant Account (mandatory)
The Merchant Account is required to ensure that Lago targets the correct Adyen account. To find the Merchant Account:
3. Live Prefix (optional)
The Live Prefix represents the prefix url of your live Adyen account. This field is optional. If left empty, you can connect a test account. However, for live accounts, you must provide a Live Prefix. Follow these steps to obtain the Live Prefix:
4. HMAC Signature (optional)
Adyen’s HMAC signatures are used to protect webhook endpoints and messages created by Adyen. Lago requires this signature to properly decrypt outgoing webhooks from Adyen. To find the HMAC Signature:
The Live Prefix and HMAC Signature fields are optional and may not be required depending on your use case.
To enable automatic payment capture in your Adyen account, ensure that you have configured the account settings accordingly. Automatic payment capture allows for immediate processing without manual intervention. Refer to Adyen’s documentation for instructions on setting up auto capture.
In Adyen, to enable recurring payments for a stored payment method, follow these steps:
Adyen recurring details option
This step is crucial and mandatory for Lago to receive and process messages from Adyen, enabling functionalities such as customer creation/update, payment processing, and refunds. To configure Adyen webhook and establish communication with Lago, follow the steps below:
https://api.getlago.com/webhooks/adyen/{{your_organization_id}}?code={{connection_code}}
.You can find your Organization ID in Lago under the Developers section in Lago, specifically in API keys & ID > Organization ID.
To find your connection code, navigate to the Integrations section in Lago and select the appropriate connection code for your Adyen integration.
Please ensure that you complete this setup correctly, as your Adyen integration will not function without this vital step.
In order to facilitate automated payment collection, it is essential for the customer to exist in both the Lago and Adyen databases. Please note that in Adyen, customers are referred to as Shoppers.
If the customer does not already exist in Adyen, you can create them in Lago using either the user interface or the API. When providing customer information, please ensure the following:
Adyen as PSP for new customer
Once the customer is added in Lago, they will be automatically synchronized with Adyen. Adyen will generate a unique Shopper ID, which will be stored in Lago. Typically, Adyen utilizes the Lago customer’s external_id
as the Shopper ID for seamless integration between the two platforms.
Upon successful customer creation, you will receive two webhook messages to keep you informed:
customer.checkout_url_generated
: This message includes the checkout URL that provides access to the default payment method. It allows you to perform a pre-authorization payment and store the payment method securely; andcustomer.payment_provider_created
: This message confirms the successful creation of the customer in Adyen, indicating that the customer’s details have been added to the Adyen database.You may need to enable Developers -> Additional Data -> Payment -> Recurring details for the customer to be automatically created.
Please note that the customer will be created in Adyen only if the payment method has been stored through the checkout URL and pre-authorization payment.
If the customer and direct debit mandate already exist in Adyen, you can create the customer record in Lago using either the user interface or the API. Follow these steps when adding customer information:
By following these steps, you can integrate an existing customer from Adyen into Lago, ensuring synchronization and consistency between the two platforms.
Adyen as PSP for existing customer
After establishing the connection with Adyen, set a success URL where your end customer will be directed after completing the checkout. Please note that if it’s not defined, your end customer will be redirected to Adyen’s website.
Please note that you can edit or delete the redirect URL, and this will only affect new checkout URLs created.
URL defined should always begin with http://
or https://
.
When Lago automatically creates a customer in Adyen, you will receive a checkout link from Lago to facilitate the storage of your customer’s payment method information.
The payload sent by Lago will have the following structure, with the checkout link stored under checkout_url
:
Note: The checkout link automatically expires after 69 days.
By utilizing this provided checkout link, your customers can perform a pre-authorization payment. It’s important to note that the pre-authorization payment will not collect any funds from the customer. Once the pre-authorization is confirmed, Lago will send the payment method details and securely store them into Adyen for future transactions.
Adyen checkout with Lago
In cases where your end customer has not had the opportunity to complete the checkout process to inform their payment method or wishes to modify the saved payment information, you can generate a new checkout link using the designated endpoint.
Upon successful generation, the new checkout link will be available in the endpoint response, and it will not be delivered through a webhook message. It is important to note that the new link will inherit the same expiration setting as the original one.
It is crucial to be aware that if a customer is not associated with any payment provider, the response will contain an error message.
When a customer has Adyen defined as their payment provider, Lago seamlessly automates the process of triggering payments in Adyen whenever a new invoice is generated.
This integration ensures that payments are initiated in Adyen without any manual intervention. Lago’s automatic payment creation saves time and effort, providing a streamlined experience for both you and your customers.
In cases where a customer has Adyen defined as their payment provider, Lago simplifies the refund process by automatically triggering refunds in Adyen whenever a new refund is initiated through credit notes.
This integration eliminates the need for manual refund processing and ensures that refunds are efficiently handled in Adyen. Lago’s automated refund functionality helps you maintain accurate and timely refund transactions, enhancing customer satisfaction and operational efficiency.
In the event of a lost chargeback (dispute) within Adyen, Lago initiates an automatic response by marking the relevant invoice as disputed lost. This action involves populating the dispute_lost_at
field with the timestamp when the dispute was lost. Following this update:
Lago’s native integration with Adyen allows you to collect payments automatically when new invoices are generated.
Lago’s seamless integration with Adyen offers a wide range of payment options, enabling you to conveniently collect payments from your customers. Supported payment methods include:
And many more! With Lago’s native Adyen integration, you can offer your customers a variety of payment options, enhancing their convenience and flexibility during transactions.
Please ensure that you have added payment methods to your Adyen account before setting up the integration (see Adyen documentation).
To set up the Adyen integration in Lago from our user interface, follow these steps:
When connecting Lago to Adyen, you need to provide information for the following fields.
1. API Key (mandatory)
The API Key is a mandatory field and can be found in your Adyen account. Follow these steps to retrieve the API Key:
2. Merchant Account (mandatory)
The Merchant Account is required to ensure that Lago targets the correct Adyen account. To find the Merchant Account:
3. Live Prefix (optional)
The Live Prefix represents the prefix url of your live Adyen account. This field is optional. If left empty, you can connect a test account. However, for live accounts, you must provide a Live Prefix. Follow these steps to obtain the Live Prefix:
4. HMAC Signature (optional)
Adyen’s HMAC signatures are used to protect webhook endpoints and messages created by Adyen. Lago requires this signature to properly decrypt outgoing webhooks from Adyen. To find the HMAC Signature:
The Live Prefix and HMAC Signature fields are optional and may not be required depending on your use case.
To enable automatic payment capture in your Adyen account, ensure that you have configured the account settings accordingly. Automatic payment capture allows for immediate processing without manual intervention. Refer to Adyen’s documentation for instructions on setting up auto capture.
In Adyen, to enable recurring payments for a stored payment method, follow these steps:
Adyen recurring details option
This step is crucial and mandatory for Lago to receive and process messages from Adyen, enabling functionalities such as customer creation/update, payment processing, and refunds. To configure Adyen webhook and establish communication with Lago, follow the steps below:
https://api.getlago.com/webhooks/adyen/{{your_organization_id}}?code={{connection_code}}
.You can find your Organization ID in Lago under the Developers section in Lago, specifically in API keys & ID > Organization ID.
To find your connection code, navigate to the Integrations section in Lago and select the appropriate connection code for your Adyen integration.
Please ensure that you complete this setup correctly, as your Adyen integration will not function without this vital step.
In order to facilitate automated payment collection, it is essential for the customer to exist in both the Lago and Adyen databases. Please note that in Adyen, customers are referred to as Shoppers.
If the customer does not already exist in Adyen, you can create them in Lago using either the user interface or the API. When providing customer information, please ensure the following:
Adyen as PSP for new customer
Once the customer is added in Lago, they will be automatically synchronized with Adyen. Adyen will generate a unique Shopper ID, which will be stored in Lago. Typically, Adyen utilizes the Lago customer’s external_id
as the Shopper ID for seamless integration between the two platforms.
Upon successful customer creation, you will receive two webhook messages to keep you informed:
customer.checkout_url_generated
: This message includes the checkout URL that provides access to the default payment method. It allows you to perform a pre-authorization payment and store the payment method securely; andcustomer.payment_provider_created
: This message confirms the successful creation of the customer in Adyen, indicating that the customer’s details have been added to the Adyen database.You may need to enable Developers -> Additional Data -> Payment -> Recurring details for the customer to be automatically created.
Please note that the customer will be created in Adyen only if the payment method has been stored through the checkout URL and pre-authorization payment.
If the customer and direct debit mandate already exist in Adyen, you can create the customer record in Lago using either the user interface or the API. Follow these steps when adding customer information:
By following these steps, you can integrate an existing customer from Adyen into Lago, ensuring synchronization and consistency between the two platforms.
Adyen as PSP for existing customer
After establishing the connection with Adyen, set a success URL where your end customer will be directed after completing the checkout. Please note that if it’s not defined, your end customer will be redirected to Adyen’s website.
Please note that you can edit or delete the redirect URL, and this will only affect new checkout URLs created.
URL defined should always begin with http://
or https://
.
When Lago automatically creates a customer in Adyen, you will receive a checkout link from Lago to facilitate the storage of your customer’s payment method information.
The payload sent by Lago will have the following structure, with the checkout link stored under checkout_url
:
Note: The checkout link automatically expires after 69 days.
By utilizing this provided checkout link, your customers can perform a pre-authorization payment. It’s important to note that the pre-authorization payment will not collect any funds from the customer. Once the pre-authorization is confirmed, Lago will send the payment method details and securely store them into Adyen for future transactions.
Adyen checkout with Lago
In cases where your end customer has not had the opportunity to complete the checkout process to inform their payment method or wishes to modify the saved payment information, you can generate a new checkout link using the designated endpoint.
Upon successful generation, the new checkout link will be available in the endpoint response, and it will not be delivered through a webhook message. It is important to note that the new link will inherit the same expiration setting as the original one.
It is crucial to be aware that if a customer is not associated with any payment provider, the response will contain an error message.
When a customer has Adyen defined as their payment provider, Lago seamlessly automates the process of triggering payments in Adyen whenever a new invoice is generated.
This integration ensures that payments are initiated in Adyen without any manual intervention. Lago’s automatic payment creation saves time and effort, providing a streamlined experience for both you and your customers.
In cases where a customer has Adyen defined as their payment provider, Lago simplifies the refund process by automatically triggering refunds in Adyen whenever a new refund is initiated through credit notes.
This integration eliminates the need for manual refund processing and ensures that refunds are efficiently handled in Adyen. Lago’s automated refund functionality helps you maintain accurate and timely refund transactions, enhancing customer satisfaction and operational efficiency.
In the event of a lost chargeback (dispute) within Adyen, Lago initiates an automatic response by marking the relevant invoice as disputed lost. This action involves populating the dispute_lost_at
field with the timestamp when the dispute was lost. Following this update: