NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Packagist
Packagist, #3881 most downloaded on Packagist
Official Magento2 Plugin to connect to Payment Service Provider Adyen.
Latest stable
11.3.2
Last release 19 days ago
03 Nov 2026
Ships fairly regularly
a new release about every 3 weeks
Nearly every release is documented
notes for 60 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
11 years old
253 releases · first in 2016
Drag across the ruler to compare, or tap a release to open it.
<!-- Release notes generated using configuration in .github/release.yml at main -->
<!-- Release notes generated using configuration in .github/release.yml at main -->
Full Changelog: https://github.com/Adyen/adyen-magento2/compare/v11.3.1...v11.3.2
Full Changelog: v11.3.1...v11.3.2
Your coding agent can read these notes before it upgrades. Set up the MCP server →
<!-- Release notes generated using configuration in .github/release.yml at main -->
<!-- Release notes generated using configuration in .github/release.yml at main -->
Current Checkout API version: v71 Current Checkout Component version: 6.35.0
Full Changelog: https://github.com/Adyen/adyen-magento2/compare/v11.3.0...v11.3.1
Current Checkout API version: v71
Current Checkout Component version: 6.35.0
Full Changelog: v11.3.0...v11.3.1
[ECP-10028] Fix null array offset deprecation on PHP 8.5 by @shubhamk67 in https://github.com/Adyen/adyen-magento2/pull/3372
<!-- Release notes generated using configuration in .github/release.yml at main -->
Current Checkout API version: v71 Current Checkout Component version: 6.35.0
Full Changelog: https://github.com/Adyen/adyen-magento2/compare/v11.2.0...v11.3.0
Current Checkout API version: v71
Current Checkout Component version: 6.35.0
Full Changelog: v11.2.0...v11.3.0
<!-- Release notes generated using configuration in .github/release.yml at main -->
<!-- Release notes generated using configuration in .github/release.yml at main -->
Current Checkout API version: v71 Current Checkout Component version: 6.35.0
Full Changelog: https://github.com/Adyen/adyen-magento2/compare/v11.1.0...v11.2.0
Current Checkout API version: v71
Current Checkout Component version: 6.35.0
Full Changelog: v11.1.0...v11.2.0
<!-- Release notes generated using configuration in .github/release.yml at main -->
<!-- Release notes generated using configuration in .github/release.yml at main -->
Current Checkout API version: v71 Current Checkout Component version: 6.35.0
Full Changelog: https://github.com/Adyen/adyen-magento2/compare/v11.0.0...v11.1.0
Current Checkout API version: v71
Current Checkout Component version: 6.35.0
Full Changelog: v11.0.0...v11.1.0
<!-- Release notes generated using configuration in .github/release.yml at main -->
<!-- Release notes generated using configuration in .github/release.yml at main -->
Current Checkout API version: v71 Current Checkout Component version: 6.35.0
Full Changelog: https://github.com/Adyen/adyen-magento2/compare/v10.10.3...v11.0.0
Current Checkout API version: v71
Current Checkout Component version: 6.35.0
Full Changelog: v10.10.3...v11.0.0
<!-- Release notes generated using configuration in .github/release.yml at main-10 -->
<!-- Release notes generated using configuration in .github/release.yml at main-10 -->
Full Changelog: https://github.com/Adyen/adyen-magento2/compare/v10.11.1...v10.11.2
Full Changelog: v10.11.1...v10.11.2
<!-- Release notes generated using configuration in .github/release.yml at main-10 -->
<!-- Release notes generated using configuration in .github/release.yml at main-10 -->
Current Checkout API version: v71 Current Checkout Component version: 6.31.1
Full Changelog: https://github.com/Adyen/adyen-magento2/compare/v10.11.0...v10.11.1
Current Checkout API version: v71
Current Checkout Component version: 6.31.1
Full Changelog: v10.11.0...v10.11.1
<!-- Release notes generated using configuration in .github/release.yml at main-10 -->
<!-- Release notes generated using configuration in .github/release.yml at main-10 -->
Current Checkout API version: v71 Current Checkout Component version: 6.31.1
Full Changelog: https://github.com/Adyen/adyen-magento2/compare/v10.10.4...v10.11.0
Current Checkout API version: v71
Current Checkout Component version: 6.31.1
Full Changelog: v10.10.4...v10.11.0
<!-- Release notes generated using configuration in .github/release.yml at main-10 -->
<!-- Release notes generated using configuration in .github/release.yml at main-10 -->
Current Checkout API version: v71 Current Checkout Component version: 6.31.1
Full Changelog: https://github.com/Adyen/adyen-magento2/compare/v10.10.3...v10.10.4
Current Checkout API version: v71
Current Checkout Component version: 6.31.1
Full Changelog: v10.10.3...v10.10.4
[ECP-9941] Fix L2/L3 enhanced scheme data validation by @shubhamk67 in #3307
Current Checkout API version: v71
Current Checkout Component version: 6.31.1
Full Changelog: v10.10.2...v10.10.3
<!-- Release notes generated using configuration in .github/release.yml at main -->
Current Checkout API version: v71 Current Checkout Component version: 6.31.1
Full Changelog: https://github.com/Adyen/adyen-magento2/compare/v10.10.2...v10.10.3
<!-- Release notes generated using configuration in .github/release.yml at main -->
<!-- Release notes generated using configuration in .github/release.yml at main -->
Current Checkout API version: v71 Current Checkout Component version: 6.31.1
Full Changelog: https://github.com/Adyen/adyen-magento2/compare/v10.10.1...v10.10.2
Current Checkout API version: v71
Current Checkout Component version: 6.31.1
Full Changelog: v10.10.1...v10.10.2
[ECP-9943] Fix installment data loss during GraphQL placeOrder by @shubhamk67 in #3291
Full Changelog: v10.10.0...v10.10.1
<!-- Release notes generated using configuration in .github/release.yml at main -->
Full Changelog: https://github.com/Adyen/adyen-magento2/compare/v10.10.0...v10.10.1
[ECP-9693] Add payment method title override configuration by @shubhamk67 in #3285
Full Changelog: v10.9.0...v10.10.0
<!-- Release notes generated using configuration in .github/release.yml at main -->
Current Checkout API version: v71 Current Checkout Component version: 6.31.1
Full Changelog: https://github.com/Adyen/adyen-magento2/compare/v10.9.0...v10.10.0
[ECP-9926] Implement IRIS payment method by @candemiralp in #3262
Current Checkout API version: v71
Current Checkout Component version: 6.31.1
Full Changelog: v10.8.0...v10.9.0
<!-- Release notes generated using configuration in .github/release.yml at main -->
Current Checkout API version: v71 Current Checkout Component version: 6.31.1
Full Changelog: https://github.com/Adyen/adyen-magento2/compare/v10.8.0...v10.9.0
[ECP-8667] Enable Adyen Giving donations on headless integration by @candemiralp in #3254
Current Checkout API version: v71
Current Checkout Component version: 6.21.0
Full Changelog: v10.7.2...v10.8.0
<!-- Release notes generated using configuration in .github/release.yml at main -->
Current Checkout API version: v71 Current Checkout Component version: 6.21.0
Full Changelog: https://github.com/Adyen/adyen-magento2/compare/v10.7.2...v10.8.0
[ECP-9903] Deprecate buildAdyenTokenizedPaymentRecurringData() method by @candemiralp in https://github.com/Adyen/adyen-magento2/pull/3242
<!-- Release notes generated using configuration in .github/release.yml at main -->
Current Checkout API version: v71 Current Checkout Component version: 6.21.0
Full Changelog: https://github.com/Adyen/adyen-magento2/compare/v10.7.1...v10.7.2
<!-- Release notes generated using configuration in .github/release.yml at main -->
<!-- Release notes generated using configuration in .github/release.yml at main -->
Current Checkout API version: v71 Current Checkout Component version: 6.21.0
Full Changelog: https://github.com/Adyen/adyen-magento2/compare/v10.7.0...v10.7.1
<!-- Release notes generated using configuration in .github/release.yml at main -->
<!-- Release notes generated using configuration in .github/release.yml at main -->
Current Checkout API version: v71 Current Checkout Component version: 6.21.0
Full Changelog: https://github.com/Adyen/adyen-magento2/compare/v10.6.1...v10.7.0
<!-- Release notes generated using configuration in .github/release.yml at main -->
<!-- Release notes generated using configuration in .github/release.yml at main -->
Current Checkout API version: v71 Current Checkout Component version: 6.21.0
Full Changelog: https://github.com/Adyen/adyen-magento2/compare/v10.6.0...v10.6.1
<!-- Release notes generated using configuration in .github/release.yml at main -->
<!-- Release notes generated using configuration in .github/release.yml at main -->
[ECP-9322] Adding unit test for TransportBuilder by @khushboo-singhvi in https://github.com/Adyen/adyen-magento2/pull/3198
[ECP-9877] Change the HMAC signature validation method by @candemiralp in https://github.com/Adyen/adyen-magento2/pull/3199
[ECP-9871] Add capturePspReference to Scalapay refund requests by @candemiralp in https://github.com/Adyen/adyen-magento2/pull/3202
[ECP-9882] Allow using public_hash on recurring graphql payments by @candemiralp in https://github.com/Adyen/adyen-magento2/pull/3204
[ECP-9791] Add payment flow diagrams by @shubhamk67 in https://github.com/Adyen/adyen-magento2/pull/3195
Release v10.6.0 by @AdyenAutomationBot in https://github.com/Adyen/adyen-magento2/pull/3196
Current Checkout API version: v71 Current Checkout Component version: 6.21.0
Full Changelog: https://github.com/Adyen/adyen-magento2/compare/v10.5.6...v10.6.0
<!-- Release notes generated using configuration in .github/release.yml at main -->
<!-- Release notes generated using configuration in .github/release.yml at main -->
Current Checkout API version: v71 Current Checkout Component version: 6.21.0
Full Changelog: https://github.com/Adyen/adyen-magento2/compare/v10.5.5...v10.5.6
<!-- Release notes generated using configuration in .github/release.yml at main -->
<!-- Release notes generated using configuration in .github/release.yml at main -->
Current Checkout API version: v71 Current Checkout Component version: 6.21.0
Full Changelog: https://github.com/Adyen/adyen-magento2/compare/v10.5.4...v10.5.5
<!-- Release notes generated using configuration in .github/release.yml at main -->
<!-- Release notes generated using configuration in .github/release.yml at main -->
Current Checkout API version: v71 Current Checkout Component version: 6.21.0
Full Changelog: https://github.com/Adyen/adyen-magento2/compare/v10.5.3...v10.5.4
<!-- Release notes generated using configuration in .github/release.yml at main -->
<!-- Release notes generated using configuration in .github/release.yml at main -->
Current Checkout API version: v71 Current Checkout Component version: 6.21.0
Full Changelog: https://github.com/Adyen/adyen-magento2/compare/v10.5.2...v10.5.3
<!-- Release notes generated using configuration in .github/release.yml at main -->
<!-- Release notes generated using configuration in .github/release.yml at main -->
Current Checkout API version: v71 Current Checkout Component version: 6.21.0
Full Changelog: https://github.com/Adyen/adyen-magento2/compare/v10.5.1...v10.5.2
<!-- Release notes generated using configuration in .github/release.yml at main -->
<!-- Release notes generated using configuration in .github/release.yml at main -->
Queue processing is enabled. You are not impacted if you use Cron processor for webhook handling. This has been resolved on v10.5.2.Current Checkout API version: v71 Current Checkout Component version: 6.21.0
Full Changelog: https://github.com/Adyen/adyen-magento2/compare/v10.5.0...v10.5.1
<!-- Release notes generated using configuration in .github/release.yml at main -->
<!-- Release notes generated using configuration in .github/release.yml at main -->
Queue processing is enabled. You are not impacted if you use Cron processor for webhook handling. This has been resolved on v10.5.2.Current Checkout API version: v71 Current Checkout Component version: 6.21.0
Full Changelog: https://github.com/Adyen/adyen-magento2/compare/v10.4.0...v10.5.0
<!-- Release notes generated using configuration in .github/release.yml at main -->
<!-- Release notes generated using configuration in .github/release.yml at main -->
Queue processing is enabled. You are not impacted if you use Cron processor for webhook handling. This has been resolved on v10.5.2.Current Checkout API version: v71 Current Checkout Component version: 6.21.0
Full Changelog: https://github.com/Adyen/adyen-magento2/compare/v10.3.0...v10.4.0
<!-- Release notes generated using configuration in .github/release.yml at main -->
<!-- Release notes generated using configuration in .github/release.yml at main -->
Full Changelog: https://github.com/Adyen/adyen-magento2/compare/v10.2.0...v10.3.0
<!-- Release notes generated using configuration in .github/release.yml at main -->
<!-- Release notes generated using configuration in .github/release.yml at main -->
Current Checkout API version: v71 Current Checkout Component version: 6.21.0
Full Changelog: https://github.com/Adyen/adyen-magento2/compare/v10.1.1...v10.2.0
<!-- Release notes generated using configuration in .github/release.yml at main -->
<!-- Release notes generated using configuration in .github/release.yml at main -->
Full Changelog: https://github.com/Adyen/adyen-magento2/compare/v10.1.0...v10.1.1
Current Checkout API version: v71 Current Checkout Component version: 6.13.1
<!-- Release notes generated using configuration in .github/release.yml at main -->
<!-- Release notes generated using configuration in .github/release.yml at main -->
Current Checkout API version: v71 Current Checkout Component version: 6.13.1
Full Changelog: https://github.com/Adyen/adyen-magento2/compare/v10.0.0...v10.1.0
…🔍 Introduction of PHPStan for static analysis 💣 Breaking Changes The following breaking changes have been introduced in V10 of the Adyen Adobe Commerc…
<p><p><span style=font-weight:400>📌 Purpose</span><p><span style=font-weight:400>This document serves as the official </span><strong>Release Notes for Version 10.0.0</strong><span style=font-weight:400> of the </span><strong>Adyen Adobe Commerce Plugin (main module only)</strong><span style=font-weight:400>. It outlines the technical and integration changes introduced in this major release, and provides actionable guidance for development teams to successfully upgrade to V10.</span><p><span style=font-weight:400>⚠️ Magento Compatibility Notice: As of V10, the Adyen Adobe Commerce plugin only supports Magento </span><strong>version 2.4.8</strong><span style=font-weight:400>. All earlier versions (≤ 2.4.7) are no longer supported.</span><p><span style=font-weight:400>👥 Target Audience</span><p><span style=font-weight:400>This guide is intended for:</span><ul><li style=font-weight:400><strong>Developers</strong><span style=font-weight:400> maintaining or upgrading Adyen integrations</span><li style=font-weight:400><strong>GitHub contributors</strong><span style=font-weight:400> working on the plugin</span><li style=font-weight:400><strong>System Integrators (SIs)</strong><span style=font-weight:400> implementing or supporting merchants</span><li style=font-weight:400><strong>Adyen Support teams</strong><span style=font-weight:400> assisting clients during migration and testing</span></ul><p><span style=font-weight:400>🆕 Key Features and Compatibility in V10</span><ul><li style=font-weight:400><span style=font-weight:400>🧱 Magento 2.4.8 compatibility</span><li style=font-weight:400><span style=font-weight:400>🧬 PHP 8.4 support</span><li style=font-weight:400><span style=font-weight:400>✅ Support for Checkout Web Components V6 (6.13.1)</span><li style=font-weight:400><span style=font-weight:400>🍏 Cross-browser compatibility for Apple Pay</span><li style=font-weight:400><span style=font-weight:400>🌐 Payment method titles now retrieved dynamically from the </span><span style=font-weight:400>/paymentMethods</span><span style=font-weight:400> API response</span><li style=font-weight:400><span style=font-weight:400>🎗 New Donation Campaign Manager (redesigned backend and frontend integration) with fixed amounts and roundups</span><li style=font-weight:400><span style=font-weight:400>🧪 Migration to PHPUnit 10</span><li style=font-weight:400><span style=font-weight:400>🔍 Introduction of PHPStan for static analysis</span></ul><h1><span style=font-weight:400>💣 Breaking Changes</span></h1><p><span style=font-weight:400>The following breaking changes have been introduced in V10 of the Adyen Adobe Commerce Plugin. These may require merchants and developers to update their implementation, configuration, or expectations when upgrading from V9.</span><p><span style=font-weight:400>🐘 </span><strong>Magento 2.4.8 & Monolog Compatibility with PHP 8.4</strong><p><span style=font-weight:400>❗ Minimum Required Magento Version: 2.4.8</span><p><strong>Reference</strong><span style=font-weight:400>: YT - ECP-9667, PR</span><a href=https://github.com/Adyen/adyen-magento2/pull/2948> <span style=font-weight:400>#2948</span><span style=font-weight:400><br></span></a><span style=font-weight:400>The plugin previously relied on outdated Monolog v1/v2 handlers. With PHP 8.4 support, the dependency has been upgraded to </span><strong>Monolog v3.x</strong><span style=font-weight:400>, which introduced stricter type declarations.</span><p><span style=font-weight:400>Our custom </span><span style=font-weight:400>LoggerHandler</span><span style=font-weight:400> extending </span><span style=font-weight:400>Monolog\Handler\AbstractProcessingHandler</span><span style=font-weight:400> has been updated to match these new declarations (e.g., </span><span style=font-weight:400>isHandling()</span><span style=font-weight:400> now enforces strict typing).</span><p><span style=font-weight:400>AdyenLogger</span><span style=font-weight:400> is not extending </span><span style=font-weight:400>Monolog\Logger</span><span style=font-weight:400> anymore. Instead, </span><span style=font-weight:400>Monolog\LoggerFactory</span><span style=font-weight:400> is used to generate a logger class.</span><p><strong>Action Required</strong><span style=font-weight:400>:</span><span style=font-weight:400><br></span><span style=font-weight:400>If you have custom Monolog handlers or extend Adyen's base logging logic, ensure compatibility with Monolog v3 signatures.</span><p><span style=font-weight:400>If you call any methods from the parent class </span><span style=font-weight:400>Monolog\Logger</span><span style=font-weight:400> as a part of </span><span style=font-weight:400>AdyenLogger</span><span style=font-weight:400>, ensure to replace them with the local methods.</span><p class=demoTitle> <p><span style=font-weight:400>⚙️</span><strong> Dropped Support for Magento ≤ 2.4.7</strong><p><span style=font-weight:400>❗ Minimum Required Magento Version: 2.4.8</span><span style=font-weight:400><br></span><span style=font-weight:400><br></span><span style=font-weight:400>Support for Magento 2.4.7 and below has been fully removed in this version. Ensure your platform is running 2.4.8 before upgrading to V10.</span><p><strong>Reference</strong><span style=font-weight:400>: YT - ECP-9521, YT - ECP-9579, PR</span><a href=https://github.com/Adyen/adyen-magento2/pull/2876> <span style=font-weight:400>#2876</span><span style=font-weight:400><br></span></a><span style=font-weight:400>This decision was primarily driven by </span><strong>backward-incompatible changes introduced in Magento 2.4.8</strong><span style=font-weight:400>, including updates to core service contracts and dependency injection behavior</span><p><span style=font-weight:400>With V10, we’ve streamlined our compatibility by focusing on Magento 2.4.8 as the baseline</span><p><strong>Action Required</strong><span style=font-weight:400>:</span><span style=font-weight:400><br></span><span style=font-weight:400>Ensure your Magento version is </span><strong>2.4.8</strong><span style=font-weight:400> before upgrading to V10.</span><p><span style=font-weight:400>📝</span><strong> Order Comment History Refactor</strong><p><strong>Reference</strong><span style=font-weight:400>: YT - ECP-9593, PR</span><a href=https://github.com/Adyen/adyen-magento2/pull/2906> <span style=font-weight:400>#2906</span><span style=font-weight:400><br></span></a><span style=font-weight:400>Previously, order comment history logic was embedded with redundant </span><span style=font-weight:400>arguments</span><span style=font-weight:400>. In V10, the comment-adding logic has been </span><strong>refactored and abstracted</strong><span style=font-weight:400> to improve maintainability and consistency across the module.</span><p><strong>Impact</strong><span style=font-weight:400>:</span><span style=font-weight:400><br></span><span style=font-weight:400>This may break custom logic that extended or depended on the old structure for adding order comments.</span><p><strong>Action Required</strong><span style=font-weight:400>:</span><span style=font-weight:400><br></span><span style=font-weight:400>If you extended comment history behavior or relied on specific comment arguments, refactor your custom logic accordingly.</span><p><span style=font-weight:400>🧩</span><strong> Upgrade to Checkout Web Components V6</strong><p><strong>Reference</strong><span style=font-weight:400>: YT - ECP-9017, PR</span><a href=https://github.com/Adyen/adyen-magento2/pull/2878> <span style=font-weight:400>#2878</span><span style=font-weight:400><br></span></a><span style=font-weight:400>V10 adds support for </span><strong>Checkout Web Components v6</strong><span style=font-weight:400>, offering improved performance, enhanced design flexibility, and alignment with Adyen’s latest frontend standards.</span><p><span style=font-weight:400>This upgrade only becomes relevant if:</span><ul><li style=font-weight:400><span style=font-weight:400>You're using a headless integration (e.g., PWA, GraphQL-based storefront), or</span><span style=font-weight:400><br><br></span><li style=font-weight:400><span style=font-weight:400>You've implemented custom rendering logic for Adyen components.</span><span style=font-weight:400><br><br></span></ul><p><span style=font-weight:400>If you're using the plugin’s default checkout integration, no changes are needed.</span><p><strong>Action Required</strong><span style=font-weight:400>:</span><span style=font-weight:400><br></span><span style=font-weight:400>For headless or customized integrations, ensure your frontend is compatible with Web Components v6.</span><span style=font-weight:400><br></span><span style=font-weight:400>📖 Refer to the </span><a href="https://docs.adyen.com/online-payments/release-notes/?title%5B0%5D=Web+Components%2FDrop-in#releaseNote=2024-07-24-web-componentsdrop-in-6.0.0"><span style=font-weight:400>official migration guide</span></a><span style=font-weight:400> for implementation details.</span><p><span style=font-weight:400>💳</span><strong> Installments via Card Component</strong><p><strong>Reference</strong><span style=font-weight:400>: YT - ECP-9052, PR</span><a href=https://github.com/Adyen/adyen-magento2/pull/2900> <span style=font-weight:400>#2900</span><span style=font-weight:400><br></span></a><span style=font-weight:400>Previously, installment logic was rendered using a </span><strong>custom template</strong><span style=font-weight:400>. With V10, installments are now rendered directly via the </span><strong>Card component</strong><span style=font-weight:400> from Checkout Web Components V6.</span><p><strong>Action Required</strong><span style=font-weight:400>:</span><span style=font-weight:400><br></span><span style=font-weight:400>If your frontend relies on custom rendering logic for installments, update it to align with the new component-based rendering approach.</span><p><span style=font-weight:400>🎗</span><strong> Giving Refactored with Campaign Manager</strong><p><strong>Reference</strong><span style=font-weight:400>: </span><em><span style=font-weight:400>(YT - ECP-9387 PR - </span></em><a href=https://github.com/Adyen/adyen-magento2/pull/2950><em><span style=font-weight:400>#2950</span></em></a><em><span style=font-weight:400>)</span></em><p><span style=font-weight:400>The Giving component has been rearchitected in V10 with a new </span><strong>Campaign Manager</strong><span style=font-weight:400> backend and frontend flow. This introduces a </span><strong>lightweight, scalable way</strong><span style=font-weight:400> for merchants to manage campaigns—but also </span><strong>deprecates and removes</strong><span style=font-weight:400> the previous Giving implementation. Also, Now from this version of the plugin the Giving Configuration is always set to </span><strong>True</strong><span style=font-weight:400> by default.</span><p><span style=font-weight:400> </span><p><span style=font-weight:400>🔧</span><strong> Key Breaking Changes</strong><ul><li style=font-weight:400><span style=font-weight:400>Most Adyen Giving configuration fields have been removed. Only the </span><span style=font-weight:400>active</span><span style=font-weight:400> flag remains, which is set to TRUE by default</span><li style=font-weight:400><span style=font-weight:400>The following backend methods have been removed (non-exhaustive):</span></li><ul><li style=font-weight:400><span style=font-weight:400>getDonationComponentConfiguration()</span><li style=font-weight:400><span style=font-weight:400>getAdyenGivingCharityName()</span><li style=font-weight:400><span style=font-weight:400>getAdyenGivingCharityDescription()</span><li style=font-weight:400><span style=font-weight:400>getAdyenGivingBackgroundImage()</span><li style=font-weight:400><span style=font-weight:400>getAdyenGivingCharityLogo()</span><li style=font-weight:400><span style=font-weight:400>getAdyenGivingCharityWebsite()</span><li style=font-weight:400><span style=font-weight:400>getAdyenGivingDonationAmounts()</span><li style=font-weight:400><span style=font-weight:400>getCharityMerchantAccount()</span><li style=font-weight:400><span style=font-weight:400>getAdyenGivingConfigData()</span></ul><li style=font-weight:400><span style=font-weight:400>Previous frontend integration (based on static values and hardcoded HTML) is no longer compatible.</span></ul><p><span style=font-weight:400>🆕</span><strong> Replaced with:</strong><ul><li style=font-weight:400><span style=font-weight:400>New secure </span><span style=font-weight:400>/donationCampaigns</span><span style=font-weight:400> endpoint (added via </span><span style=font-weight:400>webapi.xml</span><span style=font-weight:400>).</span><li style=font-weight:400><span style=font-weight:400>Call to this endpoint on the order success page to dynamically retrieve campaign(s).</span><li style=font-weight:400><span style=font-weight:400>Mounting the Giving component using Adyen Web Components v6 based on dynamic response.</span><li style=font-weight:400><span style=font-weight:400>Support for </span><strong>one active campaign</strong><span style=font-weight:400> at a time.</span><li style=font-weight:400><span style=font-weight:400>New backend logic in </span><span style=font-weight:400>AdyenDonations</span><span style=font-weight:400> class and updated unit tests.</span></ul><p><span style=font-weight:400>🧪</span><strong> Action Required:</strong><ul><li style=font-weight:400><span style=font-weight:400>Remove any logic dependent on removed methods or config fields.</span><li style=font-weight:400><span style=font-weight:400>If custom frontend logic was used, migrate it to use Web Components v6.</span></ul><p><span style=font-weight:400>🆔</span><strong> Removal of </strong><strong>brand_code</strong><strong> Usage in Payment Object</strong><p><strong>Reference</strong><span style=font-weight:400>: YT - ECP-8663, PR</span><a href=https://github.com/Adyen/adyen-magento2/pull/2902> <span style=font-weight:400>#2902</span><span style=font-weight:400><br></span></a><span style=font-weight:400>The </span><span style=font-weight:400>brand_code</span><span style=font-weight:400> field, historically used to track transaction variants for Adyen HPP payments, has been removed from the </span><span style=font-weight:400>additional_information</span><span style=font-weight:400> field of the payment object.</span><p><span style=font-weight:400>With the </span><strong>separate payment methods</strong><span style=font-weight:400> project, each alternative payment method (APM) has its own </span><span style=font-weight:400>method</span><span style=font-weight:400> code, making </span><span style=font-weight:400>brand_code</span><span style=font-weight:400> redundant.</span><span style=font-weight:400><br></span><span style=font-weight:400>For identifying APM transaction variants, use </span><span style=font-weight:400>getAlternativePaymentMethodTxVariant()</span><span style=font-weight:400>.</span><p><span style=font-weight:400>This also impacts:</span><ul><li style=font-weight:400><span style=font-weight:400>REST and GraphQL schema (headless)</span><li style=font-weight:400><span style=font-weight:400>Documentation and field mappings</span></ul><p><strong>Action Required</strong><span style=font-weight:400>:</span><ul><li style=font-weight:400><span style=font-weight:400>Refactor any logic using </span><span style=font-weight:400>brand_code</span><span style=font-weight:400> for APMs</span><li style=font-weight:400><span style=font-weight:400>Update API consumers using the </span><span style=font-weight:400>brand_code</span><span style=font-weight:400> field in GraphQL or REST</span><li style=font-weight:400><span style=font-weight:400>Adjust reporting logic if it relies on this field</span></ul><p><span style=font-weight:400>🆔</span><strong> Corrected cc_type Population for Alternate Payment Methods</strong><p><strong>Reference</strong><span style=font-weight:400>: YT - ECP-9526, PR</span><a href=https://github.com/Adyen/adyen-magento2/pull/2885><span style=font-weight:400> #2885</span></a><p><span style=font-weight:400>Previously, alternative payment methods were also being stored under the </span><span style=font-weight:400>cc_type</span><span style=font-weight:400> entry in the database with the value of </span><span style=font-weight:400>BRAND_CODE</span><span style=font-weight:400>, which was incorrect. This led to multiple issues, including:</span><ul><li style=font-weight:400><strong>Data Accuracy:</strong><span style=font-weight:400> Misclassification of payment methods in records and reports.</span><li style=font-weight:400><strong>Integration Issues:</strong><span style=font-weight:400> Incorrect categorization could lead to inconsistencies in payment processing and reporting.</span><li style=font-weight:400><strong>Unintended Payment Processing Behavior:</strong><span style=font-weight:400> This issue did not block payments but could have led to unexpected processing outcomes.</span></ul><p><strong>Change Description:</strong><p><span style=font-weight:400>To resolve these issues, we have removed the setting of </span><span style=font-weight:400>cc_type</span><span style=font-weight:400> for alternative payment methods. This ensures that only credit card payments populate this field correctly, while other payment methods remain unaffected. </span><p><strong>Merchant Action Required:</strong><ul><li style=font-weight:400><span style=font-weight:400>Merchants should validate their payment records and reports to ensure proper categorization of payment methods.</span><li style=font-weight:400><span style=font-weight:400>No changes are required on the merchant’s side unless they were relying on </span><span style=font-weight:400>cc_type</span><span style=font-weight:400> for non-card payment methods. If so, they should adjust their reporting logic accordingly.</span></ul><p class=demoTitle> <p><span style=font-weight:400>🛒</span><strong> Magento Core Refactor: OrderRepository Constructor</strong><p><strong>Reference</strong><span style=font-weight:400>: YT - ECP-9684, PR</span><a href=https://github.com/Adyen/adyen-magento2/pull/2956> <span style=font-weight:400>#2956</span><span style=font-weight:400><br></span></a><span style=font-weight:400>Adobe changed the constructor signature of </span><span style=font-weight:400>OrderRepository</span><span style=font-weight:400>, which previously allowed for direct extension. This update now breaks plugin commands like </span><span style=font-weight:400>bin/magento setup:upgrade</span><span style=font-weight:400> or </span><span style=font-weight:400>di:compile</span><span style=font-weight:400>.</span><p><strong>Action Required</strong><span style=font-weight:400>:</span><ul><li style=font-weight:400><span style=font-weight:400>Ensure your environment is compatible with the updated constructor</span><li style=font-weight:400><span style=font-weight:400>Avoid directly extending core classes unless necessary</span></ul><p><span style=font-weight:400>🗣</span><strong>Restricted Additional Data Exposure in PaymentResponseHandler</strong><p><span style=font-weight:400>Previously, the </span><span style=font-weight:400>PaymentResponseHandler</span><span style=font-weight:400> returned the full </span><span style=font-weight:400>additionalData</span><span style=font-weight:400> field of a payment when the </span><span style=font-weight:400>RECEIVED</span><span style=font-weight:400> result code was received. However, the frontend </span><strong>only requires the </strong><strong>action</strong><strong> object</strong><span style=font-weight:400> within the response and does not need the entire </span><span style=font-weight:400>additionalData</span><span style=font-weight:400> block.</span><p><strong>Change Description:</strong><p><span style=font-weight:400>To mitigate security risks, the response from </span><span style=font-weight:400>PaymentResponseHandler</span><span style=font-weight:400> has been </span><strong>restricted to only include the </strong><strong>action</strong><strong> object.</strong><p><strong>Merchant Action Required:</strong><ul><li style=font-weight:400><span style=font-weight:400>No merchant-side changes are required unless custom logic was previously relying on the full </span><span style=font-weight:400>additionalData</span><span style=font-weight:400> object in the frontend.</span><li style=font-weight:400><span style=font-weight:400>If additional information is still required, merchants should retrieve it securely from their backend instead of relying on the frontend response.</span></ul><p><span style=font-weight:400>💳</span><strong> Unified Command Pool for Boleto</strong><p><strong>Reference</strong><span style=font-weight:400>: </span><em><span style=font-weight:400><br></span></em><span style=font-weight:400>Historically, the Boleto payment method used </span><strong>its own command pool</strong><span style=font-weight:400> to handle operations like </span><span style=font-weight:400>authorize</span><span style=font-weight:400>, </span><span style=font-weight:400>capture</span><span style=font-weight:400>, and </span><span style=font-weight:400>refund</span><span style=font-weight:400>. In V10, this has been refactored so that Boleto now uses the </span><strong>same </strong><strong>AdyenPaymentCommandPool</strong><span style=font-weight:400> as other alternative payment methods (APMs), eliminating the need for separate command pool definitions.</span><p><span style=font-weight:400>This streamlines logic and aligns Boleto behavior with all other APMs.</span><p><strong>Why it's breaking</strong><span style=font-weight:400>:</span><span style=font-weight:400><br></span><span style=font-weight:400>While this change doesn’t affect out-of-the-box functionality, it qualifies as a </span><strong>breaking change</strong><span style=font-weight:400> because:</span><ul><li style=font-weight:400><span style=font-weight:400>The underlying PHP classes handling Boleto's commands have changed.</span><li style=font-weight:400><span style=font-weight:400>Any merchant or partner who </span><strong>overrides or extends</strong><span style=font-weight:400> the old Boleto-specific command classes (e.g., for custom logging or validation) will need to refactor.</span></ul><p><strong>Action Required</strong><span style=font-weight:400>:</span><ul><li style=font-weight:400><span style=font-weight:400>✅ </span><em><span style=font-weight:400>If you don’t override Boleto commands</span></em><span style=font-weight:400>: No action required.</span><li style=font-weight:400><span style=font-weight:400>⚠️ </span><em><span style=font-weight:400>If you do override Boleto command classes</span></em><span style=font-weight:400>: Update your custom logic to use the </span><span style=font-weight:400>AdyenPaymentCommandPool</span><span style=font-weight:400> structure and inject the necessusiary dependencies there instead.</span></ul><h1><span style=font-weight:400> 🔁 Replacements for Deprecated Logic</span></h1><p><span style=font-weight:400>Removed Deprecated Methods:</span><table><tr><td><p><strong>Class Name</strong><td><p><strong>Methods/constants</strong><td><p><strong>Reason or Next Usage</strong><tr><td><p><span style=font-weight:400>OrderAdapter</span><td> <td><p><span style=font-weight:400>Use Magento\Sales\Api\Data\OrderInterface::getQuoteId() instead</span><span style=font-weight:400><br></span><span style=font-weight:400>The whole class is removed now.</span><tr><td><p><span style=font-weight:400>CheckoutDataBuilder</span><td><p><span style=font-weight:400>getOpenInvoiceData</span><td><p><span style=font-weight:400>Use Adyen\Payment\Helper\OpenInvoice::getOpenInvoiceDataForOrder() instead.</span><tr><td><p><span style=font-weight:400>CreditMemo</span><td><p><span style=font-weight:400>getAdyenCreditmemoByPspreference</span><td><p><span style=font-weight:400>Use AdyenCreditmemoRepositoryInterface::getByRefundWebhook() instead.</span><tr><td><p><span style=font-weight:400>OpenInvoice</span><td><p><span style=font-weight:400>formatInvoiceDiscount</span><td><p><span style=font-weight:400>Deprecated</span><tr><td><p><span style=font-weight:400>PaymentMethodUtil</span><td><p><span style=font-weight:400>OPEN_INVOICE_PAYMENT_METHODS - constant</span><td><p><span style=font-weight:400>Use payment method configuration field is_open_invoice defined in Adyen\Payment\etc\config.xml</span><tr><td><p><span style=font-weight:400>AdyenAmountCurrency</span><td><p><span style=font-weight:400>getDiscountTaxCompensationAmount</span><td><p><span style=font-weight:400>Deprecated</span><tr><td><p><span style=font-weight:400>AdyenAmountCurrency</span><td><p><span style=font-weight:400>getAmountIncludingTaxWithDiscount</span><td><p><span style=font-weight:400>Deprecated</span><tr><td><p><span style=font-weight:400>AdyenAmountCurrency</span><td><p><span style=font-weight:400>getAmountWithDiscount</span><td><p><span style=font-weight:400>Deprecated</span><tr><td><p><span style=font-weight:400>AdyenAmountCurrency</span><td><p><span style=font-weight:400>getCalculatedTaxPercentage</span><td><p><span style=font-weight:400>Deprecated</span><tr><td><p><span style=font-weight:400>Model/RecurringType</span><td> <td><p><span style=font-weight:400>Deprecated</span><tr><td><p><span style=font-weight:400>Model/Source/RecurringType</span><td> <td><p><span style=font-weight:400>Deprecated </span><tr><td><p><span style=font-weight:400>Data</span><td><p><span style=font-weight:400>getRecurringTypes</span><td><p><span style=font-weight:400>No usage</span><tr><td><p><span style=font-weight:400>TransportBuilder</span><td><p><span style=font-weight:400>setFrom</span><td><p><span style=font-weight:400>102.0.1 This function sets the from address but does not provide</span><tr><td><p><span style=font-weight:400>CreditMemo/Collection</span><td><p><span style=font-weight:400>getAdyenCreditMemosLinkedToMagentoInvoice</span><td><p><span style=font-weight:400>Deprecated </span><tr><td><p><span style=font-weight:400>ResourceModel/CreditMemo</span><td><p><span style=font-weight:400>getAdyenCreditmemoByPspreference</span><td><p><span style=font-weight:400>Use AdyenCreditmemoRepositoryInterface::getByRefundWebhook() instead.</span><tr><td><p><span style=font-weight:400>ResourceModel/CreditMemo</span><td><p><span style=font-weight:400>getAdyenCreditmemosByAdyenPaymentid</span><td><p><span style=font-weight:400>Use AdyenCreditmemoRepositoryInterface::getByAdyenOrderPaymentId() instead.</span><tr><td><p><span style=font-weight:400>ResourceModel/Invoice</span><td><p><span style=font-weight:400>getAdyenInvoicesByAdyenPaymentId</span><td><p><span style=font-weight:400>Use Adyen\Payment\Helper\Invoice::getAdyenInvoicesByAdyenPaymentId() method instead.</span><tr><td><p><span style=font-weight:400>ResourceModel/Invoice</span><td><p><span style=font-weight:400>getAdyenInvoiceByCaptureWebhook</span><td><p><span style=font-weight:400>Use AdyenInvoiceRepositoryInterface::getByCaptureWebhook() instead.</span><tr><td><p><span style=font-weight:400>BeforeShipmentObserver</span><td><p><span style=font-weight:400>AdyenHelper</span><td><p><span style=font-weight:400>Not being used</span><tr><td><p><span style=font-weight:400>BeforeShipmentObserver</span><td><p><span style=font-weight:400>isPaymentMethodAdyen</span><td><p><span style=font-weight:400>Use isAdyenPayment() method from Adyen\Payment\Helper\PaymentMethods.</span><tr><td><p><span style=font-weight:400>adyen-facilypay-3x-method.js</span><td> <td><p><span style=font-weight:400>This file will be removed on V10. Use adyen-facilypay-method.jsinstead.</span><tr><td><p><span style=font-weight:400>PaymentRequest</span><td> <td><p><span style=font-weight:400>Deprecated</span><tr><td><p><span style=font-weight:400>Config</span><td><p><span style=font-weight:400>isAlternativePaymentMethodsEnabled</span><td><p><span style=font-weight:400>Deprecated</span><tr><td><p><span style=font-weight:400>Data</span><td><p><span style=font-weight:400>PSP_REFERENCE_REGEX</span><td><p><span style=font-weight:400>constants not used</span><tr><td><p><span style=font-weight:400>Data</span><td><p><span style=font-weight:400>AFTERPAY</span><td><p><span style=font-weight:400>constants not used</span><tr><td><p><span style=font-weight:400>Data</span><td><p><span style=font-weight:400>AFTERPAY_TOUCH</span><td><p><span style=font-weight:400>constants not used</span><tr><td><p><span style=font-weight:400>Data</span><td><p><span style=font-weight:400>KLARNA</span><td><p><span style=font-weight:400>constants not used</span><tr><td><p><span style=font-weight:400>Data</span><td><p><span style=font-weight:400>isDemoMode</span><td><p><span style=font-weight:400>Use \Adyen\Payment\Helper\Config::isDemoMode</span><tr><td><p><span style=font-weight:400>Data</span><td><p><span style=font-weight:400>getHmac</span><td><p><span style=font-weight:400>No usage found</span><tr><td><p><span style=font-weight:400>Data</span><td><p><span style=font-weight:400>RATEPAY</span><td><p><span style=font-weight:400>constants not used</span><tr><td><p><span style=font-weight:400>Data</span><td><p><span style=font-weight:400>FACILYPAY</span><td><p><span style=font-weight:400>constants not used</span><tr><td><p><span style=font-weight:400>Data</span><td><p><span style=font-weight:400>AFFIRM</span><td><p><span style=font-weight:400>constants not used</span><tr><td><p><span style=font-weight:400>Data</span><td><p><span style=font-weight:400>CLEARPAY</span><td><p><span style=font-weight:400>constants not used</span><tr><td><p><span style=font-weight:400>Data</span><td><p><span style=font-weight:400>ZIP</span><td><p><span style=font-weight:400>constants not used</span><tr><td><p><span style=font-weight:400>Data</span><td><p><span style=font-weight:400>PAYBRIGHT</span><td><p><span style=font-weight:400>constants not used</span><tr><td><p><span style=font-weight:400>Data</span><td><p><span style=font-weight:400>SEPA</span><td><p><span style=font-weight:400>constants not used</span><tr><td><p><span style=font-weight:400>Data</span><td><p><span style=font-weight:400>MOLPAY</span><td><p><span style=font-weight:400>constants not used</span><tr><td><p><span style=font-weight:400>Data</span><td><p><span style=font-weight:400>ATOME</span><td><p><span style=font-weight:400>constants not used</span><tr><td><p><span style=font-weight:400>Data</span><td><p><span style=font-weight:400>WALLEYB2B</span><td><p><span style=font-weight:400>constants not used</span><tr><td><p><span style=font-weight:400>Data</span><td><p><span style=font-weight:400>WALLEY</span><td><p><span style=font-weight:400>constants not used</span><tr><td><p><span style=font-weight:400>Data</span><td><p><span style=font-weight:400>getPaymentRoutines</span><td><p><span style=font-weight:400>No usage found</span><tr><td><p><span style=font-weight:400>Data</span><td><p><span style=font-weight:400>getMinorUnitTaxPercent</span><td><p><span style=font-weight:400>No usage found</span><tr><td><p><span style=font-weight:400>Data</span><td><p><span style=font-weight:400>getAPIKey</span><td><p><span style=font-weight:400>Use Adyen\Payment\Helper\Config::getApiKey instead</span><tr><td><p><span style=font-weight:400>Data</span><td><p><span style=font-weight:400>getClientKey</span><td><p><span style=font-weight:400>Use getClientKey in Helper/Config</span><tr><td><p><span style=font-weight:400>Data</span><td><p><span style=font-weight:400>getWsUsername</span><td><p><span style=font-weight:400>No usage found</span><tr><td><p><span style=font-weight:400>Data</span><td><p><span style=font-weight:400>getLiveEndpointPrefix</span><td><p><span style=font-weight:400>No usage found</span><tr><td><p><span style=font-weight:400>Data</span><td><p><span style=font-weight:400>cancelOrder</span><td><p><span style=font-weight:400>Use cancelOrder Helper/Order</span><tr><td><p><span style=font-weight:400>Data</span><td><p><span style=font-weight:400>getModuleName</span><td><p><span style=font-weight:400>Use Helper/PlatfomInfo -> getModuleName</span><tr><td><p><span style=font-weight:400>Data</span><td><p><span style=font-weight:400>getModuleVersion</span><td><p><span style=font-weight:400>Use Helper/PlatfomInfo -> getModuleVersion</span><tr><td><p><span style=font-weight:400>Data</span><td><p><span style=font-weight:400>isPaymentMethodOpenInvoiceMethod</span><td><p><span style=font-weight:400>Use Adyen\Payment\Helper\PaymentMethods::isOpenInvoice() instead.</span><tr><td><p><span style=font-weight:400>Data</span><td><p><span style=font-weight:400>isPaymentMethodOfType</span><td><p><span style=font-weight:400>No usage found</span><tr><td><p><span style=font-weight:400>Data</span><td><p><span style=font-weight:400>isVatCategoryHigh</span><td><p><span style=font-weight:400>No usage found</span><tr><td><p><span style=font-weight:400>Data</span><td><p><span style=font-weight:400>showLogos</span><td><p><span style=font-weight:400>Use showLogos in Helper/PaymentMethods</span><tr><td><p><span style=font-weight:400>Data</span><td><p><span style=font-weight:400>getStoreLocale</span><td><p><span style=font-weight:400>Use getStoreLocale in Helper/Locale</span><tr><td><p><span style=font-weight:400>Data</span><td><p><span style=font-weight:400>formatLocaleCode</span><td><p><span style=font-weight:400>No usage found</span><tr><td><p><span style=font-weight:400>Data</span><td><p><span style=font-weight:400>getMagentoDetails</span><td><p><span style=font-weight:400>Use getMagentoDetails in Helper/PlatformInfo</span><tr><td><p><span style=font-weight:400>Data</span><td><p><span style=font-weight:400>buildRequestHeaders</span><td><p><span style=font-weight:400>Use buildRequestHeaders in Helper/PlatformInfo</span><tr><td><p><span style=font-weight:400>Data</span><td><p><span style=font-weight:400>buildApplicationInfo</span><td><p><span style=font-weight:400>Use buildApplicationInfo in Helper/PlatformInfo</span><tr><td><p><span style=font-weight:400>Data</span><td><p><span style=font-weight:400>getOrigin</span><td><p><span style=font-weight:400>Deprecated</span><tr><td><p><span style=font-weight:400>Data</span><td><p><span style=font-weight:400>getOriginKeyForBaseUrl</span><td><p><span style=font-weight:400>please use getClientKey instead</span><tr><td><p><span style=font-weight:400>Data</span><td><p><span style=font-weight:400>getOriginKeyForOrigin</span><td><p><span style=font-weight:400>No usage found</span><tr><td><p><span style=font-weight:400>Data</span><td><p><span style=font-weight:400>getCustomerId</span><td><p><span style=font-weight:400>No usage found</span><tr><td><p><span style=font-weight:400>Data</span><td><p><span style=font-weight:400>isHppVaultEnabled</span><td><p><span style=font-weight:400>No usage found</span><tr><td><p><span style=font-weight:400>Data</span><td><p><span style=font-weight:400>createAdyenCheckoutService</span><td><p><span style=font-weight:400>useinitializePaymentsApi, or initializeModificationsApibased on your case</span><tr><td><p><span style=font-weight:400>Data</span><td><p><span style=font-weight:400>createAdyenRecurringService</span><td><p><span style=font-weight:400>useinitializeRecurringApi()`</span><tr><td><p><span style=font-weight:400>Data</span><td><p><span style=font-weight:400>formatDate</span><td><p><span style=font-weight:400>Deprecated</span><tr><td><p><span style=font-weight:400>Data</span><td><p><span style=font-weight:400>buildThreeDS2ProcessResponseJson</span><td><p><span style=font-weight:400>No usage found</span><tr><td><p><span style=font-weight:400>Data</span><td><p><span style=font-weight:400>getCurrentLocaleCode</span><td><p><span style=font-weight:400>Use getCurrentLocaleCode in Helper/Locale</span></table><p class=demoTitle> <h1><span style=font-weight:400>Changes & Notes</span></h1><p><span style=font-weight:400>🗣</span><strong> Payment Method Title Localization</strong><p><strong>Reference</strong><span style=font-weight:400>: </span><em><span style=font-weight:400>(YT - ECP-9564 PR - </span></em><a href=https://github.com/Adyen/adyen-magento2/pull/2923><em><span style=font-weight:400>#2923</span></em></a><em><span style=font-weight:400>)</span></em><p><span style=font-weight:400>Previously, payment method titles were hardcoded in </span><span style=font-weight:400>config.xml</span><span style=font-weight:400>, which prevented proper localization of the payment method names in the checkout, even when </span><span style=font-weight:400>shopperLocale</span><span style=font-weight:400> was passed to the </span><span style=font-weight:400>/paymentMethods</span><span style=font-weight:400> API call.</span><p><strong>What's changed?</strong><strong><br></strong><span style=font-weight:400>To support localized payment method names, the frontend should now use the </span><span style=font-weight:400>name</span><span style=font-weight:400> field provided in the </span><span style=font-weight:400>/paymentMethods</span><span style=font-weight:400> response. These titles are dynamically localized based on the </span><span style=font-weight:400>shopperLocale</span><span style=font-weight:400> passed in the API call.</span><p><span style=font-weight:400>If the </span><span style=font-weight:400>shopperLocale</span><span style=font-weight:400> is set to </span><span style=font-weight:400>"fi_FI"</span><span style=font-weight:400>, the names returned will be localized accordingly (if supported by Adyen).</span><p><strong>Action Required:</strong><ul><li style=font-weight:400><span style=font-weight:400>Remove hardcoded titles from </span><span style=font-weight:400>config.xml</span><span style=font-weight:400>.</span><li style=font-weight:400><span style=font-weight:400>Update your checkout frontend to display payment method titles using the </span><span style=font-weight:400>name</span><span style=font-weight:400> field from the </span><span style=font-weight:400>/paymentMethods</span><span style=font-weight:400> response</span></ul><p><span style=font-weight:400>🗣</span><strong>Removed Legacy PayPal Schema Dependencies</strong><p><strong>Reference</strong><span style=font-weight:400>: </span><em><span style=font-weight:400>(YT - ECP-9622 PR - </span></em><a href=https://github.com/Adyen/adyen-magento2/pull/2806><em><span style=font-weight:400>#2806</span></em></a><em><span style=font-weight:400>)</span></em><p><span style=font-weight:400>Our plugin previously introduced an </span><span style=font-weight:400>agreement_data</span><span style=font-weight:400> column in the </span><span style=font-weight:400>paypal_billing_agreement</span><span style=font-weight:400> table. However, as we have officially </span><strong>dropped support for the default Magento PayPal module</strong><span style=font-weight:400>, this table and its schema modifications are no longer relevant.</span><p><strong>Change Description:</strong><ul><li style=font-weight:400><span style=font-weight:400>The </span><span style=font-weight:400>agreement_data</span><span style=font-weight:400> column and related schema dependencies have been removed.</span><li style=font-weight:400><span style=font-weight:400>The </span><strong>VaultMigration data patch</strong><span style=font-weight:400> was previously adding this column dependency; this has now been cleaned up in an external PR.</span><li style=font-weight:400><span style=font-weight:400>This change helps avoid issues during setup or upgrade when the default PayPal module is not installed.</span></ul><p><strong>Impact:</strong><ul><li style=font-weight:400><strong>No direct impact</strong><span style=font-weight:400> on ecommerce functionality or checkout flows.</span><li style=font-weight:400><span style=font-weight:400>Reduces potential for </span><strong>installation/upgrade failures</strong><span style=font-weight:400>.</span><li style=font-weight:400><span style=font-weight:400>Helps prevent </span><strong>unnecessary schema bloat</strong><span style=font-weight:400> by cleaning up obsolete PayPal references.</span></ul><p><strong>Merchant Action Required:</strong><ul><li style=font-weight:400><span style=font-weight:400>If you've customized or rely on the </span><span style=font-weight:400>paypal_billing_agreement</span><span style=font-weight:400> table (e.g., for reporting), verify if those references are still needed.</span><li style=font-weight:400><span style=font-weight:400>No action is needed for standard setups not using the legacy PayPal module.</span></ul><h1><span style=font-weight:400>🧹 Internal Refactors & Cleanups</span></h1><p><span style=font-weight:400>🧼</span><strong> Data Helper Refactored for Clarity and Maintainability</strong><p><strong>Reference</strong><span style=font-weight:400>: </span><em><span style=font-weight:400>(YT - ECP-9320 PR - </span></em><a href=https://github.com/Adyen/adyen-magento2/pull/2966><em><span style=font-weight:400>#2966</span></em></a><em><span style=font-weight:400>)</span></em><p><strong>Context</strong><span style=font-weight:400>: The </span><span style=font-weight:400>Adyen\Payment\Helper\Data</span><span style=font-weight:400> class had grown to include unrelated responsibilities such as config logic, formatting utilities, request building, and API key handling.</span><p><strong>Changes</strong><span style=font-weight:400>:</span><ul><li style=font-weight:400><span style=font-weight:400>Deprecated and unused methods were removed.</span><li style=font-weight:400><span style=font-weight:400>Methods were redistributed to more appropriate helper classes:</span></li><ul><li style=font-weight:400><span style=font-weight:400>🔑 API key handling → </span><span style=font-weight:400>Helper\Config</span><li style=font-weight:400><span style=font-weight:400>🌐 Platform metadata → </span><span style=font-weight:400>Helper\PlatformInfo</span><li style=font-weight:400><span style=font-weight:400>💳 Payment method logic → </span><span style=font-weight:400>Helper\PaymentMethods</span><li style=font-weight:400><span style=font-weight:400>🌍 Locale helpers → </span><span style=font-weight:400>Helper\Locale</span></ul></ul><p><span style=font-weight:400>Where no suitable existing class was found, </span><strong>new helpers</strong><span style=font-weight:400> were introduced to encapsulate single responsibilities.</span><p><strong>Goal</strong><span style=font-weight:400>: Improve testability, readability, and long-term maintainability of the plugin codebase.</span><p><strong>Impact</strong><span style=font-weight:400>:</span><ul><li style=font-weight:400><span style=font-weight:400>No merchant-side changes required.</span><li style=font-weight:400><span style=font-weight:400>⚠️ If you were </span><strong>extending or calling </strong><strong>Helper\Data</strong><strong> methods directly</strong><span style=font-weight:400>, please update your code to use the new class paths instead.</span></ul><p><strong>Unified Return Type for Transaction Client Classes</strong><p><strong>Reference</strong><span style=font-weight:400>: </span><em><span style=font-weight:400>(YT - ECP-9639 PR - </span></em><a href=https://github.com/Adyen/adyen-magento2/pull/2910><em><span style=font-weight:400>#2910</span></em></a><em><span style=font-weight:400>)</span></em><p><span style=font-weight:400>The transaction-related classes implementing </span><span style=font-weight:400>ClientInterface</span><span style=font-weight:400> (such as </span><span style=font-weight:400>TransactionCapture</span><span style=font-weight:400>, </span><span style=font-weight:400>TransactionPayment</span><span style=font-weight:400>, etc.) have been refactored for improved consistency and maintainability.</span><p><strong>Problem Description:</strong><ul><li style=font-weight:400><span style=font-weight:400>Previously, these classes returned either a </span><strong>single API response</strong><span style=font-weight:400> (for standard flows) or a </span><strong>multi-dimensional array</strong><span style=font-weight:400> (for partial payments).</span><li style=font-weight:400><span style=font-weight:400>For example, </span><span style=font-weight:400>TransactionCapture</span><span style=font-weight:400> returned a single response unless a partial payment was involved, resulting in </span><strong>conditional return types</strong><span style=font-weight:400> that increased complexity in downstream response handling (validators, handlers, etc.).</span><li style=font-weight:400><span style=font-weight:400>Additionally, </span><span style=font-weight:400>TransactionPayment</span><span style=font-weight:400> injected a </span><span style=font-weight:400>hasOnlyGiftCards</span><span style=font-weight:400> key into the response array, which broke iterability and created coupling concerns.</span></ul><p><strong>Change Description:</strong><ul><li style=font-weight:400><span style=font-weight:400>All client classes now </span><strong>consistently return a response collection</strong><span style=font-weight:400> (multi-dimensional array), even if it contains only one response.</span><li style=font-weight:400><span style=font-weight:400>The </span><span style=font-weight:400>hasOnlyGiftCards</span><span style=font-weight:400> key has been </span><strong>removed</strong><span style=font-weight:400> from the response structure. If still needed, it should be accessed separately from a dedicated location or context object.</span><li style=font-weight:400><span style=font-weight:400>Related downstream response validators and handlers have been refactored to support the new unified structure.</span><li style=font-weight:400><span style=font-weight:400>Unused or overly complex code paths in the </span><span style=font-weight:400>Gateway</span><span style=font-weight:400> and </span><span style=font-weight:400>Transaction</span><span style=font-weight:400> layers have been removed or simplified to improve maintainability.</span></ul><p><strong>Impact:</strong><ul><li style=font-weight:400><strong>Internal consistency is improved</strong><span style=font-weight:400>, making the plugin more robust for features like partial payments and wallet integrations.</span><li style=font-weight:400><span style=font-weight:400>May impact any merchant or partner who has </span><strong>custom logic relying on specific response shapes</strong><span style=font-weight:400> from transaction-related classes.</span></ul><p><strong>Merchant Action Required:</strong><ul><li style=font-weight:400><span style=font-weight:400>Merchants using the plugin as-is do </span><strong>not need to take any action</strong><span style=font-weight:400>.</span><li style=font-weight:400><span style=font-weight:400>Partners or merchants with </span><strong>custom extensions to gateway classes</strong><span style=font-weight:400> should review their implementations to ensure compatibility with the unified response format.</span><li style=font-weight:400><span style=font-weight:400>All internal and public methods now expect response collections, even for single-payment flows.</span></ul><h1><span style=font-weight:400>🧪 Developer Experience & Tooling Improvements</span></h1><p><span style=font-weight:400>🧠</span><strong> PHPStan Integration for Static Analysis</strong><p><strong>Reference</strong><span style=font-weight:400>: </span><em><span style=font-weight:400>(YT - ECP-9489 PR - </span></em><a href=https://github.com/Adyen/adyen-magento2/pull/2843><em><span style=font-weight:400>#2843</span></em></a><em><span style=font-weight:400>)</span></em><em><span style=font-weight:400><br></span></em><span style=font-weight:400>To improve long-term maintainability and catch issues like </span><strong>deprecated dynamic property declarations</strong><span style=font-weight:400>, V10 introduces </span><strong>PHPStan</strong><span style=font-weight:400> as a static analysis tool.</span><p><span style=font-weight:400>🧰</span><strong> What’s Changed:</strong><ul><li style=font-weight:400><span style=font-weight:400>PHPStan is now integrated into the plugin’s CI/CD pipeline.</span><li style=font-weight:400><span style=font-weight:400>Helps detect issues such as:</span></li><ul><li style=font-weight:400><span style=font-weight:400>Dynamic property declarations (deprecated in newer PHP versions)</span><li style=font-weight:400><span style=font-weight:400>Type mismatches</span><li style=font-weight:400><span style=font-weight:400>Dead or unreachable code</span><li style=font-weight:400><span style=font-weight:400>Deprecated usage patterns</span></ul><li style=font-weight:400><span style=font-weight:400>Several low-level bugs and regressions discovered by PHPStan have already been fixed.</span></ul><p><span style=font-weight:400>🧾</span><strong> Action Taken:</strong><ul><li style=font-weight:400><span style=font-weight:400>PHPStan baseline was established and included in the build process.</span><li style=font-weight:400><span style=font-weight:400>Follow-up ticket created to address remaining complex/static issues found during analysis.</span></ul><p><span style=font-weight:400>🧑💻</span><strong> Action Required (for contributors only):</strong><ul><li style=font-weight:400><span style=font-weight:400>Contributors should run PHPStan locally before pushing PRs.</span><li style=font-weight:400><span style=font-weight:400>Follow updated CONTRIBUTING.md (add link if exists) for PHPStan usage instructions and level/baseline configuration.</span></ul>
[ECP-9569] Removing deprecations from Version 10 by @khushboo-singhvi in https://github.com/Adyen/adyen-magento2/pull/2976
<!-- Release notes generated using configuration in .github/release.yml at develop-10 -->
Current Checkout API version: v71 Current Checkout Component version: 6.13.1
Navigate to Adyen Docs for Set-up, Upgrade or Customisations. Full Changelog: https://github.com/Adyen/adyen-magento2/compare/v9.19.1...v10.0.0-rc1
<!-- Release notes generated using configuration in .github/release.yml at main-9 -->
<!-- Release notes generated using configuration in .github/release.yml at main-9 -->
Full Changelog: https://github.com/Adyen/adyen-magento2/compare/v9.20.16...v9.20.17
Full Changelog: v9.20.16...v9.20.17
[ECP-9955-V9] Add jcb_applepay to manual capture supported payment methods by @shubhamk67 in #3317
Current Checkout API version: v71
Current Checkout Component version: 5.71.3
Full Changelog: v9.20.15...v9.20.16
<!-- Release notes generated using configuration in .github/release.yml at main-9 -->
Current Checkout API version: v71 Current Checkout Component version: 5.71.3
Full Changelog: https://github.com/Adyen/adyen-magento2/compare/v9.20.15...v9.20.16
[ECP-9949-V9] Fix TWINT tokenization by @shubhamk67 in #3301
Full Changelog: v9.20.14...v9.20.15
<!-- Release notes generated using configuration in .github/release.yml at main-9 -->
Full Changelog: https://github.com/Adyen/adyen-magento2/compare/v9.20.14...v9.20.15
[ECP-9943-V9] Fix installment data loss during GraphQL placeOrder by @shubhamk67 in #3292
Full Changelog: v9.20.13...v9.20.14
<!-- Release notes generated using configuration in .github/release.yml at main-9 -->
Full Changelog: https://github.com/Adyen/adyen-magento2/compare/v9.20.13...v9.20.14
[ECP-9925-v9] Display error message when 3DS2 challenge is cancelled by @shubhamk67 in #3268
Current Checkout API version: v71
Current Checkout Component version: 5.71.3
Full Changelog: v9.20.12...v9.20.13
<!-- Release notes generated using configuration in .github/release.yml at main-9 -->
<!-- Release notes generated using configuration in .github/release.yml at main-9 -->
Current Checkout API version: v71 Current Checkout Component version: 5.71.3
Full Changelog: https://github.com/Adyen/adyen-magento2/compare/v9.20.11...v9.20.12
<!-- Release notes generated using configuration in .github/release.yml at main-9 -->
<!-- Release notes generated using configuration in .github/release.yml at main-9 -->
Current Checkout API version: v71 Current Checkout Component version: 5.71.3
Full Changelog: https://github.com/Adyen/adyen-magento2/compare/v9.20.10...v9.20.11
<!-- Release notes generated using configuration in .github/release.yml at main-9 -->
<!-- Release notes generated using configuration in .github/release.yml at main-9 -->
Current Checkout API version: v71 Current Checkout Component version: 5.71.3
Full Changelog: https://github.com/Adyen/adyen-magento2/compare/v9.20.9...v9.20.10
<!-- Release notes generated using configuration in .github/release.yml at main-9 -->
<!-- Release notes generated using configuration in .github/release.yml at main-9 -->
Current Checkout API version: v71 Current Checkout Component version: 5.71.3
Full Changelog: https://github.com/Adyen/adyen-magento2/compare/v9.20.8...v9.20.9
<!-- Release notes generated using configuration in .github/release.yml at main-9 -->
<!-- Release notes generated using configuration in .github/release.yml at main-9 -->
Current Checkout API version: v71 Current Checkout Component version: 5.71.3
Full Changelog: https://github.com/Adyen/adyen-magento2/compare/v9.20.7...v9.20.8
<!-- Release notes generated using configuration in .github/release.yml at main-9 -->
<!-- Release notes generated using configuration in .github/release.yml at main-9 -->
Full Changelog: https://github.com/Adyen/adyen-magento2/compare/v9.20.6...v9.20.7
Current Checkout API version: v71 Current Checkout Component version: 5.71.3
<!-- Release notes generated using configuration in .github/release.yml at main-9 -->
<!-- Release notes generated using configuration in .github/release.yml at main-9 -->
Full Changelog: https://github.com/Adyen/adyen-magento2/compare/v9.20.5...v9.20.6
Current Checkout API version: v71 Current Checkout Component version: 5.71.3
<!-- Release notes generated using configuration in .github/release.yml at main-9 -->
<!-- Release notes generated using configuration in .github/release.yml at main-9 -->
Full Changelog: https://github.com/Adyen/adyen-magento2/compare/v9.20.4...v9.20.5
Current Checkout API version: v71 Current Checkout Component version: 5.71.3
<!-- Release notes generated using configuration in .github/release.yml at main-9 -->
<!-- Release notes generated using configuration in .github/release.yml at main-9 -->
Current Checkout API version: v71 Current Checkout Component version: 5.71.3
Full Changelog: https://github.com/Adyen/adyen-magento2/compare/v9.20.3...v9.20.4
<!-- Release notes generated using configuration in .github/release.yml at main-9 -->
<!-- Release notes generated using configuration in .github/release.yml at main-9 -->
Current Checkout API version: v71 Current Checkout Component version: 5.71.3
Full Changelog: https://github.com/Adyen/adyen-magento2/compare/v9.20.2...v9.20.3
<!-- Release notes generated using configuration in .github/release.yml at main-9 -->
<!-- Release notes generated using configuration in .github/release.yml at main-9 -->
Current Checkout API version: v71 Current Checkout Component version: 5.71.3
Full Changelog: https://github.com/Adyen/adyen-magento2/compare/v9.20.1...v9.20.2
<!-- Release notes generated using configuration in .github/release.yml at main-9 -->
<!-- Release notes generated using configuration in .github/release.yml at main-9 -->
Full Changelog: https://github.com/Adyen/adyen-magento2/compare/v9.20.0...v9.20.1
Current Checkout API version: v71 Current Checkout Component version: 5.71.3
<!-- Release notes generated using configuration in .github/release.yml at main-9 -->
<!-- Release notes generated using configuration in .github/release.yml at main-9 -->
Current Checkout API version: v71 Current Checkout Component version: 5.71.3
Full Changelog: https://github.com/Adyen/adyen-magento2/compare/v9.19.2...v9.20.0
<!-- Release notes generated using configuration in .github/release.yml at main -->
<!-- Release notes generated using configuration in .github/release.yml at main -->
Full Changelog: https://github.com/Adyen/adyen-magento2/compare/v9.19.1...v9.19.2
<!-- Release notes generated using configuration in .github/release.yml at main -->
<!-- Release notes generated using configuration in .github/release.yml at main -->
Full Changelog: https://github.com/Adyen/adyen-magento2/compare/v9.19.0...v9.19.1
<!-- Release notes generated using configuration in .github/release.yml at main -->
<!-- Release notes generated using configuration in .github/release.yml at main -->
Current Checkout API version: v71 Current Checkout Component version: 5.71.3
Full Changelog: https://github.com/Adyen/adyen-magento2/compare/v9.18.1...v9.19.0
<!-- Release notes generated using configuration in .github/release.yml at main -->
<!-- Release notes generated using configuration in .github/release.yml at main -->
Current Checkout API version: v71 Current Checkout Component version: 5.71.3
Full Changelog: https://github.com/Adyen/adyen-magento2/compare/v9.18.0...v9.18.1
<!-- Release notes generated using configuration in .github/release.yml at main -->
<!-- Release notes generated using configuration in .github/release.yml at main -->
Current Checkout API version: v71 Current Checkout Component version: 5.71.2
Full Changelog: https://github.com/Adyen/adyen-magento2/compare/v9.17.1...v9.18.0
<!-- Release notes generated using configuration in .github/release.yml at main -->
<!-- Release notes generated using configuration in .github/release.yml at main -->
Current Checkout API version: v71 Current Checkout Component version: 5.71.2
Full Changelog: https://github.com/Adyen/adyen-magento2/compare/v9.17.0...v9.17.1
<!-- Release notes generated using configuration in .github/release.yml at main -->
<!-- Release notes generated using configuration in .github/release.yml at main -->
Current Checkout API version: v71 Current Checkout Component version: 5.71.2
Full Changelog: https://github.com/Adyen/adyen-magento2/compare/v9.16.1...v9.17.0
One column per quarter.