LokiCheckout_Adyen

This integration is available in the paid plans for the Loki Checkout. Support for this integration is provided as is, because we are depending upon the original vendor as well. High priority support is only available on an hourly basis.

Integration

Payment

Professional

Standard

PHP 8.2 - 8.5

Magento 2.4.6 - 2.4.9

CSP Yes

Unit Tests 23

Integration Tests 54

Functional Tests 22

PHPStan 3

Magento PHPCS 6

License OSL-3.0

Latest Release 1.0.7

This is an add-on package for adding support for the payment solution of Adyen to the LokiCheckout.

Installation

Install this package via composer (assuming you have setup the composer.yireo.com repository correctly already):

composer require loki-checkout/magento2-adyen

Next, enable this module:

bin/magento module:enable LokiCheckout_Adyen

Configuration notes

Supported payment methods: cards (adyen_cc), iDEAL, Klarna, Google Pay, Apple Pay and PayPal. Other Adyen methods (and vaulted cards) are hidden in the checkout.
Cards use the 3D Secure redirect flow: this module sets payment/adyen_cc/threeds_flow to redirect by default. With the native flow, a 3D Secure challenge can not be completed in the LokiCheckout: the order is cancelled, the cart is restored and the customer sees an error.
Google Pay, Apple Pay and PayPal place the order from their own button. They are only shown when Adyen returns them for the merchant account.
The client key must allow the origin of the shop (Adyen Customer Area, Developers > API credentials > Allowed origins), otherwise the card fields stay empty.
For cards with a billing address in Brazil (charged in BRL) or Mexico (charged in MXN), the customer chooses between debit and credit. That choice is sent to Adyen as the funding source.
Saved cards (Adyen tokenization / vault), card installments, gift cards and native 3D Secure are not supported yet.
The Apple Pay button is black, the Google Pay button uses the default style and the PayPal button is gold, without the PayPal Credit, Pay Later and Venmo buttons. The button settings of Adyen_Payment are not used.
With Hyvä, the success page block of Adyen_Payment needs RequireJS. Use a Hyvä compatibility module for Adyen_Payment to avoid JavaScript errors on the success page.

Current status

pipeline failed

Support

For getting support, create an Issue under the following project URL:

https://gitlab.yireo.com/loki-checkout/LokiCheckout_Adyen.git

Loki Components

The following LokiComponents are created or references in this module:

loki-checkout.payment.methods.adyen_applepay.form loki-checkout.payment.methods.adyen_cc.form loki-checkout.payment.methods.adyen_googlepay.form loki-checkout.payment.methods.adyen_ideal.form loki-checkout.payment.methods.adyen_klarna.form loki-checkout.payment.methods.adyen_paypal.form

Module Dependencies

The following dependencies are declared in the module its `etc/module.xml` file:

Adyen_Payment LokiCheckout_Core Loki_Base Loki_Components Loki_CssUtils Loki_FieldComponents Magento_AdminNotification Magento_Backend Magento_Catalog Magento_CatalogInventory Magento_Checkout Magento_CheckoutAgreements Magento_Cms Magento_Config Magento_Csp Magento_Customer Magento_Directory Magento_Eav Magento_Indexer Magento_MediaGalleryUiApi Magento_Multishipping Magento_Newsletter Magento_Payment Magento_Quote Magento_Rule Magento_Sales Magento_SalesRule Magento_SalesSequence Magento_Shipping Magento_Store Magento_Tax Magento_Theme Magento_Ui Magento_User Magento_Variable Magento_Vault Magento_Widget Yireo_CspUtilities

Composer details

Magento module name

LokiCheckout_Adyen

Composer name

loki-checkout/magento2-adyen

Composer version

1.0.7

Default branch

main

Requirements


                                    adyen/module-payment: ^10.6

                                    ext-json: *

                                    ext-pcre: *

                                    loki-checkout/magento2-core: ^2.1

                                    loki/magento2-components: ^2.8

                                    loki/magento2-css-utils: ^1.0

                                    loki/magento2-field-components: ^2.2

                                    magento/framework: ^103.0

                                    magento/module-checkout: ^100.4

                                    magento/module-csp: ^100.4

                                    magento/module-payment: ^100.4

                                    magento/module-quote: ^101.2

                                    magento/module-sales: ^103.0

                                    magento/module-store: ^101.1

                                    php: >=8.2 <8.6

                                    psr/log: ^1.0 || ^2.0 || ^3.0

Releases

1.0.7	10 November 2026
1.0.6	10 November 2026
1.0.5	10 November 2026
1.0.4	10 November 2026
1.0.3	10 November 2026
1.0.2	10 November 2026
1.0.1	10 November 2026
1.0.0	10 November 2026

Changelog

[1.0.7] - 09 November 2026

Fixed

Document the supported scope of the Adyen integration
Cover the return from Adyen payment pages and refused cards
Cover payment method icons, CSP whitelist, SDK blocks and 3DS default
Send NL as country to Adyen when the billing country is empty
Do not place the order when the Adyen payment details could not be saved
Send the chosen debit or credit card type to Adyen

[1.0.6] - 06 November 2026

Fixed

Add missing tests

[1.0.5] - 03 November 2026

Fixed

Follow the OrderPaymentInterface API in the action controller test
Require ext-pcre
Save orders through the order repository
Allow the form action of a POST redirect without parse_url()
Restore state data validation, list filtering and CDN URLs
Document supported methods, 3DS flow and allowed origins
Save the Adyen state before the order is placed and show Adyen errors
Load the Adyen SDK with RequireJS present and inline scripts allowed by CSP
Never show the success page for Adyen actions that are not a GET redirect
Allow Adyen analytics and the Klarna SDK in the CSP whitelist
Show the Google Pay icon
Send amount in minor units, regional environment and shopper locale to Adyen
Declare all modules and packages that are used as dependencies
Load Adyen CSS and SDK from the configured regional CDN with SRI hashes
Validate Adyen state data before saving it to the quote
Make Adyen payment method labels translatable
Return payment methods as list after filtering Adyen methods

Added

Pay with PayPal, Google Pay and Apple Pay from their own button

[1.0.4] - 29 October 2026

Fixed

Add JsProperty attribute to getStep() override

[1.0.3] - 12 February 2026

Fixed

Allow PHP Config to read from current store level

[1.0.2] - 28 January 2026

Fixed

Improve resolving step from given block
Async handling of tokenize promise

[1.0.1] - 23 January 2026

Fixed

Move URL creation to ViewModel

[1.0.0] - 14 January 2026

Initial version

Working flow for iDEAL, Creditcard, Klarna and PayPal

Last modified: June 1, 2026