---
title: "Release notes"
url: "https://docs.adyen.com/plugins/release-notes"
source_url: "https://docs.adyen.com/plugins/release-notes.md"
canonical: "https://docs.adyen.com/plugins/release-notes"
section: "release_note"
last_modified: "2024-12-06T16:59:00+01:00"
language: "en"
---

# Release notes

On this page, you can find the release notes for the following Adyen plugins:

* [Salesforce Commerce Cloud (SFCC)](/plugins/salesforce-commerce-cloud)
* [Salesforce Order Management System](/plugins/salesforce-order-management-system)
* [Shopware 6](/plugins/shopware-6)
* [NetSuite](/plugins/netsuite) and [NetSuite Reconciliation Bundle](/plugins/netsuite/reconciliation-bundle)
* [Cegid Retail Y2](/plugins/cegid-retail-y2)

For [Adobe Commerce](/plugins/adobe-commerce), from v9.9.1 onwards, we document the minor and patch releases exclusively on GitHub:

* [Adobe Commerce plugin](https://github.com/Adyen/adyen-magento2/releases)
* [Adobe Commerce express checkout module](https://github.com/Adyen/adyen-magento2-express-checkout/releases)

There is no fixed time period between our plugin releases. We release if we have an urgent fix, or when we have accumulated a certain amount of changes to release. We recommend upgrading your plugin when we release to benefit from new features and bug fixes.

For technical details about our [Salesforce Commerce Cloud](https://github.com/Adyen/adyen-salesforce-commerce-cloud/releases), and [Shopware 6](https://github.com/Adyen/adyen-shopware6/releases) releases, refer to the release notes on GitHub.

[![](/user/themes/adyen-docs/assets/icons/rss.svg) Get updates by RSS](/plugins/release-notes.xml)

## Available filters

Plugin name..., Version..., Release date...

## 2026-05-19 — Salesforce B2C Commerce - Composable Storefront — Version 4.3.0

### New

* Google Pay Express Checkout: Added Google Pay Express flow allowing shoppers to check out directly from product and cart pages without going through the standard checkout.
* Donations: Integrated Adyen Donations, enabling shoppers to contribute to charitable causes after completing a purchase.
* Card Installments: Added support for card installment payments, letting shoppers split eligible card purchases into multiple installments.
* UPI Payments: Enabled UPI as a payment method for shoppers in supported regions.
* Level 2/3 Data: Added Level 2/3 card data submission for enhanced transaction reporting and potentially lower interchange fees on commercial cards.
* Iris Payment Method: Enabled Iris (Greek interbank) payments.
* Configurable Adyen Options: Adyen configuration can now be passed as an options object, with environment variables used as a fallback — providing more flexibility for multi-environment setups.

### Improved

* React Query in Hooks: Refactored data-fetching hooks to use React Query, improving caching, request deduplication, and overall performance.
* Cleanup of Unused React Contexts: Removed unused React contexts to simplify the codebase and reduce bundle size.
* NPM Package Upgrades: Upgraded npm dependencies to their latest compatible versions for security and stability.
* Adyen Drop-in version: 6.32.0

## 2026-04-16 — Cegid Retail Y2 — Version 2.1.26

*\<p>Go to the \<a href="https\://docs.adyen.com/plugins/cegid-retail-y2/set-up-the-plugin/">Cegid Retail Y2 plugin documentation page\</a> to download the new version. We strongly recommend to remove the old version of the plugin before installing the new version.\</p>*

### Fixed

* To avoid issues with printing Japanese receipts, we ensured the `installmentPayment` value does not exceed 17 characters.

## 2026-03-25 — Cegid Retail Y2 — Version 2.1.24

*\<p>Go to the \<a href="https\://docs.adyen.com/plugins/cegid-retail-y2/set-up-the-plugin/">Cegid Retail Y2 plugin documentation page\</a> to download the new version. We strongly recommend to remove the old version of the plugin before installing the new version.\</p>*

### Improved

* The Adyen root certificates have been added into the installer, to [protect local communications](https://docs.adyen.com/point-of-sale/design-your-integration/choose-your-architecture/local#protect-communications).

### Fixed

* The same transaction reference can no longer be generated twice. This change accommodates future use cases that require unique values.

* We fixed an issue where the receipt was printed repeatedly when a manual signature was provided, and an exception happened between the terminal and CPOS.

* We fixed some DCPP logging issues in `LogParamsIn` and `LogParamsOut` with incorrect value formatting (for example, decimals) in the log files.

* We now block attempts to void referenced refunds and provide the user the message "VOID OF REFERENCED REFUND NOT ALLOWED".

## 2026-03-18 — Salesforce Commerce Cloud - B2C Commerce — Version 26.2.0

*\<p>The features introduced in this release are applicable for integrations with Storefront Reference Architecture (SFRA) versions 5, 6 and 7.\</p>*

### New

* The cartridge now uses [Web Components v6.30.0](https://docs.adyen.com/online-payments/release-notes#releaseNote=2026-02-03-web-componentsdrop-in-6.30.0).

### Improved

* Instead of a blank model, a spinner is now shown while additional details are processed during a transaction.

* We implemented a new approach in creating Klarna orders.

* We improved the robustness of the logic and handling with regard to setting payment method data, managing amounts during the checkout process, gift cards, and dynamically rendering payment methods after a shipping method change.

### Fixed

We solved the following issues:

* With partial payments in the `paymentFromComponent` flow, gift cards used in the transaction were not cancelled correctly when the primary payment method failed.

* Payment method components did not show the updated amount to be paid after a gift card was redeemed.

* After redeeming a gift card, Click to Pay showed the wrong amount and missed the shopper's email address.

* Level 2/3 enhanced scheme data amounts were not always calculated correctly due to not taking shipping line items into account.

* With Apple Pay, the web component did not always resolve correctly after payment completion.

* If a shopper changed the shipping method, the component did not reflect the related change in the amount.

## 2026-03-13 — Salesforce B2C Commerce - Composable Storefront — Version 4.2.1

### New

In the [setup of your Composable Storefront with Adyen](/plugins/salesforce-commerce-cloud/composable-storefront/install-and-set-up-the-package), you can now implement the following hooks, to improve the user experience:

* `useHandleBackNavigation`: Handles the cleanup when a shopper uses the browser's back button to navigate from a redirect payment page back to the checkout page. This prevents orphaned orders and ensures proper state management.

* `useCheckoutErrorRecovery`: Detects checkout failures, refetches the basket, and forces a clean remount of the AdyenCheckout component.

### Fixed

We fixed an issue where in a multi-site setup the URL was generated only for the default site, instead of for the site that was actually used.

## 2026-01-21 — Salesforce Commerce Cloud - B2C Commerce — Version 26.1.0

### Breaking Changes

* A new webhook cartridge is now responsible for processing Adyen webhooks. [Update your cartridge path](/plugins/salesforce-commerce-cloud/sfra/set-up-the-cartridge?plugin=Salesforce%20SFRA\&integration=cartridge\&version=26.1.0#step-1-set-up-the-cartridge-path) to make sure the new cartridge is correctly integrated and that your webhook endpoints are properly set up.

### New

* Payment method: PayTo.
* Customer service agents can now place orders on behalf of shoppers using the Customer Service Center. Refer to our [documentation](/plugins/salesforce-commerce-cloud/sfra/set-up-the-cartridge?plugin=Salesforce%20SFRA\&integration=cartridge\&version=26.1.0#customer-service-center-orders) to learn how to place an order.
* You can now enable Apple Pay, PayPal, and Google Pay express on the shipping page.
* The `isAvailable()` method is now used while rendering a payment method component.

### Removed

* Removed an unused empty file from the repository.
* Removed the default value for the Ratepay ID so the script is now triggered when RatePay is not enabled.

### Improved

* Moved partial payment data to the basket level to prevent reaching quota limits.

### Fixed

* Fixed an issue to ensure payment requests are successfully sent when using promotions.
* Fixed an issue where failure scenarios were not properly handled for gift cards or transactions without an action.

## 2026-01-21 — Salesforce Order Management System — Version 3.4.0

### Improved

* For Scalapay payments with multiple partial captures, refund requests now include the `capturePspReference` to successfully process refunds.

## 2026-01-20 — Salesforce B2C Commerce - Composable Storefront — Version 4.2.0

### New

* Apple Pay express on the product detail page.
* PayPal express on cart and product detail page.

## 2025-12-09 — Salesforce B2C Commerce - Composable Storefront — Version 4.1.1

### Fixed

* For open invoice payment methods, we adjusted how the `amountExcludingTax` and `taxPercentage` line item fields are populated. This fixes an issue for transactions with gross taxation where the tax and amount values were incorrectly populated.

## 2025-12-03 — Salesforce B2C Commerce - Composable Storefront — Version 4.1.0

### New

* Supported payment method: Click to Pay. Refer to the [payment method setup guide](/plugins/salesforce-commerce-cloud/composable-storefront/set-up-payment-methods#click-to-pay) to learn about its required configuration.

## 2025-11-14 — Salesforce B2C Commerce - Composable Storefront — Version 4.0.0

### Breaking Changes

* This version introduces the **[int\_adyen\_PWA](https://github.com/Adyen/adyen-salesforce-headless-commerce-pwa/tree/main/packages/int_adyen_PWA)** cartridge for the Salesforce Commerce Cloud (SFCC) Business Manager. This cartridge is a companion to the npm package, which is used in the Salesforce Retail React App.The cartridge enhances the integration by:

  * Adding features that are not fully supported by the Salesforce SCAPI API.
  * Improving webhook handling.

### New

* Supported payment method: gift cards.
* The integration now uses [Web Drop-in v6](/online-payments/release-notes?title%5B0%5D=Web%20Components%2FDrop-in\&version%5B0%5D=6.0.0) that offers an enhanced user experience, improved performance, and increased design flexibility.

### Changed

* Dependency versions:

  | Name                             | Version     |
  | -------------------------------- | ----------- |
  | Adyen Web Drop-in                | 6.21.0      |
  | Adyen Node.js API library        | 29.1.0      |
  | Salesforce Retail React PWA      | v8          |
  | Salesforce Managed Runtime: Node | 22 or later |
  | Salesforce Managed Runtime: npm  | 11 or later |

### Updating

* When updating to this version, you need to install the companion cartridge. For the integration to work correctly, follow the steps in the installation guide for this version:

  1. Make sure that you have the [pre-requisites](/plugins/salesforce-commerce-cloud/composable-storefront/install-and-set-up-the-package?plugin=Salesforce%20Composable%20Storefront\&integration=package\&version=4.0.0#requirements).
  2. [Install the new cartridge](/plugins/salesforce-commerce-cloud/composable-storefront/install-and-set-up-the-package?plugin=Salesforce%20Composable%20Storefront\&integration=package\&version=4.0.0#install-the-cartridge).
  3. [Install the PWA app](/plugins/salesforce-commerce-cloud/composable-storefront/install-and-set-up-the-package?plugin=Salesforce%20Composable%20Storefront\&integration=package\&version=4.0.0#install-the-adyen-package-in-your-local-pwa-app), this version introduces changes to how the checkout component is rendered.
  4. [Configure the AdyenCheckout component](/plugins/salesforce-commerce-cloud/composable-storefront/install-and-set-up-the-package?plugin=Salesforce%20Composable%20Storefront\&integration=package\&version=4.0.0#configure).

## 2025-11-10 — Salesforce B2C Commerce - Composable Storefront — Version 3.0.3

### Fixed

* For payments where the shopper is redirected to another page to complete the payment, when the payment is refused or failed, the redirect page no longer keeps loading and sending indefinite requests. Instead, the shopper is now redirected to an error page.

## 2025-11-07 — Salesforce B2C Commerce - Composable Storefront — Version 3.0.2

### New

* You can now use the **YOUR\_SITE\_ID\_ADYEN\_NATIVE\_3DS** [environment variable](/plugins/salesforce-commerce-cloud/composable-storefront/install-and-set-up-the-package?plugin=Salesforce%20Composable%20Storefront\&integration=package\&version=3.0.2#set-environment-variables) to indicate your preferred flow for 3D Secure 2 authentication. This lets you use the redirect flow if you do not want to adjust your [Content Security Policy (CSP)](https://developer.mozilla.org/en-US/docs/Web/HTTP/Guides/CSP) to load the 3D Secure 2 interfaces natively.

## 2025-11-04 — Salesforce B2C Commerce - Composable Storefront — Version 3.0.1

### Changed

* The [@adyen/adyen-web](https://github.com/Adyen/adyen-web) library is now a peer dependency. You must now manually install the library in your project's `dependencies`.

### Improved

* The `siteId` is now correctly passed in the `payment-details` controller to support multi-site setups.
* For guest shoppers: the `shopperInteraction` parameter is now sent in the payment request to prevent payment failures due to the missing parameter.

### Fixed

* For redirect payments: the shopper's cart is now correctly recreated when a redirect payment is canceled.
* For PayPal: the PayPal button now correctly renders on the checkout page after the shopper navigates away and returns. Previously, the button would fail to appear on the second attempt to access the checkout page.
* When using a non-en-US locale, there is no longer an error at the shipping address stage due to translation issues.

### New

* For Apple Pay: when you specify a default selected shipping method, the default shipping method is now automatically sorted to be the first item in the list.

## 2025-10-17 — Salesforce Order Management System — Version 3.3.0

### New

* A guided configuration page to streamline the setup process.
* You can now use a single webhook URL for captures, refunds, and cancellations. This reduces setup complexity and improves maintainability.
* For refunds: the **Refund** object now includes a **Refund Reference** field. This field is automatically populated to improve refund traceability in the Order Management System.

## 2025-10-15 — Salesforce Commerce Cloud - B2C Commerce — Version 25.6.0

*\<p>The features introduced in this release are only applicable for integrations with Store Front Reference Architecture (SFRA) versions 5, 6 and 7. \</p>*

### New

* Supported payment method: PayPal Express is now available on the Product Details Page (PDP).
* You can now implement post-authorization logic within the `int_adyen_SFRA` cartridge.

### Improved

* When a shopper cancels a payment that was initiated from the product details page, they are now redirected back to the same product page.
* After a webhook is processed successfully, the corresponding signature stored in the custom object is now cleared.
* The `assignPaymentMethodValue` function is improved and used exclusively on the front-end.

### Fixed

* For integrations using SFRA 5:

  * The Cross-Site Request Forgery (CSRF) token is now correctly passed on the Product Details Page (PDP).
  * The `SubmitCustom` controller is now loaded only for SFRA 6 and 7. This resolves an issue that blocked the **Place order** button in SFRA 5.

* Analytics events are now grouped with the corresponding cartridge version before being sent to the Adyen API. This allows to have clearer data.

## 2025-09-30 — Adobe Commerce - Express Checkout — Version 3.0.0

### Breaking Changes

* This version of the Express Checkout module requires the Adyen Payments plugin for Adobe Commerce v10.0.0 or later, and Adobe Commerce v2.4.8.

### New

* The plugin now sends `shopperConversionId` in the [/payments](https://docs.adyen.com/api-explorer/Checkout/latest/post/payments) and [/paymentMethods](https://docs.adyen.com/api-explorer/Checkout/latest/post/paymentMethods) requests to support [Adyen Uplift](/uplift).

### Improved

* The developer experience is modernized with support for PHPStan and PHPUnit 10.
* The module now uses the model-based PHP library.
* For PayPal Express: the [/payments](https://docs.adyen.com/api-explorer/Checkout/latest/post/payments) request now includes `lineItems` for increased accuracy data and easier reconciliation.
* The plugin now uses Web Components v6.0.0 for Google Pay Express, PayPal Express, and Apple Pay Express.

### Fixed

* When a shopper cancels an express payment that was initiated from a product details page by closing the payment pop-up, their cart is no longer lost.
* For PayPal Express: the module now prevents placing an order if the shopper updates their cart after payment is initiated.
* For Google Pay Express: the module now uses the `onSubmit` callback to place orders instead of `onAuthorised`. This allows the module to resolve the actions and mount the 3D Secure 2 component successfully.

## 2025-09-17 — Salesforce Commerce Cloud - B2C Commerce — Version 25.5.0

*\<p>The features introduced in this release are only applicable for integrations with Store Front Reference Architecture (SFRA) versions 5, 6 and 7. \</p>*

### New

* The cartridge now uses [Web Components v6.21.0](/online-payments/release-notes/#releaseNote=2025-08-20-web-componentsdrop-in-6.21.0). This version is compliant with the [co-badged cards regulations](/online-payments/co-badged-cards-compliance/).
* Support for [Riverty using the redirect flow](/payment-methods/riverty/web-component/?flow=Advanced%20flow\&integration=Component\&version=6.21.0#requirements).

### Fixed

* For Google Pay, the cartridge now handles the 3D Secure 2 flow correctly during standard checkout and express flows.
* The Cash App payment button now renders correctly on the checkout page. Previously, on cartridge versions that use Web Components v6, the button only rendered after reloading the page.

### Improved

* For Apple Pay express on the product detail page, the Apple Pay modal now shows the product price immediately, instead of having an initial amount of 0 and getting updated after a couple of seconds.

## 2025-08-11 — Salesforce Commerce Cloud - B2C Commerce — Version 25.4.0

*\<p>The features introduced in this release are applicable for integrations with Storefront Reference Architecture (SFRA) versions 5, 6 and 7.\</p>*

### Fixed

* The cartridge no longer sends a duplicate confirmation email after an order is placed.
* When an error occurs during the `/payments` request, the error is now handled correctly on the front end. Previously, no error message was shown to the shopper and the basket was lost.

### New

* You can now [implement your custom pre-authorization check logic](/plugins/salesforce-commerce-cloud/sfra/customization-guide#implement-pre-authorization-checks) using the cartridge’s pre-authorization hook.
* You can now use [case management](/plugins/salesforce-commerce-cloud/sfra/set-up-the-cartridge?plugin=Salesforce%20SFRA\&integration=cartridge\&version=25.4.0#case-management) to manually review a transaction before it is captured for fraud protection.
* You can now enable [data collection](/plugins/salesforce-commerce-cloud/sfra/set-up-the-cartridge?plugin=Salesforce%20SFRA\&integration=cartridge\&version=25.4.0#data-collection) on any of your storefront pages that use the [Salesforce ISML template](https://developer.salesforce.com/docs/commerce/b2c-commerce/guide/b2c-working-with-templates.html) to detect fraud outside of your checkout page.

## 2025-08-05 — Cegid Retail Y2 — Version 2.1.19

*\<p>Go to the \<a href="/plugins/cegid-retail-y2/set-up-the-plugin/">Cegid Retail Y2 plugin docs page\</a> to download the new version. We strongly recommend to remove the old version of the plugin before installing the new version.\</p>*

### New

* Updated to CPOS dev version 1962.
* For the Greek fiscal compliance solution, removed the CBS dependencies.
* Improved the referenced refund behavior to better support cases where the purchase is made online but the return is completed in store.

### Fixed

* Reverted the TLS 1.3 change introduced in v2.1.14. This fixes the known issue in v2.1.14. See [troubleshooting](/plugins/cegid-retail-y2/troubleshooting#open-failed-error) to learn more.

## 2025-07-28 — NetSuite Reconciliation Bundle — Version 1.6.9

### Improved

* On the **Adyen Integration Settings** page, we added a banner that shows whether your credentials have successfully connected to Adyen.
* Tested the plugin for compatibility with NetSuite version 2025.2.

## 2025-07-22 — Adobe Commerce — Version 10.0.0

*\<p>For technical details about the changes in this release, refer to our release notes on \<a href="https\://github.com/Adyen/adyen-magento2/releases">Github\</a>.\</p>*

### Breaking Changes

* The plugin now requires Adobe Commerce v2.4.8. We no longer support earlier versions of Adobe Commerce.
* The plugin now requires PHP 8.2 or later.
* We refactored our implementation of the [`OrderRepository.php`](https://github.com/magento/magento2/blob/94b8544e82fd84d1443060cddb5481b7fd462de2/app/code/Magento/Sales/Model/OrderRepository.php#L91) class to comply with breaking changes Adobe Commerce introduced in v2.4.8.

The following changes may be breaking if you have [customizations](/plugins/adobe-commerce/customize/):

* [Web Components v6](/online-payments/release-notes/?utm_source=online-payments-release-notes\&utm_medium=banner\&utm_id=v6-banner\&title%5B0%5D=Web%2BComponents%2FDrop-in\&version%5B0%5D=6.0.0#releaseNote=2024-07-24-web-componentsdrop-in-6.0.0) introduces the following changes that may affect your integration if you customized our front end components, or are using your own front end.

  * Donations are now handled using the Campaign Manager. The back-end methods and configurations for donations are removed from the plugin. If you customized using legacy donation properties, remove them from your implementation.
  * [Credit card installments](/payment-methods/cards/credit-card-installments/) are now offered with Adyen's Card Component instead of the plugin's custom installment template. If you used the custom installment rendering logic, update your implementation to align with the Web Component.

* The plugin now supports [Adobe Commerce Monolog library v3](https://developer.adobe.com/commerce/php/development/backward-incompatible-changes/#upgraded-monologmonolog-dependency) that introduces stricter type declarations. See the [Monolog upgrade guide](https://github.com/Seldaek/monolog/blob/main/UPGRADE.md) to learn more about this version. If you have custom `Monolog` handlers, or extended our logging logic, this change may affect your integration. Our custom `LoggerHandler`:

  * Previously: extended `Monolog\Handler\AbstractProcessingHandler`.
  * Now: extends `Monolog\Logger. Uses`Monolog\LoggerFactory\` to generate a logger class.

* We refactored the order comment history logic to improve consistency across the module. If you implemented custom logic that extended or depended on the old logic for adding order comments, this change may affect your integration.

  * Previously: all order comments were in `arguments`, which led to issues in some cases.
  * Now: added an abstract handler for order status history.

* To mitigate security risks, the `PaymentResponseHandler` no longer returns the full `additionalData` object. If you built custom logic using other fields from the `additionalData` object, remove this logic.

  * Previously: you received the full `additionalData` object.
  * Now: you only receive the `action` object. To securely retrieve other `additionalData` fields, you can use your back end.

* For Boleto, the payment lifecycle now uses the `AdyenPaymentCommandPool` as other payment methods, and no longer requires Boleto specific commands. If you have custom logic that overrides or extends the old Boleto specific commands, update your implementation.

* We removed the methods in the plugin that was used for deprecated logic. Refer to the [list of replacements for deprecated logic on GitHub](https://github.com/Adyen/adyen-magento2/releases/tag/v10.0.0) to see the new methods that replace their functionality.

### Improved

* Refactored the `Adyen\Payment\Helper\Data` class to remove deprecated and unused methods, and created more appropriate helper classes for methods that are not related to data. The methods are now in the following classes:

  | Helper                  | Location                     |
  | ----------------------- | ---------------------------- |
  | `Helper\Config`         | API key handling helpers     |
  | `Helper\PlatformInfo`   | Platform metadata helpers    |
  | `Helper\PaymentMethods` | Payment method logic helpers |
  | `Helper\Locale`         | Locale helpers               |

### New

* The plugin now uses [Web Components v6](/online-payments/release-notes?title%5B0%5D=Web%20Components%2FDrop-in\&version%5B0%5D=6.0.0) that offer an enhanced user experience, improved performance, and increased design flexibility.

* [Donations](/plugins/adobe-commerce/set-up-the-payment-methods-in-adobe-commerce#donations) are now offered with the [Campaign Manager](/online-payments/donations) for round-up and fixed amount donations.

  * Previously: you configured donations in the Adyen Customer Area and the Adobe Commerce admin panel, and you had to enable donations.
  * Now: the Campaign Manager lets you manage your donation campaigns from your Adyen Customer Area in a simplified manner, and you no longer have to configure donations in your Adobe Commerce admin panel. Donations are enabled by default.

* Localization for payment method titles.

  * Previously: payment method titles were hardcoded in `config.xml`.
  * Now: the plugin front end uses the [/paymentMethods](https://docs.adyen.com/api-explorer/Checkout/latest/post/paymentMethods) response to display payment method tiles, and the titles are localized based on the `shopperLocale`.

* Integrated [PHPStan](https://phpstan.org/user-guide/getting-started) to the plugin's CI/CD pipeline to help detect issues.

### Removed

* The `brand_code` field that was used to track transaction variants is removed from the `additional_information` field of the payment object. For headless integrations, you no longer have to send the `brand_code` field when creating a data object for placing the order. To identify transaction variants, you can now use `getAlternativePaymentMethodTxVariant()`.
* The plugin is no longer dependent on Adobe Commerce's PayPal module, and we removed all its dependencies.

### Fixed

* The plugin no longer incorrectly sets the `cc_type` for alternative payment methods in the database with the `BRAND_CODE` value. The `cc_type` is only set for credit cards. Previously, this issue could lead to misclassification of payment methods in records and reports, and inconsistent payment processing.

### Updating

* Follow our [migration guide](/plugins/adobe-commerce/migrate-to-a-new-version) to learn about the steps required to update to this version. If you have customized the plugin, carefully review the breaking changes to make sure your customizations are compatible with the new version.

## 2025-06-24 — NetSuite Payments Bundle — Version 1.20.22

### Fixed

* Fixed an issue where the capture delay was incorrectly set to **Immediate** when a payment link was generated on a sales order.

## 2025-06-17 — Salesforce Commerce Cloud - B2C Commerce — Version 25.3.0

*\<p>The features introduced in this release are only applicable for integrations with Store Front Reference Architecture (SFRA) versions 5, 6 and 7. \</p>*

### Breaking Changes

* We restructured the front end code for enhanced modularity and maintainability, aligning with modern best practices for JavaScript. To see what has changed, [refer to the diff](/plugins/release-notes/25-3-0-diff.pdf).
* Adyen Web Components version: [6.12.1](https://github.com/Adyen/adyen-web/releases/tag/v6.12.1).
* The pre-built `cartridges/` directory is removed. You must now extend and [build the source code locally](/plugins/salesforce-commerce-cloud/sfra/install-the-cartridge-and-import-the-metadata/#step-3-build-the-code).
* Each payment method now a separate configuration file to enable customizations. Refer to our documentation to learn how to [customize payment methods](/plugins/salesforce-commerce-cloud/sfra/customization-guide#customize-payment-methods).
* The cartridge now supports donations with [Adyen's Campaign Manager](/online-payments/donations/) that lets you manage your donation campaigns in a simplified manner. Refer to the [integration guide](/plugins/salesforce-commerce-cloud/sfra/set-up-the-cartridge?plugin=Salesforce%20SFRA\&integration=cartridge\&version=25.3.0#set-up-donations) for setup instructions.

### New

* You can now accept donations with Google Pay.
* Shoppers can now use Apply Pay in other [supported browsers](/payment-methods/apple-pay/#compatibility), on the checkout page or as part of the [express checkout flow](/payment-methods/express-checkout/).

### Improved

* Introduced asynchronous performance tracking to improve cartridge stability. This tracking happens in the background and does not impact your shopper's checkout experience.
* For gift cards, improved accessibility to make sure the gift card entry fields more accessible for all shoppers.

### Fixed

* Fixed an issue where payment details, like card type or expiry date, from modern payment components were not fully saved. This ensures more complete and accurate transaction records.
* Fixed an issue where the first product line item in an order could be skipped to ensure order totals and details are accurate.
* When a shopper navigates back to the store from the order confirmation page, their successfully completed order no longer fails.
* The payment method type (for example, **'card'**, or **'klarna'**) is now stored correctly without extra quotes, to improve data integrity for reporting and backend processes.
* Merchants in the Australia Pacific South East (APSE) region can now connect their accounts using the Adyen Classic settings page in the Business Manager.

## 2025-06-12 — Salesforce B2C Commerce - Composable Storefront — Version 3.0.0

### Fixed

* Fixed an issue where shoppers were occasionally redirected to an error page immediately after viewing the order confirmation page.

### New

* The package now includes source maps, enabling improved debugging and troubleshooting. Refer to the [Salesforce documentation](https://developer.salesforce.com/docs/commerce/pwa-kit-managed-runtime/guide/debugging.html) for guidance on using source maps in your project.
* If a payment fails, or the shopper cancels the payment process, the shopper's basket is now automatically re-created.
* Card payments are now differentiated from alternative payment methods (APMs) within the Salesforce environment variables. This change streamlines testing with [our Gitpod demo](https://github.com/adyen-examples/adyen-salesforce-pwa-headless-demo).

### Improved

* All project dependencies are upgraded to their latest versions.
* To comply with Visa requirements, the `shopperIP` AND `shopperName` fields are now passed in the payment requests.

## 2025-05-27 — NetSuite Payments Bundle — Version 1.20.21

### Fixed

* Fixed an issue that caused an error when viewing Sales Orders that do not have a Payment Processing Profile.

## 2025-05-20 — NetSuite Payments Bundle — Version 1.20.20

### New

* Sales orders can now be re-authorized manually, in bulk, or automatically based on defined criteria.
* You can now authorize a different amount from the sales order amount using Pay by Link to make partial payments.

## 2025-05-07 — NetSuite Reconciliation Bundle — Version 1.6.8

### Improved

* Improved the execution point logging on the **Poll for New SDR** scheduled script.

### New

* Added a new **Earliest SDR Batch Needed** parameter to the polling script for the Settlement Detail Report (SDR).

## 2025-04-29 — Salesforce Commerce Cloud - B2C Commerce — Version 25.2.3

*\<p>The features introduced in this release are only applicable for integrations with Store Front Reference Architecture (SFRA) versions 5, 6 and 7. \</p>*

### New

* Supported card types: **Accel**, **Star**, and **Nyce**.
* The configuration for supported card types is now managed with the `card-type-mapping.json` file.

### Fixed

* When a timeout occurs, the shopper's cart now persists, preventing loss of items. Previously, the shopper was redirected to a generic error page and the cart was emptied.
* Fixed an issue where the [/paypal/updateOrder](https://docs.adyen.com/api-explorer/Checkout/latest/post/paypal/updateOrder) request fails when the default shipping method is excluded by a rule. This fixes the known issue introduced in [v24.4.0](/plugins/release-notes#releaseNote=2024-09-19-salesforce-commerce-cloud-b2c-commerce-24.4.0).

## 2025-03-19 — Salesforce Order Management System — Version 3.2.0

*\<p>Follow our guide to \<a href="/plugins/salesforce-order-management-system/upgrade">upgrade your integration\</a> to the latest version.\</p>*

### New

* For the [Order on Behalf Of](/plugins/salesforce-order-management-system/set-up-oobo/) feature, you can now let your shoppers pay using a secure Adyen-hosted payment page with Pay by Link.
* For refunds with PayPal, the package now processes the `capturePspReference`. This lets you process refunds successfully during the [AUTH flow](/plugins/salesforce-order-management-system/order-status-lifecycle/), and enables better payment tracking, refund management, and customer support.
* When [automatic captures are enabled in your Adyen Customer Area](/online-payments/capture), the package no longer makes unnecessary API requests and handles captures as if capture requests are initiated from OMS.
* When you use the Adyen Customer Area for captures and refunds, the package now creates a gateway log in Salesforce to improve transaction management.

### Fixed

* When [HMAC key](/development-resources/webhooks/secure-webhooks/verify-hmac-signatures/) validation fails, the package now returns an error with [HTTP status code](/development-resources/response-handling/) **403: Forbidden** instead of a successful **200: OK**.

## 2025-03-17 — Salesforce Commerce Cloud - B2C Commerce — Version 25.2.1

*\<p>The features introduced in this release are only applicable for integrations with Store Front Reference Architecture (SFRA) versions 5, 6 and 7. The latest version compatible with controller-based SiteGenesis is v22.2.4.\</p>*

### Fixed

* When no point-of-sale stores are configured, the Adyen Settings page in the Business Manager now correctly displays the configuration for express payment methods. This bug did not affect the classic Business Manager page for the Adyen cartridge.
* The Adyen settings page in the Business Manager now has an extra validation to prevent unnecessary retrieval of point-of-sale stores from your Adyen merchant account.

### Known Issues

* For PayPal Express: when the default shipping method is excluded by a rule in Salesforce, the [/paypal/updateOrder](https://docs.adyen.com/api-explorer/Checkout/latest/post/paypal/updateOrder) request fails because the `deliveryMethod.selected` field is set to **false** for all other shipping methods. This issue is fixed in [v25.2.3](/plugins/release-notes#releaseNote=2025-04-29-salesforce-commerce-cloud-b2c-commerce-25.2.3).

## 2025-03-13 — NetSuite Payments Bundle — Version 1.20.10

### Fixed

* Fixed an issue with the **Pay By Link - Allowed Methods** and **Pay By Link - Block Methods** fields in payment processing profiles.
* Limited the Pay By Link configuration records on invoices to the appropriate subsidiary to prevent incorrect selections.

### Improved

* Improved the process to create and update payment links to prevent multiple entries from being created by the Map/Reduce scripts.

## 2025-03-11 — Cegid Retail Y2 — Version 2.1.14

*\<p>Go to the \<a href="/plugins/cegid-retail-y2/set-up-the-plugin/">Cegid Retail Y2 plugin docs page\</a> to download the new version. We strongly recommend to remove the old version of the plugin before installing the new version.\</p>*

### New

* Additional logging of the references used for refunds.
* Introduced [Transport Layer Security (TLS)](https://www.cloudflare.com/learning/ssl/transport-layer-security-tls) 1.3.

### Known Issues

* The TLS version change introduced in this version can cause an error where you receive an **Open Failed** error message if your Windows environment is not up to date. This issue is resolved in v2.1.19. See [troubleshooting](/plugins/cegid-retail-y2/troubleshooting#open-failed-error) to learn more about the issue and how you can resolve it.

## 2025-02-27 — Salesforce Commerce Cloud - B2C Commerce — Version 25.2.0

*\<p>The features introduced in this release are only applicable for integrations with Store Front Reference Architecture (SFRA) versions 5, 6 and 7. The latest version compatible with controller-based SiteGenesis is v22.2.4.\</p>*

### New

* For the [Endless aisle](/unified-commerce/endless-aisle) feature, you can now filter by Store on the Checkout page. This increases in-store payment processing times.

* The API requests now includes additional checkout and shopper data to improve payment optimization and fraud management with [Adyen Uplift](/uplift/).

* The SFCC cartridge now handles the following intermediate result codes and notifies the shopper that their payment is accepted but not yet authorized.

  * **Received**
  * **Pending**

### Improved

* The SFCC cartridge now exports an order to the OMS only after receiving a successful authorization webhook. If the payment has not reached a final successful status, it does not export the order. The order is created after the API response and is placed after the webhook.

### Fixed

* For Klarna payments: if the shopper cancels an in-progress payment that was initiated by the Klarna inline widget, the shopper is redirected back to the checkout page instead of an error page. The cart includes all items that were previously in it.
* For the PayPal Express checkout flow: the SFCC cartridge now synchornizes payment processing and order creation more accurately. Previously, a payment could be captured without a corresponding order in SFCC.

### Known Issues

* For PayPal Express: when the default shipping method is excluded by a rule in Salesforce, the [/paypal/updateOrder](https://docs.adyen.com/api-explorer/Checkout/latest/post/paypal/updateOrder) request fails because the `deliveryMethod.selected` field is set to **false** for all other shipping methods. This issue is fixed in [v25.2.3](/plugins/release-notes#releaseNote=2025-04-29-salesforce-commerce-cloud-b2c-commerce-25.2.3).

## 2025-02-26 — NetSuite Reconciliation Bundle — Version 1.6.7

### Fixed

* Fixed the Settlement Detail Report (SDR) CSV parsing to correctly handle cells that contain commas.
* Fixed an error where deposit creation banners could exceed the 100,000 character limit.

### Changed

* Externally sent transaction types are now converted to regular **Settled**/**Refunded** types.

## 2025-02-14 — Salesforce Commerce Cloud - B2C Commerce — Version 25.1.0

*\<p>The features introduced in this release are only applicable for integrations with Store Front Reference Architecture (SFRA) versions 5, 6 and 7. \</p>*

### New

* You can now enable Apple Pay express checkout on the [product details page](/payment-methods/express-checkout/#product-details-page).
* Google Pay now supports [express checkout](/payment-methods/express-checkout/#show-express-payment-methods) on the product detail, cart, and mini-cart pages. You can enable it in your [Salesforce Business Manager](/plugins/salesforce-commerce-cloud/sfra/set-up-payment-methods?plugin=Salesforce%20SFRA\&integration=cartridge\&version=25.1.0\&tab=use_your_own_apple_pay_certificate_1_2#google-pay).
* You can now configure installments for JCB on the **Adyen Settings** page in your Salesforce Business Manager.
* You can now tokenize details for Diners Club and Discover payments, to offer faster checkout experiences to your shoppers later.

### Improved

* Improved the express checkout configurator on the **Adyen Settings** page in your Salesforce Business Manager to let you configure express checkout for product detail, cart, and mini-cart pages easily.
* For [Atome](/payment-methods/atome/), the payment requests now include the [lineItems](https://docs.adyen.com/api-explorer/Checkout/latest/post/payments#request-lineItems) field.

### Known Issues

* For PayPal Express: when the default shipping method is excluded by a rule in Salesforce, the [/paypal/updateOrder](https://docs.adyen.com/api-explorer/Checkout/latest/post/paypal/updateOrder) request fails because the `deliveryMethod.selected` field is set to **false** for all other shipping methods. This issue is fixed in [v25.2.3](/plugins/release-notes#releaseNote=2025-04-29-salesforce-commerce-cloud-b2c-commerce-25.2.3).

## 2025-02-13 — Salesforce Commerce Cloud - B2C Commerce — Version 24.4.3

*\<p>The features introduced in this release are only applicable for integrations with Store Front Reference Architecture (SFRA) versions 5, 6 and 7. The latest version compatible with controller-based SiteGenesis is v22.2.4.\</p>*

### New

* For PayPal express, we added additional basket validations.

### Known Issues

* For PayPal Express: when the default shipping method is excluded by a rule in Salesforce, the [/paypal/updateOrder](https://docs.adyen.com/api-explorer/Checkout/latest/post/paypal/updateOrder) request fails because the `deliveryMethod.selected` field is set to **false** for all other shipping methods. This issue is fixed in [v25.2.3](/plugins/release-notes#releaseNote=2025-04-29-salesforce-commerce-cloud-b2c-commerce-25.2.3).

## 2025-01-15 — Cegid Retail Y2 — Version 2.1.13

*\<p>Go to the \<a href="/plugins/cegid-retail-y2/set-up-the-plugin/">Cegid Retail Y2 plugin docs page\</a> to download the new version. We strongly recommend to remove the old version of the plugin before installing the new version.\</p>*

### Fixed

* We fixed the known issue on v2.1.12 that prevented the plugin from generating a receipt for Cegid after a payment was successfully processed by Adyen in some cases.

## 2025-01-06 — NetSuite Reconciliation Bundle — Version 1.6.6

### New

* Added a **Match Manually** button on Adyen Settlement Detail Report (SDR) Detail records.
* Added a user event script to improve the SDR status transitions.

## 2024-12-19 — Cegid Retail Y2 — Version 2.1.12

*\<p>Go to the \<a href="/plugins/cegid-retail-y2/set-up-the-plugin/">Cegid Retail Y2 plugin docs page\</a> to download the new version. We strongly recommend to remove the old version of the plugin before installing the new version.\</p>*

### New

* You can now configure minimum and maximum installment amounts to be prompted in Cegid Retail Y2 by adding the `InstalmentMinMax{}` field in your [**Payment configuration**](/plugins/cegid-retail-y2/set-up-the-plugin/#configure-cegid).
* The default maximum gift card number length is now 80 characters. Minimum length is 19 characters.

### Fixed

* For [gift cards](/plugins/cegid-retail-y2/giftcards), the **GiftCardDefault SCA** behavior now correctly functions in accordance with the configured gift card length.

### Removed

* .NET dependencies and NewtonSoft.JSON.dll.

### Known Issues

* When a log line in the Adyen `receiptData` object exceeds 40 characters, the plugin can not generate a receipt for Cegid, which prevents Cegid from storing the transaction. This results in situations where a payment is successfully processed by Adyen but not successfully stored in Cegid, and can lead to reconciliation issues.

## 2024-12-13 — NetSuite Payments Bundle — Version 1.20.09

### Fixed

* For [SuiteCommerce Advance](/plugins/netsuite/set-up-netsuite-customer-center/#set-up-suitecommerce-advanced) orders using external checkout, the transaction expiry time is now 24 hours. Previously, transaction expiry time was set to one minute after order creation.

## 2024-12-10 — NetSuite Reconciliation Bundle — Version 1.6.5

### New

* Support for importing daily batch and external Settlement Detail Reports (SDRs) from Adyen.
* Added the **Maximum Day Difference for Matching** field to the [SDR Profile fields](/plugins/netsuite/reconciliation-bundle#sdr-profile).

## 2024-11-18 — NetSuite Reconciliation Bundle — Version 1.6.4

### Improved

* You now get a warning if the IDs entered in the PSP fields are invalid on the [Settlement Type Map](/plugins/netsuite/reconciliation-bundle#new-mapping).
* Updated the Adyen Settlement Detail Report (SDR) file name parsing during the polling process.

## 2024-10-28 — Salesforce Commerce Cloud - B2C Commerce — Version 24.4.1

*\<p>The features introduced in this release are only applicable for integrations with Store Front Reference Architecture (SFRA) versions 5, 6 and 7. The latest version compatible with controller-based SiteGenesis is v22.2.3.\</p>*

### New

* The cartridge now uses [Web Components v5.68.0](/online-payments/release-notes/#releaseNote=2024-08-26-web-componentsdrop-in-5.68.0).
  * With this version of the Web Components, [UPI](/payment-methods/upi/) does not work out of the box. We updated the UPI component configuration to support it.
* Payment method: [PayPay](/payment-methods/paypay/).

### Improved

* For Klarna, we split the `street_address` field into two different fields to pass `street_number` as a separate property.

### Fixed

* For guest shoppers, [Click to Pay](/payment-methods/cards/click-to-pay/) is now rendered correctly. Previously, the loading spinner was shown for Click to Pay, but the card payment form was shown.
* In the SFCC Business Manager, the URLs in the Payment Info box now correctly link to the test or live Customer Area.

### Known Issues

* For PayPal Express: when the default shipping method is excluded by a rule in Salesforce, the [/paypal/updateOrder](https://docs.adyen.com/api-explorer/Checkout/latest/post/paypal/updateOrder) request fails because the `deliveryMethod.selected` field is set to **false** for all other shipping methods. This issue is fixed in [v25.2.3](/plugins/release-notes#releaseNote=2025-04-29-salesforce-commerce-cloud-b2c-commerce-25.2.3).

## 2024-10-10 — NetSuite Payments Bundle — Version 1.20.08

### Fixed

* When creating a payment record for [Pay by Link](/plugins/netsuite/set-up-pay-by-link/), the plugin now uses the original reference instead of other reference codes.

## 2024-10-04 — Adobe Commerce — Version 9.9.0

### New

* Payment methods:

  * [NaverPay](/payment-methods/naverpay/).
  * PayCo.
  * Korean cards.

### Fixed

* For headless GraphQL integrations, the store locale is now fetched correctly.
* When [RabbitMQ](https://experienceleague.adobe.com/en/docs/commerce-cloud-service/user-guide/configure/service/rabbitmq) is not set up for your store, you no longer receive an error about the Advanced Message Queuing Protocol (AMQP) configuration for the `adyen.notification` consumer.

### Improved

* Updated the Adobe Commerce versions that are used for test workflows.
* Added an index to the `created_at` column in the `adyen_notification` database table to improve performance.

## 2024-10-03 — Adobe Commerce - Express Checkout — Version 2.3.0

### New

* For headless integrations, we implemented GraphQL mutations to support express checkout on the product detail page.

### Fixed

* For PayPal express, we resolved a bug that caused issues when displaying the order details page.

* For Apple Pay express:

  * The terms and agreements checkbox validation is disabled.
  * Shoppers can now change the selected shipping method. Previously, when multiple shipping methods were available, only the first one was considered.

## 2024-10-03 — Adobe Commerce - Hyvä Checkout — Version 1.2.0

### New

* Payment method: [Oney](/payment-methods/oney/).

## 2024-09-26 — Cegid Retail Y2 — Version 2.1.9

*\<p>Go to the \<a href="/plugins/cegid-retail-y2">Cegid Retail Y2 plugin documentation\</a> to download the new version. \</p>*

### New

* Introduced an end of day function that automatically archives the logs in a dated subdirectory.
* This version introduces the fiscal compliance solution for Greece. To comply with the requirements, deploy the Cegid Epsilon Tax Box driver and CBS. Get in touch with your Cegid Project Manager if you need assistance.

### Improved

* Improved tagging of logs.

## 2024-09-23 — Salesforce Order Management System — Version 3.1.0

### New

* You can now use the Salesforce Payment Authorization Reversal Service API with our package to reverse authorizations when needed, for example, when you can no longer fulfill an order. Follow our [documentation](/plugins/salesforce-order-management-system/authorization-reversal) to enable this feature.

## 2024-09-19 — Salesforce Commerce Cloud - B2C Commerce — Version 24.4.0

*\<p>The features introduced in this release are only applicable for integrations with Store Front Reference Architecture (SFRA) versions 5, 6 and 7. The latest version compatible with controller-based SiteGenesis is v22.2.3.\</p>*

### New

* The cartridge now supports [Riverty](/payment-methods/riverty) and sends the `lineItems` object in the [/payments](https://docs.adyen.com/api-explorer/Checkout/latest/post/payments) request. [Riverty Profile Tracking](https://docs.riverty.com/bnpl/documentation/profile_tracking) is not supported.
* If you use our [Salesforce OMS package](/plugins/salesforce-order-management-system), the order and payment data points `paymentTransaction.type` and `custom.adyen_value` are now synchronized between SFCC and OMS.

### Improved

* Added stack trace for Adyen custom logs to make debugging easier.
* Removed the end of line logic from the Apple Pay Domain Association file.

### Breaking Changes

* When your SFCC site is set to [gross taxation](https://help.salesforce.com/s/articleView?id=cc.b2c_managing_site_taxes.htm\&type=5), the taxes are now calculated correctly for PayPal payments.

### Known Issues

* For PayPal Express: when the default shipping method is excluded by a rule in Salesforce, the [/paypal/updateOrder](https://docs.adyen.com/api-explorer/Checkout/latest/post/paypal/updateOrder) request fails because the `deliveryMethod.selected` field is set to **false** for all other shipping methods. This issue is fixed in [v25.2.3](/plugins/release-notes#releaseNote=2025-04-29-salesforce-commerce-cloud-b2c-commerce-25.2.3).

## 2024-09-11 — NetSuite Reconciliation Bundle — Version 1.6.3

### Improved

* Improved the bank deposit error and warning banners.
* Searches in the Control Panel now use SuiteQL.

## 2024-09-09 — Adobe Commerce - Hyvä Checkout — Version 1.1.0

### New

* Payment method: Amazon Pay.

## 2024-09-02 — Salesforce Commerce Cloud - B2C Commerce — Version 24.1.1

### Improved

* Improved Adyen API endpoint usage for enhanced security.

## 2024-08-28 — Salesforce Commerce Cloud - B2C Commerce — Version 22.2.4

### Improved

* Improved Adyen API endpoint usage for enhanced security.

## 2024-08-28 — Salesforce Commerce Cloud - B2C Commerce — Version 23.3.2

### Improved

* Improved Adyen API endpoint usage for enhanced security.

## 2024-08-23 — Adobe Commerce - Express Checkout — Version 2.2.0

*\<p>This version of the Express Checkout module requires Adobe Commerce Adyen Payments plugin v9.7.1 or later. \</p>*

### New

* [Express checkout](/payment-methods/express-checkout/) support for PayPal for a faster and seamless payment experience for your shoppers.

## 2024-08-12 — Salesforce Commerce Cloud - B2C Commerce — Version 24.3.2

*\<p>The features introduced in this release are only applicable for integrations with Store Front Reference Architecture (SFRA) versions 5, 6 and 7. The latest version compatible with controller-based SiteGenesis is v22.2.3.\</p>*

### Fixed

* For PayPal Express:

  * the new PayPal Order property `taxTotal` now prevents incorrect tax rate calculation. Previously, when a shopper in the US changed the delivery address, the tax calculation could be incorrect because of different taxes in different states.
  * the configuration now includes currency and errors no longer occur when shoppers pay with another currency than USD.

### New

* Additional data elements for compliance with new [Visa Secure Authentication requirements](https://help.adyen.com/en_US/updates/visa-secure-authentication-data-field-mandate-of-required-data-fields) which go into effect on August 12, 2024.

## 2024-08-09 — Adobe Commerce — Version 9.7.1

### New

* Payment method: [Dana](/payment-methods/dana/).
* For compliance with the [Visa secure authentication data field mandate](https://help.adyen.com/en_US/updates/visa-secure-authentication-data-field-mandate-of-required-data-fields), the cardholder name is now collected for all card payments. To ensure that you comply with the requirements:
  * In your Adobe Commerce admin panel, make sure the [**Show cardholder’s name field in Checkout** and **Holder name required** fields are set to **Yes**](/plugins/adobe-commerce/set-up-the-payment-methods-in-adobe-commerce/#card-payments).
* The plugin now uses the [Adyen PHP API library v19.1.0](https://github.com/Adyen/adyen-php-api-library/releases/tag/v19.1.0).

### Fixed

* Fixed payment method validation issues that disabled the **Place order** button on the checkout page in some cases.
* For gift cards, the plugin now sends the `balance` received in the `/balance` response instead of the `transactionLimit` when making a [/payments](https://docs.adyen.com/api-explorer/Checkout/latest/post/payments) request.

## 2024-08-06 — Salesforce Order Management System — Version 3.0.0

### New

* The package now [supports webhooks for **CAPTURE\_FAILED** and **REFUND\_FAILED** events](/plugins/salesforce-order-management-system/install-and-set-up-the-package?plugin=Salesforce%20OMS\&integration=package\&version=3.0.0#configure-webhook). You can see the logs for these events in Salesforce, making it easier to detect when a capture or refund fails.
* The package now includes the Payment Gateway Provider, Gateway Provider Payment Method type, and Alternative Payment Method Record type by default, and you no longer have to create these records when setting up the package.
* The package now includes the **AdyenCheckout** Named Credential that enhances security when making requests to the Adyen [Checkout API](https://docs.adyen.com/api-explorer/Checkout/latest/overview).

### Breaking Changes

* [Verifying HMAC signatures](/development-resources/webhooks/secure-webhooks/verify-hmac-signatures) is now mandatory to protect your server from unauthorized webhook events.
* For Salesforce Sales Channels, the Adyen merchant account is now populated with the Adyen Merchant Account name instead of the Adyen Adapter name record value.

### Updating

* Follow our guide to [upgrade to Adyen Payments for Salesforce OMS v3](/plugins/salesforce-order-management-system/upgrade) to make sure your integration can handle the changes introduced in this version.

### Improved

* We improved the error logging for Payment Gateway logs to enable easier debugging and tracking.

### Fixed

* You can now install the package with or without the [New Order Save Behavior](https://help.salesforce.com/s/articleView?id=sf.new_order_save_behavior_intro.htm\&type=5) feature enabled.
* Capture references are now unique for each payment and duplication issues no longer occur.

## 2024-08-01 — Salesforce B2C Commerce - Composable Storefront — Version 2.0.1

### Improved

* The package now includes [body-parser](https://www.npmjs.com/package/body-parser).

## 2024-08-01 — Salesforce Commerce Cloud - B2C Commerce — Version 24.3.1

*\<p>The features introduced in this release are only applicable for integrations with Store Front Reference Architecture (SFRA) versions 5, 6 and 7. The latest version compatible with controller-based SiteGenesis is v22.2.3.\</p>*

### Fixed

* Previously, when the payment method list included iDEAL as the first payment option on some Android devices, the shopper could not select the **Place Order** button. The button now works correctly. Fixes the known issue introduced in v24.3.0.
* When a shopper selects PayPal on the Checkout page, the loading spinner no longer spins infinitely and the PayPal button loads correctly. Fixes the known issue introduced in v23.3.1, that affected some Android devices.

## 2024-08-01 — Salesforce B2B Commerce — Version 2.3.0

*\<p>This package requires the \<a href="https\://appexchange.salesforce.com/appxListingDetail?listingId=a0N3u00000PraxuEAB">Adyen Apex API Library package v3.1.0.1\</a>. \</p>*

### New

* You can now use multiple merchant accounts within the same Salesforce B2B Commerce organization, increasing flexibility when using this package.

### Fixed

* Resolved an issue with front-end validation that occurred when changing payment methods, ensuring a smoother user experience.
* You can now install the package with or without the [New Order Save Behavior](https://help.salesforce.com/s/articleView?id=sf.new_order_save_behavior_intro.htm\&type=5) feature enabled.

## 2024-07-23 — Salesforce Commerce Cloud - B2C Commerce — Version 24.3.0

*\<p>The features introduced in this release are only applicable for integrations with Store Front Reference Architecture (SFRA) versions 5, 6 and 7. The latest version compatible with controller-based SiteGenesis is v22.2.3.\</p>*

### Breaking Changes

* The cartridge now stores the card brand value for orders, instead of `scheme`. This may impact your integration if you have [customizations](/plugins/salesforce-commerce-cloud/sfra/customization-guide/).

### New

* Payment method: [Scalapay](/payment-methods/scalapay/).
* You can now enable [PayPal express checkout](/plugins/salesforce-commerce-cloud/sfra/set-up-payment-methods?plugin=Salesforce%20SFRA\&integration=cartridge\&version=24.3.0#paypal) on the SFRA cart and mini cart pages for a faster and seamless checkout experience.
* The new iDEAL payment flow where the shopper is redirected to the iDEAL payment page to select their bank and authorize the payment. The deadline to start using the [new iDEAL flow](/payment-methods/ideal/) is **01 April 2025**.
* New diagrams that show the checkout and express payment flows. See the diagrams in our [GitHub](https://github.com/Adyen/adyen-salesforce-commerce-cloud/tree/main/documentation) to learn how our cartridge handles payment flows and how to customize according to your needs.

### Improved

* The `manufacturerName` risk data field is now called `manufacturer` to follow the [Adyen Checkout API](https://docs.adyen.com/api-explorer/Checkout/71/post/payments#request-additionalData-listOfValues-riskdata-basket-item_itemNr_-manufacturer) requirements.

### Fixed

* Previously, when the payment method list did not have cards as the first payment option, and the first option did not contain additional fields or a button, the shopper could not select the **Place Order** button. The button now works correctly for all cases.
* For [Giving](/online-payments/donations), the cartridge no longer runs redundant checks for payment methods that do not support donations, and the Giving component is only rendered if the [/payments](https://docs.adyen.com/api-explorer/Checkout/latest/post/payments) response contains a `donationToken`.
* The Adyen Help links on the Adyen Settings page in the Business Manager now link correctly to the Adyen Customer Area.
* For Bancontact, we fixed an issue where the front-end validation for the component would fail and the shopper could not select the **Place Order** button.

### Known Issues

* When the payment method list includes iDEAL as the first payment option on some Android devices, the shopper cannot select the **Place Order** button. Fixed in v24.3.1.
* For PayPal Express, tax calculation in the US is inaccurate. Fixed in v24.3.2.

## 2024-07-22 — NetSuite Reconciliation Bundle — Version 1.6.2

### Improved

* Improved the bank deposit error detection and warning banners.

### New

* Added support for matching on **Modification Merchant Reference**.

## 2024-07-18 — Shopware 6 — Version 4.0.0

### New

* For webhooks, [verifying HMAC signatures](/development-resources/webhooks/secure-webhooks/verify-hmac-signatures/) is now optional.
* The new iDEAL payment flow where the shopper is redirected to the iDEAL payment page to select their bank and authorize the payment. The deadline to start using the [new iDEAL flow](/payment-methods/ideal/) is **01 April 2025**.

### Breaking Changes

* The plugin now supports Shopware 6.6.

### Fixed

* We updated the autowiring in the plugin. This solves the incompatibility issues that occurred when using Shopware v6.4.15.0 or earlier.
* Renamed the `adyen-card-header` CSS class in the components that caused duplications in the compiled CSS file.
* When you update the plugin, SQL syntax errors no longer occur.
* For gift card payments, Adyen tables are now shown correctly in the Shopware back end.

### Removed

* Exception classes that were deprecated in Shopware v6.5.0.0 and later:

  * `AsyncPaymentFinalizeException`
  * `AsyncPaymentProcessException`
  * `CustomerCanceledAsyncPaymentException`
  * `PaymentProcessException`\
    Instead, the plugin now uses the `PaymentException` class.

### Improved

* The plugin now uses [Checkout API v71](/online-payments/release-notes/?title%5B0%5D=Checkout%20API#releaseNote=2023-11-01-checkout-api-71) and [Web Components v5.66.1](/online-payments/release-notes/?title%5B0%5D=Web%20Components%2FDrop-in#releaseNote=2024-06-10-web-componentsdrop-in-5.66.1).

## 2024-07-18 — Adobe Commerce - Hyvä Checkout — Version 1.0.0

*\<p>The Hyvä Checkout compatibility module requires the Adyen Adobe Commerce plugin v9.5.2 or later.\</p>*

### New

You can now use the [Adyen Hyvä Checkout compatibility module](https://github.com/Adyen/adyen-magento2-hyva) to benefit from the features of the Hyvä theme and enhance the checkout experience for your shoppers. Follow our [guide to use Hyvä Checkout](/plugins/adobe-commerce/set-up-the-plugin-in-adobe-commerce#use-hyva-checkout). The integration supports:

* Cards, wallets, and other alternative payment methods. See [supported payment methods](/plugins/adobe-commerce/supported-payment-methods) for the full list of payment methods.
* Offer your shoppers the option to pay in installments for cards.
* Offer your shoppers the option to [donate](/online-payments/donations) when they make a payment.
* [Securely store the payment details](/online-payments/tokenization) of your shoppers to offer faster checkout experiences to returning shoppers.

## 2024-07-03 — Salesforce B2C Commerce - Composable Storefront — Version 2.0.0

### Breaking Changes

* Our package is now compatible with the [Salesforce B2C Commerce PWA Kit v2.7.0](https://help.salesforce.com/s/articleView?id=sf.pwa_kit_2_7_0_release.htm\&type=5).

### New

* The new iDEAL payment flow where the shopper is redirected to the iDEAL payment page to select their bank and authorize the payment.

## 2024-06-21 — Cegid Retail Y2 — Version 2.1.4

### Removed

* Visual Studio 2013 dependencies.

## 2024-06-12 — Salesforce Commerce Cloud - B2C Commerce — Version 24.2.1

*\<p>The features introduced in this release are only applicable for integrations with Store Front Reference Architecture (SFRA) versions 5, 6 and 7. The latest version compatible with controller-based SiteGenesis is v22.2.3.\</p>*

### Improved

* For Apple Pay express, the state and postal code are now considered for tax calculation.
* You can now navigate to the payments page in the Adyen Customer Area by selecting the link in the SFRA Payments tab.

### New

* Card configuration now contains `exposeExpiryDate`. This field is set to **false** by default.

## 2024-06-12 — Salesforce B2B Commerce — Version 2.2.0

*\<p>This package requires the \<a href="https\://appexchange.salesforce.com/appxListingDetail?listingId=a0N3u00000PraxuEAB">Adyen Apex API Library package v3.1.0.1\</a>. \</p>*

### New

* Payment methods:

  * [ACH Direct Debit](/payment-methods/ach-direct-debit/)
  * [SEPA Direct Debit](/payment-methods/sepa-direct-debit/)

* You can now enable tokenization to store the payment details of your shoppers for recurring payments.

## 2024-06-11 — Adobe Commerce — Version 9.6.0

### New

* The new iDEAL payment flow where the shopper is redirected to the iDEAL payment page to select their bank and authorize the payment.

* Payment methods:

  * [PayPo](/payment-methods/paypo/)
  * [Online banking India](/payment-methods/online-banking-india/)
  * [Wallets India](/payment-methods/wallets-india/)
  * [UPI](/payment-methods/upi/)

### Fixed

* Fixed an error that occurred when downloading the Apple Pay certificate from the Adobe Commerce admin panel.

## 2024-05-22 — Adobe Commerce — Version 9.5.2

### New

* You can now use the [Adyen Hyvä Checkout compatibility module](https://github.com/Adyen/adyen-magento2-hyva) to benefit from the features of the Hyvä theme and enhance the checkout experience for your shoppers. Follow our [guide to use Hyvä Checkout](/plugins/adobe-commerce/set-up-the-plugin-in-adobe-commerce#use-hyva-checkout).
* Unit tests for the Data helper and Transaction Capture classes.

### Fixed

* For partial payments, we fixed an issue where the order amount was not fully captured.

## 2024-05-20 — NetSuite Reconciliation Bundle — Version 1.6.1

### Improved

* When a bank deposit creation fails due to a mismatch between the expected and actual totals, the error message details are now displayed on the Settlement Detail Report (SDR) record.

### Fixed

* Fixed a potential logging error in the **Receive SDR map/reduce** script.

## 2024-05-15 — Shopware 6 — Version 3.15.0

### Improved

* Added functionality to process scheduled webhooks. Previously, the plugin stopped running scheduled commands after restarting PHP-FPM.

### New

* For gift cards:

  * The plugin now uses a single `GiftCardPaymentMethodHandler` for all [gift cards](/payment-methods/gift-cards/). If you have enabled any gift card payment methods in your Adyen Customer Area, you must enable the **Adyen Gift Card** payment method in your Shopware store configuration.
  * Multiple gift card payments are now supported.
  * Partial refunds are now supported. You can configure refund settings in your Shopware back end, under **Refund settings**.

* The plugin now uses [Adyen PHP library v17.5.0](https://github.com/Adyen/adyen-php-api-library/releases/tag/v17.5.0) to support a model based approach for requests to `/payments`, `/payments/details`, `/donations`, `/paymentMethods/balance`, and `/orders` endpoints.

* Captures, refunds, and cancel requests are now handled using the .

* The plugin now uses [Web Components v5.63.0](/online-payments/release-notes/#releaseNote=2024-04-10-web-componentsdrop-in-5.63.0)

### Fixed

* When using Shopware v6.4.11.1, a compatibility error no longer occurs when updating the plugin on versions 3.14.0 and 3.14.1.
* For redirect payments, the plugin now passes the correct `shopperLocale` and shows the redirect page in the same language as the shopper’s Shopware instance.

### Changed

* The following classes and functions are moved to the plugin repository instead of referenced from the Adyen PHP library:

  * `CheckoutStateDataValidator` class.
  * `DataArrayValidator` class.
  * `Util/Currency` function.

## 2024-05-08 — Salesforce B2B Commerce — Version 2.1.0

*\<p>This package requires the \<a href="https\://appexchange.salesforce.com/appxListingDetail?listingId=a0N3u00000PraxuEAB">Adyen Apex API Library package v3.1.0.1\</a>. \</p>*

### Breaking Changes

* The Salesforce Aura framework is no longer supported.

### New

* The package now supports the [Salesforce Lightning Web Runtime (LWR)](https://help.salesforce.com/s/articleView?id=sf.comm_lwr_aura_comps.htm\&type=5) framework.
* The package now uses [Adyen Web Components v5.60.0](/online-payments/release-notes/#releaseNote=2024-03-11-web-componentsdrop-in-5.60.0) to display payment options on your checkout page.
* Support for [all card payment methods](/plugins/salesforce-b2b-commerce-lightning#payment-methods).
* You can now perform [3D Secure 2 authentication](/online-payments/3d-secure) using the Native or Redirect flow.

## 2024-05-08 — Cegid Retail Y2 — Version 2.1.3

### New

* The plugin now supports localization for the following languages:

  * Japan
  * Slovakia
  * Greece

### Fixed

* Fixed an issue where a requirement for .NET 4.8.1. was incorrectly prompted.
* The overview of transactions to reprint no longer includes cancelled transactions.

### Improved

* Improved the time to update the total basket amount with the line item display functionality.
* The [installation folder](/plugins/cegid-retail-y2/set-up-the-plugin/#download-and-install-the-plugin) now includes an uninstaller file that automatically uninstalls the previously installed instance of CPOS. This means that you no longer have to manually uninstall older versions.

## 2024-05-01 — Salesforce B2C Commerce - Composable Storefront — Version 1.2.0

### New

* You can now offer your shoppers the option to pay with [Apple Pay express](/plugins/salesforce-commerce-cloud/composable-storefront/set-up-payment-methods).

### Updating

* Dependency versions:

  | Name                       | Version         |
  | -------------------------- | --------------- |
  | Salesforce PWA             | **3.4.0**       |
  | Salesforce Managed Runtime |                 |
  | Adyen Web Drop-in          | **5.63.0**      |
  | Adyen Node.js API Library  | **16.0.1**      |
  | Node                       | **18 or later** |
  | npm                        | **9 or later**  |

### Improved

* When a shopper cancels the payment, for example by closing the payment method modal window, the package now handles cancellations correctly.

## 2024-04-25 — NetSuite Reconciliation Bundle — Version 1.6.0

### Changed

* The **Related Records** tab on the transaction shown in the SDR Detail sublist is now called **Custom**.
* When the **Export Execution Logs** button is selected, the execution logs are now sorted by log internal IDs.

### Fixed

* When matching transactions, the bundle no longer considers a transaction matched if the SDRD it is linked to does not have a valid Settlement Detail Report associated with it.

## 2024-04-25 — Salesforce Commerce Cloud - B2C Commerce — Version 24.2.0

*\<p>The features introduced in this release are only applicable for integrations with Store Front Reference Architecture (SFRA) versions 5, 6 and 7. The latest version compatible with controller-based SiteGenesis is v22.2.3.\</p>*

### Breaking Changes

* We updated the cartridge folder and file structure to comply with Adyen and SFCC [SFRA best practices](https://help.salesforce.com/s/articleView?id=000388948\&type=1). The folders now follow a new structure:

  | Cartridge folder       | Content                                             |
  | ---------------------- | --------------------------------------------------- |
  | `app_adyen_sfra`       | All front end code                                  |
  | `int_adyen_sfra`       | All back end code                                   |
  | `bm_adyen`             | All code related to the Salesforce Business Manager |
  | `int_custom_cartridge` | Custom code for customized integrations             |

  Follow the [steps to set up the cartridge path](/plugins/salesforce-commerce-cloud/sfra/set-up-the-cartridge?plugin=Salesforce%20SFRA\&integration=cartridge\&version=24.2.0#step-1-set-up-the-cartridge-path) to update your cartridge path.

* For customized integrations, the [/paymentMethods](https://docs.adyen.com/api-explorer/Checkout/latest/post/paymentMethods) request introduced in this version may introduce breaking changes. Check if your custom code is compatible with the new server-side flow.

### Improved

* The cartridge now uses the [/paymentMethods](https://docs.adyen.com/api-explorer/Checkout/latest/post/paymentMethods) endpoint to get the available payment methods instead of [/sessions](https://docs.adyen.com/api-explorer/Checkout/latest/post/sessions). This is the [Advanced flow](/online-payments/build-your-integration/) integration for online payments integrations with Adyen, supports more use cases, and is simpler to use and maintain.
* The cartridge now uses [Web Components v5.61.0](/online-payments/release-notes?version%5B0%5D=5.61.0\&title%5B0%5D=Web%20Components%2FDrop-in).

### New

* The cartridge is now compatible with SFRA version 7.

* For PayPal, payment requests now include the price and product information for the order.

* Payment methods:

  * [Online banking Finland](/payment-methods/finland-online-banking/)
  * [Pay by Bank](/payment-methods/pay-by-bank-europe/)
    * These payment methods no longer support separate captures. If you are using our Salesforce Order Management System package, in your Salesforce Business Manager, add the [payment method variants](/development-resources/paymentmethodvariant/) to **Local payment methods** > **Payment methods without separate capture**.

## 2024-04-19 — Adobe Commerce — Version 9.5.0

### New

* The plugin now supports asynchronous in-person payments flows, where the payment is initiated after an order is created. You can configure the [**Order creation time**](/plugins/adobe-commerce/set-up-in-person-payments) in your Adobe Commerce admin panel. The default value for this field is **After payment**. For headless integrations, setting the value to **Before payment** may break your integration.

* The plugin now supports the following Dispute webhooks, and you no longer have to handle orders that receive a chargeback manually:

  * [NOTIFICATION\_OF\_CHARGEBACK](https://docs.adyen.com/api-explorer/Webhooks/latest/post/NOTIFICATION_OF_CHARGEBACK)
  * [SECOND\_CHARGEBACK](https://docs.adyen.com/api-explorer/Webhooks/latest/post/SECOND_CHARGEBACK)
  * [CHARGEBACK](https://docs.adyen.com/api-explorer/Webhooks/latest/post/CHARGEBACK)
  * [CHARGEBACK\_REVERSED](https://docs.adyen.com/api-explorer/Webhooks/latest/post/CHARGEBACK_REVERSED)
  * [REQUEST\_FOR\_INFORMATION](https://docs.adyen.com/api-explorer/Webhooks/latest/post/REQUEST_FOR_INFORMATION)

### Fixed

* Fixed an issue where state data could not be loaded due to a change introduced in v9.4.0 for headless integrations using GraphQL.

### Improved

* The plugin now uses [Web Components v5.63.0](/online-payments/release-notes/#releaseNote=2024-04-10-web-componentsdrop-in-5.63.0).
* Added an observer to remove CSP headers from Adyen webhook responses.

## 2024-03-25 — Adobe Commerce — Version 9.4.0

### New

* Payment method: [ACH](/payment-methods/ach-direct-debit/).
* For headless integrations using GraphQL, the plugin now uses the [/orders](https://docs.adyen.com/api-explorer/Checkout/71/post/orders) endpoint. For the required implementation steps for the new gift card flow, see [Gift card payments for headless integrations](/plugins/adobe-commerce/headless-integration#gift-card-payments).
* You can now filter out shopper tokens that were generated on a different Magento storefront when getting the available payment methods for a shopper. Find the setting in the [Tokenization section of your Adobe Commerce admin panel](/plugins/adobe-commerce/set-up-tokenization#set-up-vault).
* Unit tests for the Webhook helper class.

### Improved

* The plugin now uses [Web Components v5.60.0](/online-payments/release-notes#releaseNote=2024-03-11-web-componentsdrop-in-5.60.0).

### Fixed

* For carts where a discount is applied, the plugin now correctly calculates the tax included and excluded values for open invoice line items.

## 2024-03-20 — Salesforce B2C Commerce - Composable Storefront — Version 1.1.0

### Improved

* We removed redundant PWA Retail React App pages and reduced the package build size to improve compatibility with Windows OS.

### Updating

* Dependency versions:

  | Name                       | Version         |
  | -------------------------- | --------------- |
  | Salesforce PWA             | **3.1.1**       |
  | Salesforce Managed Runtime |                 |
  | Adyen Web Drop-in          | **5.51.0**      |
  | Adyen Node.js API Library  | **14.3.0**      |
  | Node                       | **18 or later** |
  | npm                        | **9 or later**  |

## 2024-03-19 — NetSuite Reconciliation Bundle — Version 1.5.9

### Improved

* Improved execution logging and error reporting.
* When you select **Retry Deposit Creation**, the previous error messages are now cleared.

## 2024-03-08 — Adobe Commerce — Version 9.3.0

### New

* Payment method: [Bizum](/payment-methods/bizum/).
* New unit tests for the Payment methods helper.

### Fixed

* If you have disabled In-person payments in the Adobe Commerce admin panel, running `setup:upgrade` no longer enables it.
* Added the `Magento_Customer` dependency module.
* When running `setup:install`, an error no longer occurs in the `Adyen_payment` schema.
* For alternative payment methods, the `payment-method-content` field is no longer shown in the payment method title section.
* For headless integrations with a multi-store setup, the `storeId` parameter is now included in the `Return/Index` controller. This fixes an issue where the shopper was returned to another store than the one in which they started the payment.
* When a shopper makes multiple payment attempts for an order, the plugin now correctly registers the PSP reference for the successful payment.

### Removed

* Removed the `Adyen\Payment\Model\Ui\AdyenBoletoConfigProvider` and `Magento\Catalog\Helper\Image` that are no longer used by the plugin.
* The plugin now uses the stable version of [Playwright](https://playwright.dev/docs/release-notes) instead of the latest.

## 2024-02-28 — Cegid Retail Y2 — Version 2.1.1

*\<p>Go to the \<a href="/plugins/cegid-retail-y2/set-up-the-plugin#download-and-install-the-plugin">Cegid Retail Y2 plugin documentation\</a> to download the new version. \</p>*

### Fixed

* We fixed a critical bug that caused issues for the following gift card operations:

  * Activation
  * Check balance
  * Credit note
  * Reloading

## 2024-02-26 — Salesforce B2C Commerce - Composable Storefront — Version 1.0.0

### New

The Salesforce B2C Commerce Composable Storefront package is a new payment integration for the [Salesforce PWA Kit](https://developer.salesforce.com/docs/commerce/pwa-kit-managed-runtime/guide/pwa-kit-overview.html).\
See the [documentation for our new Salesforce Composable Storefront integration](/plugins/salesforce-commerce-cloud/composable-storefront) to learn how to install, set up, customize, and go live with the [package](https://www.npmjs.com/package/@adyen/adyen-salesforce-pwa).

* Payment methods:

  * [Cards](/payment-methods/cards/)
  * [Apple Pay](/payment-methods/apple-pay/)
  * [Amazon Pay](/payment-methods/amazon-pay/)
  * [Alipay](/payment-methods/alipay/)
  * [Boleto](/payment-methods/boleto-bancario/)
  * [Google Pay](/payment-methods/google-pay/)
  * [Klarna](/payment-methods/klarna/)
  * [PayPal](/payment-methods/paypal/)
  * [Swish](/payment-methods/swish/)\
    Refer to [Supported payment methods](/plugins/salesforce-commerce-cloud/supported-payment-methods) for the full list of payment methods that the package supports.

* Accept payments in multiple currencies across multiple locales.

* Tokenize the payment details of your logged-in shoppers to offer secure and fast checkout experiences.

* Add custom configuration to the checkout component to customize the checkout UI for your shoppers. Read more about front end customization options in the [Customization guide](/plugins/salesforce-commerce-cloud/composable-storefront/customization-guide).

* When a shopper pays with Boleto, the voucher is shown on the confirmation page.

* Configure different [live endpoint regions](/plugins/salesforce-commerce-cloud/composable-storefront/go-live-checklist#live-environment-region) for your different Salesforce sites.

* Use our [Risk management](/risk-management) system to detect and mitigate fraud by sending [risk fields](/risk-management/configure-manual-risk/required-risk-field-reference/) in payment requests.

* Native support for the **AUTHORISATION** webhook and a [customizable webhook framework](/plugins/salesforce-commerce-cloud/composable-storefront/customization-guide#back-end-customizations) to enable additional [webhooks](/development-resources/webhooks).

* Dependency versions:

  | Name                       | Version         |
  | -------------------------- | --------------- |
  | Salesforce PWA             | **3.1.1**       |
  | Salesforce Managed Runtime |                 |
  | Adyen Web Drop-in          | **5.51.0**      |
  | Adyen Node.js API Library  | **14.3.0**      |
  | Node                       | **18 or later** |
  | npm                        | **9 or later**  |

## 2024-02-22 — Adobe Commerce — Version 9.2.0

### New

* Payment methods:

  * [Cash App Pay](/payment-methods/cash-app-pay/)
  * [Vipps](/payment-methods/vipps/)
  * [MobilePay](/payment-methods/mobilepay/)

* You can now remove shopper tokens by making a POST `/V1/adyen/token/deactivate` request.

* After an order is created, it is status is now set to [**Pending Payment** in Adobe Commerce](https://experienceleague.adobe.com/docs/commerce-admin/stores-sales/order-management/orders/order-status.html?lang=en) if the payment requires additional action from the shopper to be completed.

* New unit tests for the Order helper.

### Fixed

* The plugin now shows the correct label for alternative payment methods tokens on the checkout page.
* Fixed an issue where a missing property declaration on the `RefundDataBuilder` in the Open Invoice helper caused an error for online refunds.
* For headless integrations using GraphQL, the `adyenPaymentDetails` mutation no longer returns the **The cart isn't active.** message for some payment methods before the payment is completed.
* Added missing configuration definitions to `config.xml` and `di.xml` that caused errors when making Vault payments with generated payment methods.

### Improved

* Payment methods are no longer set to active by default in the `config.xml` file. Previously, these payment methods were returned on the frontend regardless of your configuration in the Adobe Commerce admin panel.
* Refactored the HTML code in the plugin.

## 2024-02-09 — Adobe Commerce — Version 9.1.0

### Fixed

* The **Recurring Payment Types** table now correctly shows the recurring payment information for each payment method.
* When placing an order, a runtime exception caused by the Paypal Braintree module no longer occurs.
* The `external-application-name` and `merchant-application-name` values are now sent correctly in headers.
* When making a payment with a token with no value set for `recurringProcessingModel`, the plugin now uses the default value.
* Webhooks are now processed correctly with [RabbitMQ](/plugins/adobe-commerce/set-up-the-plugin-in-adobe-commerce/#step-2-run-cron).

### New

* Payment method: [Billie](/payment-methods/klarna/billie/).
* Unit tests for AdditionalDataLevel23DataBuilder, BrowserInfoDataBuilder, WebhookProcessorCommand, and EnablePaymentMethodsCommand classes.

### Improved

* If a new payment method starts being supported by the plugin, the `active` value for the payment method in `core_config_data` is now updated when upgrading.

## 2024-02-01 — Salesforce Order Management System — Version 2.1.2

### Improved

* Improved precision for mathematical operations with the [Salesforce Double data type](https://developer.salesforce.com/docs/atlas.en-us.248.0.apexcode.meta/apexcode/langCon_apex_primitives.htm).
* Improved the round-up logic to be consistent with the [Adyen SFCC SFRA cartridge](/plugins/salesforce-commerce-cloud/sfra). Previously, some captures were one cent less than the authorized payment amount.

## 2024-02-01 — Salesforce Commerce Cloud - B2C Commerce — Version 24.1.0

*\<p>The features introduced in this release are only applicable for integrations with Store Front Reference Architecture (SFRA) versions 5 and 6. The latest version compatible with controller-based SiteGenesis is \<a href="https\://github.com/Adyen/adyen-salesforce-commerce-cloud/releases/tag/22.2.3">v22.2.3\</a>.\</p>*

### Removed

* The cartridge repository no longer contains SiteGenesis-compatible files.

### Improved

* The cartridge now uses [Web Components v5.56.0](/online-payments/release-notes/?integration_type=web\&title%5B0%5D=Web%20Components%2FDrop-in\&version%5B0%5D=5.56.0#releaseNote=2024-01-08-web-componentsdrop-in-5.56.0) and [Checkout API v71](/online-payments/release-notes?integration_type=api\&title%5B0%5D=Checkout%20API\&version%5B0%5D=71#releaseNote=2023-11-01-checkout-api-71).
* In your Business Manager, there is now a reminder that your [Live URL prefix](/development-resources/live-endpoints/#live-url-prefix) must match your front-end region.
* We increased unit test coverage to improve the reliability of cartridge code.
* [Level 2/3 enhanced scheme data](/plugins/salesforce-commerce-cloud/set-up-the-cartridge/#level-2-3-data) is only sent for card payments instead of all payment methods.

### New

* You can now use multiple [live URL prefixes](/plugins/salesforce-commerce-cloud/go-live-checklist#salesforce-business-manager) for different sites in a single sandbox.
* For US storefronts, your shoppers located in the US can now use [Venmo](/payment-methods/paypal/#venmo) as a payment method. You can [hide Venmo](/payment-methods/paypal/web-component/#hide-venmo) if you do not want to offer it to your shoppers.
* Your shoppers can now donate with [Adyen Giving](/plugins/salesforce-commerce-cloud/set-up-the-cartridge/#set-up-donations) when they pay with Apple Pay.

### Changed

* To comply with EU consumer choice regulations, The name of the payment method group for cards is now **Cards** instead of **Credit Card**. When you upgrade to this version, the payment method is now shown as **Cards** on the checkout page, for earlier versions, you must [manually change the payment method group name](/online-payments/co-badged-cards-compliance/#do-not-discriminate-between-card-products).

### Breaking Changes

* For customized integrations, [Checkout API v71](/online-payments/release-notes?integration_type=api\&title%5B0%5D=Checkout%2BAPI\&version%5B0%5D=71#releaseNote=2023-11-01-checkout-api-71) may introduce breaking changes. Check if your custom code is compatible with the changes introduced in this version.

### Breaking Changes

## 2024-01-16 — NetSuite Reconciliation Bundle — Version 1.5.8

### Improved

* Users that are not administrators can now extract error logs.

### Fixed

* The bundle no longer tries to create deposits for records of type **DepositCorrection**.

## 2023-12-29 — NetSuite Payments Bundle — Version 1.20.07

### Changed

* Changed the time zone format in the code.

## 2023-12-15 — NetSuite Reconciliation Bundle — Version 1.5.7

### Improved

* The timeout limit for receiving SDRs is now 15 minutes instead of 5 minutes.

### New

* New transaction type: [**MiscCosts**](/reporting/settlement-reconciliation/transaction-level/settlement-details-report/#journal-types). This is the status for the costs from externally settled payments that could not be matched with any specific transactions, and they do not need to be matched.

## 2023-12-15 — Adobe Commerce — Version 9.0.4

### Fixed

* For gift cards, when the `/paymentMethods/balance` response includes a `transactionLimit`, this value is now registered as the usable balance in a single checkout.
* When website restriction mode is enabled, the incoming webhook messages are now accepted correctly.
* A webhook processing issue that occurred when Adobe Commerce production mode was enabled is now fixed.

### New

* The `magento/module-quote-graph-ql` is added to `composer.json` as a dependency.

## 2023-12-13 — Cegid Retail Y2 — Version 2.1.0

This version requires you to uninstall any older versions before [installing the plugin](/plugins/cegid-retail-y2/set-up-the-plugin#download-and-install-the-plugin) and requires a reboot.

### New

* We added support for optional printing of **Approved** shopper receipts.
* The Cegid Retail Y2 version is added to **appInfo** on transactional level for reporting purposes.

### Improved

* The number of transactions shown when you select **Reprint of last 25 receipts** is now decreased to 4. This enables increased visibility of the information on the receipts.
* We separated the CPOS installation directory from the Cegid Y2 path to enable an easier upgrade process for Cegid Y2.

### Fixed

* We fixed a critical bug in the Global Blue double swipe flow that could cause wrong payment details to be sent to Global Blue.

## 2023-12-06 — Salesforce Commerce Cloud - B2C Commerce — Version 23.3.1

*\<p>The features introduced in this release are only applicable for integrations with Store Front Reference Architecture (SFRA) versions 5 and 6. The latest version compatible with controller-based SiteGenesis is \<a href="https\://github.com/Adyen/adyen-salesforce-commerce-cloud/pull/984">v22.2.3\</a>.\</p>*

### Fixed

* On the checkout page, the payments methods are now shown to shoppers in [the order you defined in the Customer Area](/plugins/salesforce-commerce-cloud/set-up-payment-methods#arrange-payment-methods).
* For Apple Pay, the shipping and billing address fields are now updated correctly when shoppers input different addresses for shipping and billing. Previously, the billing address field was not updated correctly and got replaced by the shipping address.
* For Apple Pay express, the shopper's postal code is now shown on the order confirmation page shown to shoppers and on the order details page in the Salesforce Business Manager.
* When a shopper pays with Amazon Pay express, the configuration from the [/paymentMethods](https://docs.adyen.com/api-explorer/Checkout/latest/post/paymentMethods) response is now passed correctly for every region, and the component renders successfully after the redirect from Amazon. Previously, the response was not passed correctly and the express component failed to render after the redirect.
* For Klarna, the `additionalData.riskdata.basket.item[itemNr].amountPerItem` field is now populated in the Adyen Customer Area.
* For gift card payments that follow the [SALE flow](/plugins/salesforce-order-management-system/order-status-lifecycle/), the Salesforce Order Management System now creates payment records instead of payment authorisation records.
* If you use an [environment value](/development-resources/live-endpoints#live-endpoints-region) that belongs to a region other than the EU, the Google Pay Merchant ID validation checks are now handled correctly.
* When shoppers add a product bundle to their cart, the checkout page now correctly renders the payment methods. Previously, a session was not being created and shoppers could not proceed with the payment.
* We changed the metadata field namespace for Adyen Payment to `__Adyen_Payment_Method`. Previously, the namespace only contained one underscore (\_), and this caused an issue for some credit card payments.
* We removed the references to deleted constants from the undefined `blockedPaymentMethods`.
* For [zero-auth transactions](/get-started-with-adyen/adyen-glossary/#zero-value-auth), the [AUTHORISATION webhook](/development-resources/webhooks/webhook-types#event-codes) is now handled successfully. Previously, an error was thrown.

### Improved

* We changed the Apple Pay domain association file content type to `text/plain`, and added `/n` at the end of the text file. This allows to solve domain verification issues that sometimes occurred.
* We added the live URLs for [/orders](https://docs.adyen.com/api-explorer/Checkout/latest/post/orders), [/orders/cancel](https://docs.adyen.com/api-explorer/Checkout/latest/post/orders/cancel), and [/paymentMethods/balance](https://docs.adyen.com/api-explorer/Checkout/latest/post/paymentMethods/balance) endpoints to the `services.xml` metadata file, and you no longer have to define these manually to support partial payments.
* For Amazon Pay, we improved the way the `returnURL` is handled to adhere to industry best practices.
* You can now [enable and configure installments in the Salesforce Business Manager UI](/plugins/salesforce-commerce-cloud/set-up-payment-methods/#credit-card-installments).

![](/user/pages/docs/05.plugins/01.release-notes/2023-12-04-m7fo9/installments.png)

## 2023-12-05 — Adobe Commerce — Version 9.0.3

### Fixed

* The cron job that cancels expired Pay by Link orders is now optimized to fix memory issues that previously occurred.
* Invoices are now created after receiving a [CAPTURE](https://docs.adyen.com/api-explorer/Webhooks/1/post/CAPTURE) instead of [AUTHORISATION](https://docs.adyen.com/api-explorer/Webhooks/1/post/AUTHORISATION) webhook. Authorized payments that are not captured get the `Authorized` status. To select this status from your Adobe Commerce Admin Panel, go to **Order management** > **Order Status** > **Payment Authorization**.
* For partial captures, the response handler now correctly expects the `status` key instead of the invalid `response` key.
* For Oney payments, shopper information is now passed and an issue no longer occurs when placing orders.
* For Multistore implementations, the `storeId` is now passed correctly.

### Improved

* For Pay by Link, Boleto, and In-person payments, the plugin now uses Adyen payment adapters instead of Magento payment adapters.

### New

* Your shoppers can now make donations with Apple Pay.
* Unit tests that cover happy and unhappy flows for `OfferClosedWebhookHandler`, `CaptureWebhookHandler`, and `WebhookHandler`.
* For pre-authorizations, the webhook transition matrix now includes `ADYEN_AUTHORIZED` as a new order state.

### Changed

* To comply with EU consumer choice regulations, when card payment methods are available, the payment method list shows the group as Cards instead of Credit Cards.

## 2023-11-21 — NetSuite Payments Bundle — Version 1.20.06

### Fixed

* For Pay by Link invoices, the P/N reference now uses the original authorization reference instead of capture reference.

## 2023-11-10 — NetSuite Reconciliation Bundle — Version 1.5.6

### New

* When a deposit creation error occurs, a red error banner is now shown on the SDR.
* When an SDR has an error status, you can now select the **Export Execution Logs** button to export the logs.
* An **Adyen Help** button now appears in Settlement Detail Records.

### Improved

* We improved the performance of the `Adyen - Create Bank Deposit - Map/Reduce` script.

## 2023-10-26 — Adobe Commerce — Version 9.0.2

### Fixed

* When a shopper proceeds to pay with an Elo card, the installment options are now shown correctly.
* We added missing method definitions to the `Helper/Config.php` file.
* For [CAPTURE](https://docs.adyen.com/api-explorer/Webhooks/1/post/CAPTURE) responses that do not contain the `pspReference`, the `catch` function now works as expected and handles the exception message correctly.

## 2023-10-23 — NetSuite Reconciliation Bundle — Version 1.5.5

### New

* Added the **Bank Deposit Class** to the [Adyen SDR profile fields](/plugins/netsuite/reconciliation-bundle/#sdr-profile). When this field is set, the value is used for the bank deposit transactions created by the bundle.

## 2023-10-23 — Adobe Commerce — Version 9.0.1

*\<p>Follow the steps in the \<a href="/plugins/adobe-commerce/migrate-to-a-new-version">migration guide\</a> when upgrading to this version. \</p>*

### New

* Installments for tokenized payment methods.
* For Klarna payments, the plugin now supports multi-shipping.
* We added type declarations to the interfaces in the `Api/Data` directory.
* For payments with card tokens stored in Adobe Commerce Vault, the plugin now mounts the Adyen component on the checkout page, and shoppers need to enter their CVC to complete a payment.
* The plugin now uses [Web Components v5.51.0](/online-payments/release-notes/?integration_type=web\&version=5.51.0).
* Unit tests for the `GiftcardPayment` and `AuthorisationWebhookHandler` classes.
* End-to-end test pipeline for the new version.

### Changed

* The Adyen webhook notification endpoint is changed. See the [migration guide](/plugins/adobe-commerce/migrate-to-a-new-version?tab=migrate_to_version_9_0_1_1#step-4-change-your-webhook-server-configuration) to update your webhook URL configuration.
* The payment result redirect URL is changed to `https://THE_URL_OF_YOUR_STORE/adyen/return`.
* We renamed `AdyenHppConfigProvider` to `AdyenPmConfigProvider` and refactored the code.

### Improved

* All payment methods are now registered independently on the Adobe Commerce platform. Previously, payment methods were grouped into cards and alternative payment methods, this limited the ability to apply changes to the order of payment methods. With the separation of payment methods to their own files, payment methods will be sorted based on the order you set in your Customer Area.
* For integrations set up in [Automated mode](/plugins/adobe-commerce/set-up-adyen-customer-area/?tab=automated_1), it is now possible to choose between creating a new webhook or using an existing webhook when configuring the plugin. Previously, a new webhook was created in the Customer Area each time.
* If you use manual capture, the order state will now be set to `pending_payment` after receiving an AUTHORISATION webhook.
* We refactored the interfaces, classes, and `.js` files related to the `/payments/details` endpoint.
* You can now enable all payment methods that you have enabled in your Customer Area [by selecting a single button in the Adobe Commerce admin panel](/plugins/adobe-commerce/set-up-the-payment-methods-in-adobe-commerce).
* You no longer need an access token to complete your integration. Previously, the plugin used the Access Control List function of Adobe Commerce which required to set up an integration token and store that token in a front end headless application. This dependency is now removed and you can complete your integration with only customer tokens and guest endpoints.
* By default, the payment methods shown to shoppers during checkout are based on their billing address country/region. You can now override this with the [**ISO Country Code** setting](/plugins/adobe-commerce/set-up-the-payment-methods-in-adobe-commerce#alternative-payment-methods).
* We refactored our code to use one HTTP client for all transactions. Previously, MOTO transactions used a different HTTP client.
* For partial payments with gift cards, the **Payment Information** block in the admin panel and the **Payment method** summary shown to shoppers now display the amount paid with the gift card.
* For in-person payments, we removed redundant back-end elements and changed the way the plugin handles timeouts to improve implementation.
* We refactored the interfaces, classes, and .`js` files related to the `payments-detail` endpoint.
* Shoppers can now view and remove their tokens for [all recurring methods](/plugins/adobe-commerce/set-up-tokenization#set-up-vault) when they are logged in.
* For payment requests of guest shoppers, the `payment-status` endpoint now requires the `cardId` parameter.

### Breaking Changes

* The plugin configuration page in Adobe Commerce is restructured to make configuration simpler. The main changes are:

  * **Required settings** is now called [**Initial setup**](/plugins/adobe-commerce/set-up-the-plugin-in-adobe-commerce#step-3-configure-the-plugin-in-adobe-commerce).
  * The [**Accepting payments**](/plugins/adobe-commerce/set-up-the-payment-methods-in-adobe-commerce) section now includes everything you need to configure to start accepting payments.
  * The configuration for [in-person recurring payments](/plugins/adobe-commerce/set-up-in-person-payments#step-5-optional-set-up-recurring-payments) is moved to **Accepting payments**.
  * The **Alternative payment methods** section now only includes extra configuration fields required for specific payment methods.
  * There is a new **Admin Orders** section to configure [Pay by Link](/plugins/adobe-commerce/set-up-the-payment-methods-in-adobe-commerce#pay-by-link) and [MOTO](/plugins/adobe-commerce/set-up-the-payment-methods-in-adobe-commerce#moto).
  * The [**Order management**](/plugins/adobe-commerce/manage-orders) section is simplified.

* The plugin now [requires PHP 8.1](/plugins/adobe-commerce/migrating-to-a-new-version/#upgrade-php).

* The plugin now stores all token references in the [Adobe Commerce Vault](https://developer.adobe.com/commerce/php/development/payments-integrations/vault/). If you previously used Adyen tokenization, we added a script that migrates the tokens to the vault automatically when you upgrade.

* We implemented a new native gift card flow.

  * If you previously accepted gift card payments, you need to [verify the changes to the gift card flow](/plugins/adobe-commerce/migrate-to-a-new-version#step-6-verify-changes-to-the-gift-card-flow) when migrating to this version.
  * When a partial payment with a gift card is placed, you now receive an **ORDER\_OPENED** webhook from Adyen.

### Removed

* You can no longer configure `max_order_total` and `min_order_total` values for payment methods. This reverts the new feature introduced in [v8.17.0](/plugins/release-notes/#releaseNote=2023-03-23-magento-2-8.17.0).
* `Magento_Paypal` dependency.
* The notification that pops up when the plugin does not find an API key no longer appears.

### Fixed

* The country code is now fetched correctly when a logged-in shopper changes the billing address country/region during checkout. Previously, the country code was fetched from the default billing address of the shopper.
* Fixed an issue where refunds for partial payments failed because the `merchantAccount` was missing from the refund request.
* When a shopper cancels a credit card payment and changes the payment method to a gift card, the `cc_type` is now unset. Previously, the `cc_type` value was not updated correctly to reflect the payment method change.
* When the `merchantReference` field in the webhook body was empty, the webhook stayed at a processing state. The helper now checks if this field is set before executing the webhook processing logic.
* For manual capture, orders can now be voided if the shopper does not pay by canceling the invoice before canceling the order. Previously, the plugin created a pending invoice and the order could not be canceled when linked to an invoice.
* The **Pay** button for gift cards now correctly shows the shipping costs if the balance of the gift card covers the full amount.
* For shoppers who are logged in, the `getDefaultBillingAddress()` method is no longer called on the incorrect class.

## 2023-10-13 — Salesforce Order Management System — Version 2.1.0

### New

* The [base dependent `API Library Apex Adyen` package](/plugins/salesforce-order-management-system/install-and-set-up-the-package#before-you-begin) is now a prerequisite to set up the plugin.
* The plugin now uses [Checkout API v70](/online-payments/release-notes?integration_type=api\&version=70).
* Custom fields to identify the payment method used to place an order.
* For open invoice payment methods, we added the [lineItems](https://docs.adyen.com/api-explorer/Checkout/70/post/sessions#request-lineItems) object to the request.
* You can now enable the [Order on Behalf of (OOBO)](https://help.salesforce.com/s/articleView?id=sf.om_order_on_behalf_of_overview_oobo.htm\&type=5) feature in Salesforce OMS. Follow the [step-by-step guide](/plugins/salesforce-order-management-system/set-up-oobo) to enable OOBO in Salesforce.

### Improved

* We added enhanced UI fields to improve payment method identification.
* We refactored the code from a Salesforce First-Generation Managed Package to a [Second-Generation Managed Package](https://developer.salesforce.com/docs/atlas.en-us.pkg2_dev.meta/pkg2_dev/sfdx_dev_dev2gp_comparison.htm).

### Fixed

* For PayPal, you can now process partial refunds.

### Breaking Changes

* The Adyen Salesforce Order Management System package is now a [Second-Generation Managed package](https://developer.salesforce.com/docs/atlas.en-us.sfdx_dev.meta/sfdx_dev/sfdx_dev_dev2gp_pkg_whats_a_package.htm). Follow the [step-by-step guide](/plugins/salesforce-order-management-system/upgrade) to upgrade your plugin.

### Changed

* The package [namespace](https://developer.salesforce.com/docs/atlas.en-us.sfdx_dev.meta/sfdx_dev/sfdx_dev_unlocked_pkg_plan_namespaces.htm) is now `adyen_payment`. If you previously had custom automations based on the older namespace, you have to update them to the new namespace.
* In this version of the plugin, card payment methods are classified with the `CardPaymentMethod` record and all other payment methods are classified with the `AlternativePaymentMethod` record in your OMS Org. Previously, all payment methods were classified as card payments.
* Capture order reference is now based on the Salesforce fulfillment order number.

## 2023-10-04 — Salesforce Commerce Cloud - B2C Commerce — Version 23.3.0

*\<p>The features introduced in this release are only applicable for integrations with Store Front Reference Architecture (SFRA) versions 5 and 6. The latest version compatible with controller-based SiteGenesis is \<a href="https\://github.com/Adyen/adyen-salesforce-commerce-cloud/releases/tag/22.2.3">v22.2.3\</a>.\</p>*

### New

* Payment method: [Cash App Pay](/payment-methods/cash-app-pay/), a popular payment method in the US.
* You can now [enable HMAC signature verificiation](/plugins/salesforce-commerce-cloud/set-up-the-cartridge#1-set-up-webhooks-in-the-adyen-customer-area) for enhanced webhook security.
* For card payments, you can now [re-authorize payments](/account/manage-payments/#reauthorize-a-payment) from Salesforce Order Management System (OMS). To do this, the cartridge uses card tokens that are now synced to OMS.
* For failed orders, you can now see an event code overview in **Business Manager** > **Attributes** to implement order recovery.
* The cartridge now uses [Web Components v5.44.0](/online-payments/release-notes/?title%5B0%5D=Web%20Components%2FDrop-in\&version%5B0%5D=5.44.0).

### Improved

* Enhanced UI fields and dedicated Adyen log categories to improve cartridge troubleshooting.
* For Adyen Giving, you can now use diacritics in charity names and descriptions.
* `Adyen_CustomerEmail` attribute no longer saves the full order data.

### Fixed

* Fixed an [issue](https://github.com/Adyen/adyen-salesforce-commerce-cloud/issues/733) where some orders were not placed even after receiving an AUTHORISATION webhook.
* Removed optional chaining syntax from `.isml` files. Previously, this caused errors for shoppers without a profile.
* When shoppers use multiple gift cards for payment, the first gift card payment is no longer refunded. Previously, multiple orders were created in `/orders`, which resulted in unfulfilled orders.

### Breaking Changes

* We updated our [cartridge support schedule](/plugins/salesforce-commerce-cloud/#support-levels). We recommend [upgrading](/plugins/salesforce-commerce-cloud/upgrade) to the latest available version depending on your integration type (SFRA or SiteGenesis).

## 2023-09-25 — Adobe Commerce — Version 8.22.0

*\<p>formerly known as the Magento 2 plugin\</p>*

### New

* `OpenInvoice` helper class for Checkout, Capture, and Refund builders.

* Added new Amazon Pay [`paymentMethodVariant`](/development-resources/paymentmethodvariant/)s to the manual capture payment methods list:

  * visa\_amazonpay
  * mc\_amazonpay
  * amex\_amazonpay
  * discover\_amazonpay
  * maestro\_amazonpay
  * elo\_amazonpay
  * jcb\_amazonpay

### Changed

* Updated the Riverty/Afterpay payment method logo.

### Breaking Changes

* For partial payments with gift cards, we fixed an issue where `merchantAccount` was missing in the last item of the refund request and caused refunds to fail.
* The Google Pay fix introduced in [v8.21.0](/plugins/release-notes?version%5B0%5D=8.21.0) caused a validation issue for Amazon Pay payments. We isolated that fix for Google Pay in this version.
* For open invoice payment methods, `invoiceLines` for discounted orders are now calculated correctly.

## 2023-09-14 — Cegid Retail Y2 — Version 2.0.54

### Fixed

* We fixed the issue where the **Printer ID for Payment Receipt** setting in the CPOS back-end was ignored.
* We fixed the performance issue of the **Diagnosis** button in CPOS.
* We fixed the issue where the `Confirm or Decline Void by typing Yes or No` and other prompt messages were missing.
* When printing duplicate receipts and report of last 25 receipts, the plugin no longer considers the number of payments receipts to be printed configured in CPOS.

### Improved

* We simplified the communication logs between Cegid Retail Y2 and CPOS.
* The executable installation file now uses Visual Studio 2022.

## 2023-09-13 — NetSuite Reconciliation Bundle — Version 1.5.4

### Improved

* Improved the error details shown on the **Deposits** tab for SDRs that have the **Error Creating Deposits** status.

### New

* A **Retry Deposit Creation** button now appears for SDRs that have the **Error Creating Deposits** status.

## 2023-09-07 — Magento 2 — Version 8.21.0

### New

* You can now customize your log format by defining your preferred structure in the `di.xml` configuration.

### Fixed

* When a shopper has products without a price in their cart, the `number_format` parameter is no longer set to `null`. Previously, this caused a PHP 8 error.
* For multiple partial refunds, statuses are now included in the `adyen_creditmemo` table.
* For MOTO refunds, an error message used to appear when creating a credit memo even if the refund was processed. This issue is now fixed.
* For recurring payments initiated from the admin back-end, `UnscheduledCardOnFile` and `Subscription` token types are now correctly filtered.
* For Google Pay, shoppers can now place an order when the billing address field is empty.

## 2023-09-01 — Shopware 6 — Version 3.14.0

### New

* The plugin now supports [Click to Pay](/payment-methods/cards/click-to-pay).
* The plugin now uses [Adyen PHP API Library v15.0.0](https://github.com/Adyen/adyen-php-api-library/releases/tag/v15.0.0) and [Web Components v5.49.2](/online-payments/release-notes?integration_type=web\&version=5.49.2).

### Fixed

* For gift cards, when you set a transaction amount limit, the maximum amount that can be redeemed is now the same as that limit instead of the balance of the gift card.
* When a shopper has a product without a price or with full discount in their cart, the plugin no longer throws a [500 error](/errors/#http-status-codes).

## 2023-08-23 — Salesforce Commerce Cloud - B2C Commerce — Version 23.2.1

*\<p>The features introduced in this release are only applicable for integrations with Store Front Reference Architecture (SFRA) versions 5 and 6. \</p>*

### New

* The `int_custom_cartridge` cartridge folder that shows the way to modularize customizations to enable quick upgrades. Follow the [step-by-step guide](/plugins/salesforce-commerce-cloud/customization-guide#add-custom-code-in-a-separate-cartridge) to extract customizations into the custom cartridge.

### Improved

* You can now define a pipeline alias.
* You can now enable card installments globally using the Installments configurator.
* For all partial payments using gift cards, the `Merchant Reference` value is now the same so that all the partial payments are associated with the same order.

### Fixed

* On the Order Confirmation page, voucher details now show after the shopper pays with a voucher method like Multibanco or Boleto.

* Custom metadata fields in SFCC now properly sync with OMS.

* On the checkout page, when the gift card payment method isn't enabled in your Customer Area, the gift card option is no longer shown.

* For Apple Pay:

  * On the live environment, there is now a domain association file.
  * The Apple Pay button now renders asynchronously.

* The custom field `Adyen_paymentMethod` is now populated correctly with the payment method type.

* Only Adyen payment methods can now trigger the handling of Adyen Giving.

* For Amazon Pay, the Adyen Checkout script on the mini cart now loads before the Amazon script.

* When a gift card is used for an order amount less than the gift card amount and the **Cancel** button is clicked in the order review page, the gift card is removed and the amount is updated.

## 2023-08-21 — NetSuite Reconciliation Bundle — Version 1.5.3

### New

* Added the **Total Deposit Amount** to the [Adyen SDR profile fields](/plugins/netsuite/reconciliation-bundle/#sdr-profile). This field is set automatically when bank deposits are generated for an SDR.

## 2023-08-08 — Magento 2 — Version 8.20.0

### New

* The plugin now supports tokenization for Apple Pay with the [recurringProcessingModel](https://docs.adyen.com/api-explorer/Checkout/latest/post/payments#request-recurringProcessingModel) types `Subscription` and `UnscheduledCardOnFile`.
* New unit tests for the `CancelOrRefundWebhookHandler` class.

### Fixed

* For payments with multiple partial captures, the `adyen_creditmemo` table is now correctly updated.
* The missing API Key message no longer appears after installation when the plugin does not find an API Key.

### Improved

* The plugin now uses [Web Component v5.49.2](/online-payments/release-notes/?integration_type=web\&version=5.49.2).
* The plugin now uses [Adyen PHP API Library v15.0.0](https://github.com/Adyen/adyen-php-api-library/releases/tag/v15.0.0).

## 2023-08-01 — NetSuite Payments Bundle — Version 1.20.05

### New

* Added the Customer Deposit Pay by Link feature that allows to [tokenize](/online-payments/tokenization) and store your shopper's payment details in NetSuite.
* For Pay by Link payments, shoppers can now use their tokenized payment details when **Payment Instruments** is turned on.
* After completing a Pay By Link payment, shoppers are now redirected to the store website.

### Fixed

* Fixed a bug in the `Invoice Pay by Link Payment Creation` script.

## 2023-07-20 — NetSuite Reconciliation Bundle — Version 1.5.2

### Fixed

* When an error occurs in the `Adyen - Create Bank Deposit - MR` script, the `Adyen - Create Bank Deposit V1` script is no longer triggered.

## 2023-07-05 — Shopware 6 — Version 3.12.1

### New

* For open invoice payments, you can now enable [automatic capture](/plugins/shopware-6/manage-orders-in-shopware#automatic-capture-for-open-invoice-payment-methods) and [capture on shipment](/plugins/shopware-6/manage-orders-in-shopware#capture-on-shipment-for-open-invoice-payment-methods).
* Introduced the option to [enable manual capture](/plugins/shopware-6/manage-orders-in-shopware#manual-capture) for all payment methods that support manual capture. Previously, only open invoice payment methods supported manual capture.
* The plugin now uses [Web Components v5.41.0](/online-payments/release-notes?integration_type=web\&version=5.41.0) and [Checkout API v70](/online-payments/release-notes?integration_type=api\&version=70).

### Fixed

* For partial gift card payments, the gift card payment method no longer disappears from the checkout page after selecting another payment method to complete the payment.
* For donations requests, donation currency and amount are now validated to match the original order currency and pre-configured donation amounts.
* Fixed an issue where a null or undefined `updatedAt` value in the `adyen_notification` database table caused an error.

## 2023-06-29 — Magento 2 — Version 8.19.0

### Known Issues

* For SVS gift card payments, Adyen does not send an [OFFER\_CLOSED](https://docs.adyen.com/api-explorer/Webhooks/latest/post/OFFER_CLOSED) webhook for [expired payments](/plugins/adobe-commerce/manage-orders#expired-payments) and offers are not closed automatically if shoppers abandon the payment session.

### Fixed

* Payment offers for SVS gift card payments are now closed automatically if shoppers abandon the payment session by selecting the **Previous** button on the payment page. This is a partial fix for the known issue in this version.

### New

* New unit tests for the `AuthorisationWebhookHandler` helper class.

## 2023-06-19 — NetSuite Reconciliation Bundle — Version 1.5.1

### New

* Added the **Use Next Date for Evening Deposits** to the [Adyen SDR Profile fields](/plugins/netsuite/reconciliation-bundle/#sdr-profile). When checked, orders with a settlement time after 5:00 PM Pacific time, will show the date of the following day for the **Deposit Date** on the SDR.

## 2023-06-13 — NetSuite Reconciliation Bundle — Version 1.5.0

### New

* Added the **Invoice Deduction Account** to the [Adyen SDR Profile fields](/plugins/netsuite/reconciliation-bundle/#sdr-profile). This field should be set to the Expense Account that the Invoice Deduction SDR line should map to.

## 2023-06-05 — Cegid Retail Y2 — Version 2.0.47

### New

* Line item display is now supported by all terminals.

### Fixed

* The total purchase amount is now updated correctly when an item is removed.

## 2023-06-05 — Salesforce Commerce Cloud - B2C Commerce — Version 23.2.0

*\<p>The features introduced in this release are only applicable for integrations with Store Front Reference Architecture (SFRA) versions 5 and 6. \</p>*

### New

* The plugin now supports [Click to Pay](/payment-methods/cards/click-to-pay) and [Klarna payment widget](/plugins/salesforce-commerce-cloud/set-up-payment-methods#klarna-payment-widget-optional), which improves the checkout experience for your shoppers and increases conversion.

  Click to Pay is available as a pilot feature. To join the pilot program, reach out to your Adyen contact.

### Improved

* The plugin now uses [Checkout API v70](/online-payments/release-notes/?integration_type=web\&version%5B0%5D=70#releaseNote=2023-01-30-checkout-api-70) and [Web Component v5.40.0](/online-payments/release-notes/?title%5B0%5D=Web%20Components%2FDrop-in\&version%5B0%5D=5.40.0).
* We cleaned up transpiled code to make cartridge installation and customization easier.
* We refactored the code for Adyen Giving.

### Breaking Changes

* For customized integrations, [Checkout API v70](/online-payments/release-notes/?integration_type=web\&version%5B0%5D=70#releaseNote=2023-01-30-checkout-api-70) and [Web Component v5.40.0](/online-payments/release-notes/?integration_type=web\&version%5B0%5D=5.40.0#releaseNote=2023-04-17-web-componentsdrop-in-5.40.0) may introduce breaking changes. Check if your custom code is compatible with the changes introduced in these API and Web Components versions.

## 2023-05-05 — NetSuite Payments Bundle — Version 1.20.04

### Fixed

* The `GENERAL TOKEN: PAYMENT METHOD` and `PAYMENT CARD TOKEN: PAYMENT METHOD` fields required for tokenization are no longer missing on the **Custom Preferences** tab.

## 2023-05-03 — Salesforce Commerce Cloud - B2C Commerce — Version 23.1.2

*\<p>The features introduced in this release are only applicable for integrations with Store Front Reference Architecture (SFRA) versions 5 and 6. \</p>*

### New

* You can now use a new version of Adyen Giving to let your shoppers make card or SEPA donations with iDEAL.

### Improved

* Checkout API and Web Components versions between Site Genesis and SFRA are decoupled to improve code modularity.

### Fixed

* Shoppers can now cancel the QR component with a button instead of refreshing the page or waiting for expiry.
* For PayPal transactions, a validation step is added to ensure that the email input field is populated to prevent failed orders.
* The components are re-rendered after each partial payment to ensure the correct amount is passed to the request.
* The tax amount now synchronizes correctly for each line item between SFCC and Klarna playground.

## 2023-04-20 — Magento 2 — Version 8.18.0

### New

* The plugin now supports [Click to Pay](/payment-methods/cards/click-to-pay).

  Click to Pay is available as a pilot feature. To join the pilot program, reach out to your Adyen contact.

### Fixed

* The `allowRecurringonPaymentMethod` function no longer throws an exception when no payment method is selected for recurring payments with alternative payment methods. The function now returns `false` when no payment method is selected to tokenize.
* For country codes that have different values in the Adyen API and Adobe Commerce, country code mapping is added to resolve conflicts.
* Shoppers can now pay with their Mastercard standard debit cards.
* The Google Pay component now shows the merchant account on the checkout page.
* Webhook notifications that reach the maximum error count (**5**) are now handled set to `done`.

### Improved

* The plugin now uses [Checkout API v70](/online-payments/release-notes?integration_type=api#releaseNote=2023-01-30-checkout-api-70) and [Web Component v5.38.0](/online-payments/release-notes#releaseNote=2023-03-27-web-componentsdrop-in-5.38.0).

## 2023-04-17 — NetSuite Payments Bundle — Version 1.20.03

### Fixed

* We revised the way we send Klarna transactions to account for line item details. Previously, line item details weren't accounted for and this resulted in an unexpected error in the Hosted Checkout interface when shoppers clicked to pay with Klarna.

## 2023-03-29 — Salesforce Commerce Cloud - B2C Commerce — Version 23.1.1

### Improved

* For SFRA integrations, the loading spinner is now shown when express payment method buttons are loading.

* There are changes to the custom configuration page of the plugin:

  * Added a new front-end region drop-down list.
  * Added Google Merchant ID.
  * Improved description fields.

### New

* For SFRA integrations, address details and payment string is now shown on the Amazon Pay review page.

### Fixed

* The Amazon Pay button no longer flickers on mobile.
* For SFRA integrations, a **Cancel** button is added for gift cards.
* For SFRA integrations, the gift card component now renders correctly on Safari.
* The API version used for the `getPaymentMethods` endpoint in test is now consistent with live.
* Open invoice methods are now checked correctly to include all open invoice methods. Previously, [Afterpay](/payment-methods/afterpaytouch) was not included in the group of open invoice methods.
* For each gift card, a payment instrument is created for all payments that use the `paymentFromComponent` flow.
* For SFRA integrations, the remaining amount is now shown correctly when the order amount is covered by a gift card.
* For credit card payments, the webhooks are now processed correctly.
* For SFRA integrations, the gift card container is no longer visible when gift cards are not activated.

## 2023-03-25 — NetSuite Payments Bundle — Version 1.20.02

### Fixed

* Navigating back to NetSuite from an external checkout page without completely processing a payment now results in a pending state instead of an error.

## 2023-03-23 — Magento 2 — Version 8.17.0

### New

* You can now configure `max_order_total` and `min_order_total` values for all payment methods.
* For Magento Vault payments, shoppers are now required to enter their CVC.

## 2023-03-10 — Magento 2 — Version 8.16.0

### New

* You can now submit support requests directly from the Magento admin interface.
  * Go to **System** > **Adyen&#x20;**> **Support** to troubleshoot your issue. On this page, you can select your issue and find relevant documentation. If you need further assistance, click **I still need help** to create a support ticket.
* [Idempotency keys](/development-resources/api-idempotency) are supported for [`/payments`](https://docs.adyen.com/api-explorer/Checkout/70/post/payments), [`/payments/details`](https://docs.adyen.com/api-explorer/Checkout/70/post/payments), [`/donations`](https://docs.adyen.com/api-explorer/Checkout/70/post/donations), [`/payments/{paymentPspReference}/captures`](https://docs.adyen.com/api-explorer/Checkout/70/post/payments), [`/payments/{paymentPspReference}/refunds`](https://docs.adyen.com/api-explorer/Checkout/latest/post/payments/_paymentPspReference_/refunds), and [`/payments/{paymentPspReference}/cancels`](https://docs.adyen.com/api-explorer/Checkout/latest/post/payments/_paymentPspReference_/cancels) requests.

## 2023-02-27 — Salesforce Commerce Cloud - B2C Commerce — Version 23.1.0

*\<p>The features introduced in this release are only applicable for integrations with Store Front Reference Architecture (SFRA) versions 5 and 6. \</p>*

### New

* New payment methods:

  * Apple Pay Express: only available for Safari.
  * Amazon Pay Express

* In the Business Manager configuration page, you can now configure express payment methods.

* Unit test coverage for Express payment methods.

* Shoppers can now pay with multiple gift cards as part of a partial payment flow.

* You can now [enable Apple Pay using Adyen's Apple Pay certificate](/plugins/salesforce-commerce-cloud/set-up-payment-methods?tab=use_adyen_s_apple_pay_certificate_1). When you do this, you will also have the option to configure [tokenization](/online-payments/tokenization).

### Improved

* Updated 3DS2 challenge locator.
* Payment instruments synchronization between Salesforce Commerce Cloud and Salesforce Order Management is now improved to show the payment method names.

## 2023-02-16 — Shopware 6 — Version 3.10.0

### New

* New payment method: [Open banking](/payment-methods/open-banking)
* The plugin now uses [Web Components v5.33.0](/online-payments/release-notes?integration_type=web\&version=5.33.0).

### Fixed

* [Custom Product items](https://docs.shopware.com/en/shopware-6-en/extensions/customproducts) are no longer considered `options` instead of `product`. Previously, this caused those line items to be skipped for open invoice payment methods.
* For headless integrations, the base url is now generated correctly when being redirected to show the payment result.

## 2023-02-16 — Magento 2 — Version 8.15.0

### New

* Added the option to use queue or cron (default) for notification webhook processing.
* New unit tests for the `CreditMemo` and `Management` helper classes.
* CodeQL analysis scanning.

### Fixed

* The [REPORT\_AVAILABLE](https://docs.adyen.com/api-explorer/Webhooks/1/post/REPORT_AVAILABLE) webhook no longer fails when the `merchant_reference` field is missing. Instead, an error message is logged for the unsupported webhook.
* For headless integrations, the donation token is now returned correctly. Previously, the response was not parsed correctly and blocked Adyen Giving.

### Changed

* Moved Adyen Payments plugin to **RECOMMENDED SOLUTIONS** section.
* Moved webhook processor configuration to **Advanced Settings**.

## 2023-02-10 — NetSuite Payments Bundle — Version 1.20.01

### Changed

* Hosted Checkout now replaces Hosted Payment Pages.

### Fixed

* When using the inline editing feature, a new URL is now generated.

## 2023-01-27 — Magento 2 — Version 8.14.0

### New

* You can now test your webhook configurations from the [Management API](https://docs.adyen.com/api-explorer/Management/latest/overview) by sending a test notification with the AUTHORISATION event code.
* Introduced new Unit tests in CaseManagement.php to increase the test coverage of our code base.

### Fixed

* [Level 2 and 3 data](/payment-methods/cards/enhanced-scheme-data/l2-l3) is only sent for credit card payments instead of every payment method.
* After the shopper gets redirected to the success page, they no longer get redirected to the payment method page again.

## 2023-01-19 — Shopware 6 — Version 3.9.0

### New

* Shoppers can now fill gift card details in the shopping cart view.
* The plugin now supports partial payments with gift cards.

### Fixed

* A failed payment authorisation no longer overrides the following successful authorisation.
* The plugin can now split house numbers that contain a `-`. Previously, using the `-` character in the street field caused payments to fail.
* The `component_payment_method_description` no longer fails to load the plugin component when payment method description is missing.
* Sales channel is no longer ignored for CAPTURE and REFUND requests. Previously, ignoring the sales channel prevented loading the correct configuration and caused these requests to fail for merchants with custom configurations.

### Improved

* The plugin now uses [Web Components v5.23.1](/online-payments/release-notes?integration_type=web\&version=5.23.1) and [Checkout API v69](/online-payments/release-notes?integration_type=api\&version=69).

### Breaking Changes

* This version includes breaking changes for merchants accepting payments with gift cards. Gift card flow now goes through [`/orderAPI`](https://developer.salesforce.com/docs/atlas.en-us.api_placeorder.meta/api_placeorder/sforce_placeorder_rest_api_standalone.htm) endpoint instead of HPP fallback. The change requires a modification in your account settings, reach out to our [Support Team](https://ca-test.adyen.com/ca/ca/contactUs/support.shtml?form=other) to set this up.

## 2023-01-13 — Magento 2 — Version 8.13.0

### New

* For headless integrations, you can specify `recurringProcessingModel` in the `/payment-information` [Magento 2 REST API](https://magento.redoc.ly/2.4.5-customer/tag/cartsminepayment-information) request to override default values in the plugin configuration.
* **Cloud API** labels and placeholders are renamed to **POS Terminal Payment** in the plugin interface.

### Fixed

* For POS installment payments, the configuration for the same minimum amount is fixed.
* For [alternative payment methods](/plugins/adobe-commerce/set-up-the-payment-methods-in-adobe-commerce#alternative-payment-methods), the `brand_code` parameter is removed. Previously, this parameter caused headless Klarna payments to fail.
* Implemented API logging in the module for requests and responses.

### Update

## 2022-12-30 — Magento 2 — Version 8.12.0

### New

* You can now store Klarna payment details as recurring tokens. You can use the stored payment details for `Subscription` and `UnscheduledCardonFile` payments.
* In the Magento admin panel, you can now download the live Apple Pay domain association file.
* The open invoice function now supports Walley payment method.

### Fixed

* Adyen Pay by Link now works for virtual products.
* For Amazon Pay payments with the **US** country code, the payment form also includes a field for region code or state.

## 2022-12-29 — Salesforce Commerce Cloud - B2C Commerce — Version 22.2.2

### New

* End-to-end tests for Store Front Reference Architecture (SFRA) 5, SFRA 6, and SiteGenesis.
* For SFRA, multiple gift card brands are now supported by the new native gift card flow.

### Improved

* The cartridge now uses [Node.js version 14](https://nodejs.org/docs/latest-v14.x/api/).
* For 3D Secure 2 authentication, the cartridge now uses the [authenticationData.threeDSRequestData.nativeThreeDS](https://docs.adyen.com/api-explorer/Checkout/latest/post/payments#request-authenticationData-threeDSRequestData-nativeThreeDS) field instead of the deprecated `additionalData.allow3DS2` one.

### Removed

* Custom 3D Secure settings in the configuration page.

### Fixed

* The payment confirmation page now shows details of the gift card brand that the shopper pays with..
* Custom site preferences that are now set correctly.
* For Google Pay, the merchant ID configuration property is now `merchantId`.
* The shopper now receives only one confirmation email.

## 2022-12-15 — Cegid Retail Y2 — Version 2.0.46

### New

* Double swipe flow for Global Blue tax-free shopping.

### Fixed

* When referenced refund is configured in CPOS, the refund no longer falls back to unreferenced refund.
* You can now [set Void behavior](/plugins/cegid-retail-y2/set-up-the-plugin#configure-cegid) to automatic, ignored, or prompt for confirmation.

### Improved

* The plugin now embeds all necessary external dependencies and you no longer need to download Microsoft Visual C++ or other Microsoft components manually. This fixes the known issue in v2.0.36.

## 2022-12-02 — Magento 2 — Version 8.11.0

### Fixed

* For debit combo card payments, the `fundingSource` parameter is added to avoid conflicts. Previously, card type and brand were overridden which was vulnerable to conflicts.
* Fixed the credit memo creation condition for partial refunds initiated from the Adyen Customer Area.

### New

* Added `checkout_frontend_region` configuration in the `StoreConfig` object in GraphQL.

### Improved

* Removed credit card type selector from the plugin. Instead, the card types are fetched from the Adyen Customer Area.
* For multishipping credit card component, available credit card brands are now fetched from the [`/paymentMethods`](https://docs.adyen.com/api-explorer/Checkout/latest/post/paymentMethods) response.
* Updated checkout component to [v.5.29.0](/online-payments/release-notes#releaseNote=2022-11-09-web-componentsdrop-in-5.29.0).

## 2022-11-18 — Salesforce Commerce Cloud - B2C Commerce — Version 22.2.1

### Improved

* The cartridge now uses [Web Components v5.28.0](/online-payments/release-notes#releaseNote=2022-10-10-web-componentsdrop-in-5.28.0) and [Checkout API v69](/online-payments/release-notes?integration_type=api\&version%5B0%5D=69#releaseNote=2022-05-24-checkout-api-69).
* You can now persist gift card information in the payment form after the shopper has filled in the gift card information.

### New

* Support for the new India live environment. Use this environment with the corresponding India location-based live endpoint.
* A custom [Business Manager configuration page](/plugins/salesforce-commerce-cloud/set-up-the-cartridge#set-up-the-business-manager).
* New supported payment method: [UPI](/payment-methods/upi).
* Added a native gift card flow to the SFRA cartridge.

### Fixed

* Shoppers can no longer choose payment methods that are blocked for their locale.
* Bancontact configuration is now independent from card configuration.
* Payment method fields now sync with OMS.
* Card brands are no longer shown under the card number input field.
* The update status attribute is now in custom metadata attributes.

### Breaking Changes

* For gift cards, the payment flow now goes through the [/orders](https://docs.adyen.com/api-explorer/Checkout/latest/post/orders) endpoint instead of HPP fallback. The change requires a modification in your account settings, reach out to our [Support Team](https://ca-test.adyen.com/ca/ca/contactUs/support.shtml?form=other) to set this up.

## 2022-11-17 — Magento 2 — Version 8.10.0

### New

* Open Invoice function now supports [Atome](/payment-methods/atome) payment method.

### Fixed

* Notification IP address validation is now optional.
* When there is no order found, the `getOrderByIncrementId` function no longer returns `false` instead of `null`.
* An empty array will be returned now if a webhook has no `additonalData`. Previously, calling the `updateOrderPaymentWithAdyenAttributes` function that requires an array caused an issue.
* When exceptions are caught, webhooks are no longer processed.
* An error no longer occurs when multiple payments are made for an order.
* When a shopper wants to save card details for 3D Secure 2 payments, the `vault_payment_token` is now generated correctly.
* Shoppers are no longer asked to fill billing and shipping address fields twice when they select the Affirm payment method.
* Added missing environment variables for end-to-end tests.

### Improved

* If a shopper selects click and collect for shipping, the [`openinvoicedata.merchantData`](https://docs.adyen.com/api-explorer/Checkout/latest/post/payments#request-additionalData-AdditionalDataOpenInvoice-openinvoicedata-merchantData) field can now include this information.
* For Klarna payments using Pay by Link, the required invoice information is now included in the payment request.
* It is now possible to differentiate between multiple credit memos when shoppers make partial refunds.
* New unit tests are added for the `Invoice` helper class.

## 2022-11-04 — Magento 2 — Version 8.9.0

### New

* The **ORDER\_CLOSED** notification webhook can now be processed.

### Fixed

* The comparison between notification value and order amount no longer fails. Previously, the plugin added a decimal for specific currencies and caused mismatch errors with currencies that do not have decimal digits like JPY.

### Improved

* New Refund Data Builder files are introduced that have a single purpose of fetching merchant account information depending on whether the refund was initiated from MOTO or non-MOTO merchant account. Previously, separate Refund Data Builder files caused logic duplication.
* The plugin now uses [Web Components v5.28.2](/online-payments/release-notes?integration_type=web#releaseNote=2022-10-24-web-componentsdrop-in-5.28.2)
* Updated the **More Information** link of card tokenization.
* Removed the **Close** button **from payment action modal.
* Updated street number and house number parsing so that more options can be parsed.

## 2022-10-21 — Magento 2 — Version 8.8.0

### New

* You can now refund Magento payments in your Adyen Customer Area.
* You can now create a Pay By Link order with an API request.
* Support for Twint recurring payments of the type **Subscription** and **UnscheduledCardOnFile**.
* You can now offer installments for POS payments on merchant initiated orders. Enable this in your **POS** configuration.
* Shoppers in Brazil and Mexico with combo cards can now choose if they pay with debit or credit.
* Express Checkout support for [Apple Pay](/payment-methods/apple-pay) and [Google Pay](/payment-methods/google-pay).

### Improved

* Added the Twint logo.

### Fixed

* For [MOTO](/plugins/adobe-commerce/set-up-the-payment-methods-in-adobe-commerce#moto) payment methods, the plugin now gets MOTO accounts that match the store ID.
* The plugin now automatically adds 3 digits to each `shopperReference`. Previously, a `shopperReference` with less than 3 digits caused an error in the API request.
* Authorized payments no longer trigger the **OFFER\_CLOSED** notification webhook.
* The timeout for API requests is now 120 seconds.

## 2022-10-07 — Magento 2 — Version 8.7.0

### New

* For in-person payments, shoppers can now pay with more than one card.

* You can now manually configure the HMAC key.

* Recurring payments for new payment methods.

  * Google Pay: supports the `CardOnFile`, `Subscription`, and `UnscheduledCardOnFile` recurring payment types.
  * PayPal: supports the `Subscription` and `UnscheduledCardOnFile` recurring payment types.
  * Magento Vault card: supports the `CardOnFile` and `UnscheduledCardOnFile` recurring payment types.

* Shoppers can now delete their stored payment details.

* Unit tests for Adyen Order Payment helper.

* End-to-end workflow for integration tests.

### Fixed

* For payments that go through 3D Secure 2 authentication, the shopper can no longer select the **Close** button **in the browser or **esc** key on their keyboard to cancel the payment. The shopper can instead select the **Cancel** or **Go Back** button.
* In the test environment, you can now configure the plugin without webhook settings and an HMAC key.
* Address validation in the payment form now accepts more address formats.

## 2022-09-23 — Magento 2 — Version 8.6.0

### New

* The plugin can now handle capture requests triggered from Customer Area.
* To comply with new regulations in India to store data in Indian servers, the plugin now makes request to endpoints hosted in the India-based date center.

### Improved

* Continuous integration tests now include the MOTO flow.

* In the test environment, full requests and responses are included in the log.

* All lines in the `notification.log` file contain the following identifiers:

  * `PSP reference`
  * `Merchant reference`
  * `UID`

### Fixed

* The plugin now sets and uses region-based endpoints.
* For virtual products, the plugin now makes the payment method request when the shopper goes to checkout. Previously, the plugin failed to make payment method requests for virtual products because of missing shipping address information.

### Removed

* The log no longer includes full request and response information.

## 2022-09-22 — NetSuite Payments Bundle — Version 1.19.00

### New

* We enabled ACH payment instrument implementation with full control from the NetSuite environment.
* You can now create Pay by Link tokens using the PSP reference if other values are omitted in the raw response.
* You can now [create a payment card token](/plugins/netsuite/tokenization-in-netsuite) without using the CVV/CVC/CSC.

### Fixed

* We fixed a bug that prevented the CVV/CVC/CSC field from remaining populated.

## 2022-09-08 — Magento 2 — Version 8.5.0

### New

* When creating admin orders, you can now select the terminal payment method for point-of-sale payments.
* For all requests from a headless integration to get Adyen payment methods, the payment method names are now translated based on the `shopperLocale` value.

### Improved

* In the **Required Settings** section, tooltips and descriptions have been updated to provide more information.
* For Apple Pay, `txVariants` are now more descriptive and are returned if the payment method is not named in the payment method list. For example, `elodebit_applepay`, `visa_applepay`, and `mc_applepay`.
* Added support for Magento v2.4.5 to integration and functional tests.
* The Multishipping success page now has a check to verify if an Adyen payment method was used.

### Fixed

* Log files are no longer duplicated.
* When **Capture delay** is set to **Manual**, and **Use auto-capture for OpenInvoice payments** is enabled, the [/payments](https://docs.adyen.com/api-explorer/Checkout/latest/post/payments) request to Adyen now includes `captureDelayHours = 0`.

## 2022-08-30 — Salesforce Commerce Cloud - B2C Commerce — Version 22.1.1

### New

* When an API request fails, the cartridge retries the request three times with an [idempotency key](/development-resources/api-idempotency).

### Improved

* The cartridge now uses [Web Components v5.18.0](/online-payments/release-notes?integration_type=web\&version=5.18.0).

### Fixed

* Fields that collect Brazilian [CNPJ](https://en.wikipedia.org/wiki/CPF_number) and [CPF numbers](https://en.wikipedia.org/wiki/CNPJ) have been removed, so the data isn't logged. Additionally, less payment request data is now stored in the Business Manager.
* For Ratepay payments, fingerprints are now generated and submitted properly.

## 2022-08-26 — Magento 2 — Version 8.4.0

### New

* In required settings, you can now set **Configuration Mode** to **Automated**: when set, automated IP address checks happen when setting up webhooks.
* [MOTO](/plugins/adobe-commerce/set-up-the-payment-methods-in-adobe-commerce#moto) flow implementation. You must enable this even if you previously processed MOTO payments.

### Fixed

* Unsupported webhook notifications are no longer processed.
* For Boleto, CNPJ identification numbers are now supported. Previously, only CPF numbers were supported.
* Payment method logos are now updated.

### Improved

* For Pay By Link payment links, there is a counter for failed payment attempts. After five failed payment attempts, an order is closed.
* The plugin now uses [Adyen API library for PHP v13.0.1](https://github.com/Adyen/adyen-php-api-library/releases/tag/13.0.1).
* The plugin now uses [Web Component v5.21.0](/online-payments/release-notes?integration_type=web\&version=5.21.0).
* Log files are no longer duplicated.
* Information in log files are formatted for easier readability.
* The PHP library no longer has duplicate and reuse manual capture list.

## 2022-06-30 — Magento 2 — Version 8.3.0

### New

* Rate limiting notifications mitigate brute force attacks when webhook password or username authentication fails.

### Improved

* We added a separation line between the Credit Card payment method and the next payment methods to improve the clarity of the checkout page.
* The plugin now uses [Web Components v5.16.0](/online-payments/release-notes?integration_type=web\&version=5.16.0#releaseNote=2022-05-23-web-componentsdrop-in-5.16.0).

### Fixed

* The [iDEAL issuer](/payment-methods/ideal/web-component#issuer-ids) selector dropdown menu now does not overlap with the **Order Summary** section.
* When an order does not include an Adyen payment method, the plugin will not update the Magento order status.
* When a shopper clicks on the **Back to Shop** button when using [Dotpay Bank Transfer](https://docs.adyen.com/payment-methods/dotpay), the plugin no longer throws an error.
* There are now no conflicts if the plugin is used with [Braintree](https://www.braintreepayments.com/nl).

## 2022-05-23 — Salesforce Commerce Cloud - B2C Commerce — Version 22.1.0

### New

* Payment methods are supported out of the box, because the cartridge now dynamically handles actions on the front end.
* Shoppers can now complete authentication during checkout with [Native 3D Secure 2](/plugins/salesforce-commerce-cloud/set-up-payment-methods#3d-secure-2).

### Breaking Changes

* For customized integrations, some changes in this version may be breaking changes, depending on your custom code:

  * Payment methods are now retrieved by [creating a payment session](/online-payments/build-your-integration/sessions-flow/?platform=Web\&integration=Components#initialize-the-payment-session), using the [/sessions](https://docs.adyen.com/api-explorer/#/CheckoutService/v68/post/sessions). After the session is created, the Web Components will be rendered on the storefront.
  * Payment actions are handled with front end code.
  * Orders are now retrieved with an order token.
  * Native 3D Secure 2 Authentication.
  * [Checkout API v68](/online-payments/release-notes?integration_type=api\&version%5B0%5D=68#releaseNote=2021-10-06-checkout-api-68).

### Improved

* The cartridge now uses [Web Components v5.6.1](/online-payments/release-notes?integration_type=api\&version%5B0%5D=5.6.1#releaseNote=2022-01-18-web-componentsdrop-in-5.6.1) and [Checkout API v68](/online-payments/release-notes?integration_type=api\&version%5B0%5D=68#releaseNote=2021-10-06-checkout-api-68).
* More cartridge end-to-end tests check that all payment methods are working properly.
* Web Components are now pre-filled with data that a shopper has already entered during checkout.
* When a shopper selects the back button in their browser after being redirected to a payment method page, their cart is now automatically restored.
* For AmazonPay, shoppers can now retry their payment if it was initially declined.
* You can now more easily implement payment methods with QR codes.
* All cartridge paths are now absolute paths. This makes it easier to customize your integration.

### Fixed

* [Sale payment methods](https://documentation.b2c.commercecloud.salesforce.com/DOC1/index.jsp?topic=%2Fcom.demandware.dochelp%2FOrderManagement%2FProviders%2FPayment%2FPaymentServiceProviders.html) are now compatible with [Salesforce OMS](/plugins/salesforce-order-management-system).
* The cartridge now correctly handles the export status of an order.
* If a PayPal payment fails, the loading spinner now closes automatically.
* The services metadata now include all live endpoints.
* The cartridge logs now reflect when the Adyen Giving configuration is incomplete.
* The cartridge now correctly handles order numbers that contain hyphens.

## 2022-04-06 — Magento 2 — Version 8.2.0

### Changed

* The **Clone quote on failed payment configuration** field is removed from the Magento Checkout Experience panel. The quote is now restored by default in a more secure manner.

### New

* We introduced an option to individually reprocess [notifications](/development-resources/webhooks).
* If an [Amazon pay](/payment-methods/amazon-pay) payment fails, the customer now gets redirected to the checkout page to choose another card.
* It is now possible to implement a [Magento headless integration](/plugins/adobe-commerce/adobe-commerce-headless-integration) with GraphQL.
* You can now add [additional data](https://docs.adyen.com/api-explorer/#/CheckoutService/latest/post/payments__reqParam_additionalData) to payment requests.
* You can now choose the option **maintain state** as a [status for confirmed payments](/plugins/adobe-commerce/set-up-the-plugin-in-adobe-commerce#step-4-optional-configure-advanced-settings) in the order management section of the Magento admin configuration panel.

### Fixed

* Customers now only get a confirmation mail of their order when the full payment amount has been authorized.
* If an order that is paid with a coupon is canceled due to a refused [3DS](/online-payments/3d-secure) flow, the coupon is no longer counted as used.
* We fixed an error where [Klarna](/payment-methods/klarna) would display the payment amount in a currency different from the base currency.
* The plugin now first checks if a payment method supports recurring payments before adding the recurring payment method information. Note that when upgrading, the [Store alternative payment methods](/plugins/adobe-commerce/set-up-the-payment-methods-in-adobe-commerce#alternative-payment-methods) field will be automatically set to **No**. This is done to ensure that once enabled, the admin will have to choose the type of token to be created.
* When receiving an [AUTHORISATION](/development-resources/webhooks/webhook-types#default-event-codes) notification and the amount is fully authorized, the amount is now updated in the Magento table `sales_order_payment`.
* The plugin now enforces the correct states when multiple states are assigned to a [status](https://docs.magento.com/user-guide/sales/order-status.html).

## 2022-02-17 — NetSuite Payments Bundle — Version 1.18.00

### Fixed

* We corrected the Recurring Processing Model issues preventing transaction overrides.
* We fixed bugs for the `ADYEN AUTHORIZATION AMOUNT OVERRIDE` transaction field that sometimes began to work intermittently.

### Improved

* Improved Pay by Link tokenization capabilities and masking method.
* We increased the maximum value for the Payment Processing Profile field `PAY BY LINK: TIMEOUT (HOURS)` from 720 hours to 1679 hours.

### New

* We added two new saved searches, `customsearch_shopper_ref` and `customsearch_es_plugin_execution_log`, to improve analytics.

## 2022-02-14 — Cegid Retail Y2 — Version 2.0.36

### New

* If you did not [configure referenced or unreferenced refunds](/plugins/cegid-retail-y2#refunds), the cashier will now be prompted to choose when both options are possible.
* For gift cards, you can now select an entry mode in a pop-up when checking the balance of a gift card. The options are **Swipe**, **Scan** and **MKE**.
* It is now possible to void gift card load operations.
* We added a setting to enable or disable support for void from CPOS.
* For gift cards scan entry mode, you can now shorten barcode length with a parameter.
* You can now configure different `AditionalOptions` and `TenderOptions` for payment and refund requests.

### Fixed

* For Global Blue transactions, cardholder name is now correctly recorded.
* We fixed the issue where the `captureDelayHours` additional data configuration was passed to the request with the wrong format.

### Improved

* We simplified the logs.
* We improved the referenced refund logic to support both cancellations and refunds.
* We improved the translations in the custom translations file.

### Known Issues

* This version requires you to [install Microsoft Visual C++](https://learn.microsoft.com/en-US/cpp/windows/latest-supported-vc-redist?view=msvc-170) which was previously included in the package by default manually.

## 2022-01-07 — Magento 2 — Version 8.1.0

### New

* We added details to billing information in customer view.

### Fixed

* Polish addresses with special characters are now parsed properly.
* We fixed an issue with case management when auto capture is enabled.
* Multishipping is now working properly for payment methods outside of the Adyen plugin.
* Partial captures are now handled correctly for both partial payments and regular payments.
* The stateData is now stored temporarily (per request) on the server side and in a browser session for multi page flows.

### Improved

* This version of the plugin uses [Web Components v5.2.0](https://docs.adyen.com/online-payments/release-notes#releaseNote=2021-11-01-web-componentsdrop-in-5.2.0).

## 2021-11-22 — Magento 2 — Version 8.0.0

### Breaking Changes

* This new major version includes breaking changes for merchant with headless integrations. If your integration is using endpoints from the webapi.xml file be aware that [some technical adjustments](https://github.com/Adyen/adyen-magento2/releases/tag/8.0.0) are needed in order to upgrade to 8.0.0.

### New

* It is now possible to add a custom return URL for redirect methods.
* We have added a new feature called Adyen Giving. Merchants can offer Adyen Giving in the success page for shoppers using supported payment methods.
* There is a new configuration layout. The grouping of configuration fields has been simplified and a new section **Configure payment methods** has been added to include all methods. The order status configuration fields have been moved to **Adyen payments** > **Advanced settings** > **Magento Order Processing**.
* We added the amount for number of installments to the checkout component in the Magento admin panel.
* We implemented the webhook module to receive notifications.

### Removed

* Pay by Mail has been removed as Pay by Link is now available.
* We removed Afterpay as an option for auto capture.

### Fixed

* The total amount in the installment's section is now shown correctly and includes taxes.
* After receiving an authorization webhook, a status is now given to an order indicating that it will undergo manual review.

### Changed

* Split Payments has been renamed as Partial Payments
* We moved the order status configuration fields from **Required Settings** to **Magento Order Processing**.

## 2021-10-14 — Magento 2 — Version 7.3.0

### New

* Pay By Link payment method was added for admin orders. If the link is not paid, the expired link scheduled task will close the order.
* We created a new cron functionality to clear the state data
* We added multi-shipping support for Local Payment Methods
* We restored originKey API endpoint and paymentStatus params and method

### Removed

* We removed the Pay By Mail configuration

### Improved

* We updated tool tips for new customer area UI

### Fixed

* Now the invoices are created as pending during async capture and change the state with the notification
* Fixed support of partial payments
* The new amount is now visible in wallet payment methods when a shopper applies or cancels a discount code
* Tokens are now saved when using 3DS1
* The URL for redirects is corrected for multiple store views

## 2021-10-07 — Salesforce Commerce Cloud - B2C Commerce — Version 21.2.0

### New

* We added supported payment methods: [Amazon Pay](/payment-methods/amazon-pay), [Pix](/payment-methods/pix).
* The cartridge now fully supports 3D Secure authentication on zero-auth transactions.

### Improved

* The cartridge now uses [Web Components v4.7.2](/online-payments/release-notes?integration_type=api\&version%5B0%5D=4.7.2#releaseNote=2022-04-21-ios-componentsdrop-in-4.7.2) and [Checkout API v67](/online-payments/release-notes?integration_type=api\&version%5B0%5D=67#releaseNote=2021-03-01-checkout-api-67).
* Address details are now prefilled for all payment methods.

### Breaking Changes

* You must now set up a [client key](/development-resources/client-side-authentication) when you configure the cartridge. The client key is used to show the input fields for card details. If you made customizations to the cartridge, you must check if this change is compatible with your custom code.
* When using SiteGenesis, you need to make changes to the Adyen-specific code that you added to the storefront core code. To see which code you need to add with version 21.2.0 or later, refer to [SiteGenesis code changes](/plugins/salesforce-commerce-cloud/sfra).
* For customized integrations, [Checkout API v67](/online-payments/release-notes?integration_type=api\&version%5B0%5D=67#releaseNote=2021-03-01-checkout-api-67) may introduce breaking changes. Check if your custom code is compatible with the changes introduced in this API version.

### Fixed

* Order details are now properly synced with the [Salesforce Order Management System](/plugins/salesforce-order-management-system) when the order is made with a stored card.

## 2021-10-04 — Shopware 6 — Version 3.2.0

### New

* New supported payment methods: Fashioncheque, DE Cadeaukaart, updated generic giftcard

### Fixed

* We added `snippet_name` for all cookies

## 2021-10-01 — NetSuite Payments Bundle — Version 1.17.01

### New

* We added tokenization capability to transactions using Pay by Link and Payment Instruments.
* It is now possible to save the token created by Pay by Link invoices as a default payment method.

### Changed

* We updated the UI to allow for triggering an authorization void from canceling or closing a Sales Order.
* We revised the hierarchy of the Suppress Billing Address function on the Payment Processing Profile and the transaction page. If the Suppress Billing Address feature is enabled, no billing address information shall be transmitted.

## 2021-09-01 — Shopware 6 — Version 3.1.0

### New

* We implemented gift cards as a standalone payment method
* We added refund processing to the order detail page
* The shopper details and addresses can now be prefilled
* We created a functionality to show/hide the **Save credit card** option in the checkout page, depending on whether the merchant has enabled the **Stored Payment Methods** on their storefront admin interface.
* We now show notifications on the order details page

### Changed

* We split the configuration panel into components

### Fixed

* The Paypal button now works in Firefox on IOS mobile

## 2021-08-24 — Magento 2 — Version 7.2.0

### New

* This release adds support for the Cards payment method in the multishipping checkout flow. Please be aware that this is only adding support for Card payments and not local payment methods yet.
* In response to increasing requests, the new release now supports [Amazon Pay](https://docs.adyen.com/payment-methods/amazon-pay#page-introduction). This payment method has been added at the end of the checkout along with the other payment methods.
* A new State Data webapi endpoint that receives a quote\_id and a state data JSON to be stored in a new BD entity. This could be used in custom checkout flows and multishipping.
* We brought back the pre-fill of the house number address field for Afterpay NL/BE.

### Fixed

* Removed `AddressAdapterInterface` type declaration that was not allowing the checkout to go through if the address did not match the requirements
* By using the current order status on `addStatusHistoryComment` now the order will not change the status when leaving an info-only history comment.
* The Capture builder now uses the subject amount instead of the order amount for the capture request. The subject amount could be the full order or a set of items.
* Fixed the error message on the Apple Pay payment method when the shopper selects a shipping method with the price higher than 0.
* For OFFER\_CLOSED notifications the order cancel was removed if the payment method is not a credit card to avoid the rejection of all the wallet payment methods.
* GiveX gift card integration was fixed.

### Changed

* We had introduced a toggle for 3DS2 which has now been deprecated. 3DS2 will be triggered via Native flow only.

### Improved

* We updated checkout component to 4.5.0. Please make sure you are also upgrading to the component version 4.5.0 in case you are managing your own frontend. Refer to [docs](/online-payments/components-web?tab=npm_recommended__1#page-introduction) for more information on web components integration.

## 2021-08-20 — NetSuite Payments Bundle — Version 1.17.00

### New

* We created a new custom function that replaces the `getValueOfField` function to obtain custom records.
* We have re-implemented both WeChat and AliPay as options within the [Payment Processing Profile](/plugins/netsuite/set-up-netsuite-customer-center#create-a-payment-processing-profile)

### Fixed

* We resolved an issue for Suppress Billing Address where the checkbox on the invoice would not behave as expected.

### Improved

* We updated the endpoint version for Adyen API calls within the bundle.

* The `validatePostBack` error code handling response is improved.

* We added masking of codes to (ZZ) to allow Adyen to recognize Ceuta and Melilla (EA), Canary Islands (IC), Kosovo (XK), Netherlands Antilles (Deprecated)(AN), and Serbia and Montenegro (Deprecated)(CS).

* Refined Payment Card Token mapping. We updated the mapping for tokenization to include additional data for:

  * Issuer identification number
  * Card brand
  * Card type
  * Cardholder name
  * Last four digits
  * Expiration date

### Changed

* We removed the use of Checkout API Key for most aspects of the bundle.

## 2021-08-10 — Salesforce Commerce Cloud - B2C Commerce — Version 21.1.0

### New

* New supported payment methods: ACH, Affirm, BCMC mobile, Clearpay, MB WAY, PayBright, RatePay, Swish, and WeChat Pay.
* We added a toggle that you can use to show or hide the credit card holder name. This toggle is configurable from the Business Manager.
* For PayPal, you can now choose to set captures to immediate or manual from the Business Manager.
* We added `shopperLocale` in `paymentMethods` call which enables translating the payment method names in the shopper's selected language.
* All SFRA cartridge features now have unit tests. You can run the unit tests from the command line.

### Improved

* We updated the cartridge to Checkout API version 65 and Adyen Web Components version 3.18.2.

### Fixed

* We fully refactored the code in the SFRA cartridge using ES6, to take advantage of modern JavaScript features. We use Babel to transpile the code to ES5 to make it compatible with Salesforce Commerce Cloud.
* We fixed an issue where the address was not saved for logged in users.
* Previously, when shoppers used Paypal and closed the pop up before it loaded, they were unable to continue the payment. Now the PayPal flow is canceled and shoppers are able to choose another payment method.
* For multiple partial payments, the notification handler now checks the total authorised amount to update the payment status in the order.
* We fixed the tax calculations for Klarna.
* Enabling multiple payment processors no longer causes collisions.
* We fixed an issue where undefined `lineItems` would cause errors for bundle products.

### Breaking Changes

* For customized integrations, the SFRA cartridge refactoring may introduce breaking changes. Check if your custom code is compatible and apply changes if needed.

## 2021-06-22 — Magento 2 — Version 7.1.0

### New

* We added a toggle to hide/show the credit card holder name field in the card component configuration.

### Fixed

* The bug-fix prevents an error with the Klarna payment method when the shopper makes a refund and sets the value to 0 items.
* The bug-fix prevents the ghost credit memos from being created when the refund is created.
* In the `configuration` object on your payment page, choosing the [locale](/online-payments/build-your-integration/sessions-flow/?platform=Web\&integration=Drop-in#optional-configuration) for China or Taiwan was fixed to match Adyen's codes.
* The 3DS2 challenge for OneClick payment method was being mounted behind the checkout loading screen. The bug-fix moved it to the modal window just like in credit card payments.
* We added \*.adyen.com to the allowlist, so that Magento Content Security Policy does not block Adyen resources.
* We fixed the calculations of discounts and shipping costs for open invoice payment methods.
* The adyenLogger dependency to ConnectedTerminals.php

### Changed

* Boleto payment method is now only available with the shopper being present.
* The merchant can now send the email after a purchase that contains a link to download a copy of the barcode generated in the flow for Boleto.
* After payments with non-3DS, 3DS1 and 3DS2 the payment details are now saved in the vault and the token can be used for payment.
* This release specified that we only support SEPA tokenization at the moment as an alternative payment method tokenization.

### Improved

* We updated the credit card payment form for admin orders to use the latest version of the web components library

## 2021-06-11 — Shopware 6 — Version 3.0.0

*\<p>This release supports Shopware v6.4.0.0 and later and is not backwards compatible with earlier versions.\</p>*

### New

* New supported payment methods: Afterpay (AU, NZ, US, CA), Alipay, BLIK, Clearpay, EPS, Oney, PaySafe Card, Ratepay, Swish, Trustly, and Twint.

### Fixed

* Fixed a problem where the line item description in open invoice payment methods was not set on inherited variant name which caused the payment request to fail.

## 2021-05-11 — Shopware 6 — Version 2.0.0

*\<p>This release does not support Shopware v6.4.0.0. Refer to \<a href="#plugin-version-3.0.0\&amp;releaseNote=2021-06-11-shopware-6-3.0.0">Adyen plugin version 3.0.0\</a> for Shopware v6.4.0.0 support.\</p>*

### Breaking Changes

* The origin key is no longer supported. If you haven't already, [generate a client key](/plugins/shopware-6#generate-a-client-key) for your integration.
* This plugin version uses [Checkout API v67](/online-payments/release-notes#releaseNote=2021-03-01-checkout-api-67) and [Web Components 4.2.1](/online-payments/release-notes#releaseNote=2021-04-01-web-componentsdrop-in-4.2.1).

### New

* The checkout now has the new PayPal button.
* You can no [do refunds from the Adyen Customer Area](/account/manage-payments#refund-a-payment).
* New payment methods: BLIK and Amazon Pay.
* Added additional data to the Store API so it would support Adyen payment methods for PWA merchants.

### Fixed

* Improved error messages for failed or canceled payments to give more feedback to the user.
* Fixed an issue with Buy Now Pay Later payment methods where applying multiple tax rates and then a discount led to an unsuccessful payment.
* Guest shoppers can now complete a previously failed payment.

## 2021-04-09 — Magento 2 — Version 7.0.0

*\<p>Refer to the \<a href="/plugins/magento-2/migrating-to-a-new-version">migration guide\</a> for more information on migrating to this major version.\</p>*

### Breaking Changes

* When configuring the plugin, you now need to set up a [client key](/plugins/magento-2/set-up-adyen-customer-area#generate-a-client-key). The plugin uses this to show the input fields for card details.
* Google Pay and Apple Pay have been removed as standalone payment methods and are now part of the [alternative payment methods](/plugins/magento-2/set-up-the-payment-methods-in-magento#alternative-payment-methods) group.
* The plugin now uses [Checkout API v67](/online-payments/release-notes#releaseNote=2021-03-01-checkout-api-67).

### Changed

* We changed the configuration for setting up [stored payment methods](/plugins/magento-2/set-up-tokenization).

### New

* You can now [change the currency](/plugins/magento-2/set-up-the-plugin-in-magento#selecting-charged-currency) used for Adyen payment processing.

* New supported payment method: Twint.

* Added Progressive Web Application (PWA) support for cards (including 3D Secure 1 and 3D Secure 2 authentication) and local payment methods. For more information, refer to our [Magento headless integration guide](/plugins/magento-2/magento-headless-integration).

### Improved

* The plugin now uses [Web Components v3.23.0](/online-payments/release-notes#web-components-3-23-0).

### Fixed

* We fixed the issue with the 3D Secure 1 flow for Magento and PWA.

## 2021-03-29 — Magento 2 — Version 6.7.0

### New

* New supported payment method: MB WAY.
* New 3D Secure 1 flow with `termUrl` and `redirectResult`. The new configuration field allows setting the 3D Secure 1 flow to Manual (default) or Auto for POST and GET redirect back from the issuer page respectively. This setting can only be changed via Adyen Support. For more information, refer to [Set up the plugin in Magento](/plugins/magento-2/set-up-the-plugin-in-magento#3ds1-behavior).
* Added a new configuration field **Clone quote on failed payment** that enables cloning the quote so that the following order has a different quote ID.
* Added a new configuration field **Address street line used for the house number input** allows choosing between Street line 1 to 4 to use as a dedicated house number field.

### Fixed

* Fixed a bug with tokenization when it would store credit card details even when the shopper didn't select it.
* Fixed an issue with `shopperReference` being too short for Checkout API v66.
* Fixed an issue with the Terms and Conditions checkbox not working for redirect local payment methods.

## 2021-03-16 — Shopware 6 — Version 1.6.0

### New

* New supported payment methods

  * Apple Pay and Google Pay. The payment methods are presented only at checkout, and are not shown as express checkout buttons in the product page. To enable, contact our [Support Team](https://ca-test.adyen.com/ca/ca/contactUs/support.shtml?form=other) and provide the domain names and shop name that you want to use.
  * Local payment methods: [Bancontact](/payment-methods/bancontact/bancontact-card) and [Dotpay](/payment-methods/dotpay).

### Improved

* Added support for sending payment method and payment details separately for headless implementations with a non-standard payment flow. For example, in a multi-step form, the `SalesChannelContextSwitchEvent` may be dispatched multiple times. This caused the plugin to remove the payment details. Now the plugin will save or clear the payment data only when the payment method is updated.

### Fixed

* Fixed a bug in the payment methods filter for the checkout page. Previously, payment methods that were not returned in the `/paymentMethods` response from Adyen were still shown in the checkout page.
* The **Test Configuration** button is now working when using Shopware v6.3.4.1 and later.
* Fixed an issue where the plugin was missing domain information that caused the redirect URL to be generated incorrectly.

## 2021-02-05 — Shopware 6 — Version 1.5.0

### New

* The plugin can now process notifications, so the [payment statuses](/plugins/shopware-6/manage-orders-in-shopware#payment-status) are now updated based on the notification events.

### Improved

* Replaced all usages of Shopware's deprecated Sales Channel API with Store API.

### Fixed

* Fixed an issue where when a credit card payment fails and the shopper tries to pay again with PayPal or Klarna, they would get an error stating **This XML file does not appear to have any style information associated with it**.
* If you have different sales channels and you are testing the API configuration, the configuration would fall back to the default store configuration. We've fixed this so now you can test API configurations specific for a sales channel.

## 2021-01-04 — Shopware 6 — Version 1.4.0

### Changed

* Set up a [client key](/plugins/shopware-6#generate-a-client-key) for improved card brand recognition.
* This version uses [Checkout API v64](/online-payments/release-notes#releaseNote=2020-08-09-checkout-api-64) and [Web Components 3.18.2](/online-payments/release-notes#releaseNote=2020-11-18-web-componentsdrop-in-3.18.2).

### New

* New supported payment method: [giropay](/payment-methods/giropay).
* Payment method logos have been added to the plugin.

### Fixed

* Fixed an issue where in some cases Klarna payments were not submitted correctly and the shopper could not pay.

## 2020-12-04 — Salesforce Commerce Cloud - B2C Commerce — Version 20.1.3

*\<p>This version is no longer supported. We recommend that you upgrade to a maintained version of the plugin according to our \<a href="https\://docs.adyen.com/plugins/salesforce-commerce-cloud/#support-levels">support schedule\</a>.\</p>*

### Breaking Changes

* Payment information is now passed using query strings instead of the session class. This may introduce breaking changes for customized integrations.

## 2020-12-02 — Shopware 6 — Version 1.2.0

### New

* Shoppers can now save their card details for one-click payments.
* Added German translations to the cookie snippets.

### Fixed

* When cards were selected as the default payment method, shoppers could proceed from their cart to the order summary page even if they do not type in their card details. This is now fixed; shoppers need to enter their details before they can see the order summary page.
* Fixed an issue where the Google Chrome SameSite cookie policy was causing problems with 3D Secure 1 payments and shoppers would be redirected to an empty cart.

## 2020-10-23 — Shopware 6 — Version 1.0.0

### New

* The plugin now supports the following payment methods: debit and credit cards, PayPal, iDEAL, Klarna Pay Later, Klarna Pay Now, Klarna Pay over time, SEPA Direct Debit, and Sofort.

If you need any additional payment methods, open a [Github feature request](https://github.com/Adyen/adyen-shopware6/issues/new?assignees=\&labels=enhancement\&template=feature_request.md\&title=).

### Improved

* The plugin now supports multiple sales channels configurations.
* Added descriptions under the payment methods in the plugin.

### Fixed

* We fixed an issue with the order transition state.
* We improved the error messages in the plugin configuration test.
* Messages in the NotificationReceiverService are no longer incorrectly logged as critical.
* First name is no longer sent instead of the last name in payment calls.
* The plugin is now compatible with payment methods external to Adyen.
* The plugin is now compatible with Shopware version 6.3.

### Known Issues

* The Google Chrome SameSite cookie policy is causing 3DS1 payments to run into some issues. This is currently being worked on and will be fixed in the next release.

## 2020-09-24 — Magento 2 — Version 6.6.0

### New

* The plugin now supports SEPA Direct Debit tokenization.
* If 3D Secure 2 is not supported, the plugin now falls back to the 3D Secure 1 flow.

### Improved

* The IP and HMAC checks for notifications are now completely independent. When we introduced the change in version [6.5.0](#magento-2-payments-plugin-6-5-0-sept-1st-2020), the checks in the code were still dependent on each other even after separating the settings.
* We have excluded adyen.js and adyen.css files from being minified in the configuration.

### Fixed

* Fixed an issue where the Google Pay button was shown regardless of validation results. We validate if the shopper has agreed to the terms and conditions and if Google Pay is available for them. The checkout page now only shows the Google Pay button when the validation is successful.
* Fixed an issue where Vault tokens were not saved for 3D Secure 2 credit cards.
* Fixed an issue where the shopper is redirected to the wrong storefront after 3D Secure authentication.

### Known Issues

*

## 2020-09-01 — Magento 2 — Version 6.5.0

### New

* New supported payment method: Swish.

* Guest shopper card data is now tokenised as well, if you enabled guest tokenisation in your Magento environment.

* There is now a **Payment Origin URL** field for PWA storefront integrations. Add your frontend URL to this field to connect your Adyen Web Components to your frontend server.

* Origin keys now persist in your local storage when you clear the cache to make a configuration change.

* For notifications you receive, you can now separately enable:

  * HMAC key validation.
  * IP address validation for the notification sender.

### Fixed

* Pay by mail now fetches the country code correctly.
* The Chrome SameSite cookie security settings no longer affect users redirected after 3DS1 authentication.

### Known Issues

*

## 2020-07-31 — Magento 2 — Version 6.4.0

### New

* The plugin now supports voucher and QR code payment methods such as [Multibanco](/payment-methods/multibanco) and [WeChatPay Desktop QR](/payment-methods/wechat-pay/wechat-pay-desktop-qr-payments).

### Known Issues

*

## 2020-07-23 — Magento 2 — Version 6.3.0

### New

* The plugin now supports [Swish](/payment-methods/swish).

### Fixed

* We fixed an issue with loading the POS Payment method; this was a bug introduced in release 6.1.0.

## 2020-07-16 — Salesforce Commerce Cloud - B2C Commerce — Version 20.1.0

*\<p>This version is no longer supported. We recommend that you upgrade to a maintained version of the plugin according to our \<a href="https\://docs.adyen.com/plugins/salesforce-commerce-cloud/#support-levels">support schedule\</a>.\</p>*

### New

* We added the Adyen Component payment processor, which will render Adyen Web Components dynamically. This includes the following from our [overview of payment methods](/payment-methods):

  * All credit cards
  * All cash and ATM payment methods
  * All direct debit payment methods
  * All other payment methods with a **redirect** payment flow. This refers to online banking and *buy now, pay later* payment methods, prepaid cards and gift cards, and wallets. The overview of payment methods indicates whether such a payment method has a redirect payment flow, or a different flow.

* We updated the PayPal integration. With this, you can present PayPal's Smart Payment Buttons to shoppers in your payment form. In [all supported countries/regions](https://www.paypal.com/en/webapps/mpp/country-worldwide) you can present a PayPal button, and in the US and the United Kingdom you can also present PayPal Credit.

* You can use [Adyen Giving](/online-payments/donations/web-component) to let your shoppers donate to a charity of your choice after they complete the checkout. To find out more, go to [adyen.com](https://www.adyen.com/giving).

* You can enable in-store point-of-sale payments through your Salesforce Commerce Cloud storefront, using our built-in cloud [Terminal API](/point-of-sale/design-your-integration/terminal-api).

* The cartridge now supports [Credit Card Installments](/payment-methods/cards/credit-card-installments). With this and the support for [Boleto](/payment-methods/boleto-bancario/web-component#page-introduction), the cartridge is also fully ready for the Brazilian market.

### Improved

* We updated all existing Adyen Web Components to version v3.9.4.

### Fixed

* The shopper can now choose to save their payment details for later purchases, and can validate the payment fields during the checkout.
* Payments with a redirect flow are now correctly saved as a new order in the Business Manager.
* The order statuses will be updated if Adyen successfully retries a failed capture.
* The payment details from Multibanco are now included in the confirmation email.
* We fixed an issue with showing labels in drop-down lists in Firefox.
* We removed the max-length requirement for the card owner field.

### Breaking Changes

* For customized integrations, the use of **Adyen\_Component** as the payment processor for all payment methods, instead of **Credit\_Card** for card payments and **Adyen** for all other payment methods, may introduce breaking changes.

## 2020-06-26 — Magento 2 — Version 6.2.0

### Improved

* We improved the security of notification webhooks by adding HMAC signature validation. To protect your server from unauthorised notifications, we strongly recommend that you [set up an HMAC key](/plugins/magento-2/set-up-the-plugin-in-magento#security).

### Fixed

* Fixed an issue where an unauthenticated user could cancel an ongoing point-of-sale transaction.
* Fixed an issue where an unauthenticated user could perform side-channel attacks to obtain notification credentials and affect the transaction notification flow.
* Fixed an issue where an unauthenticated user could perform a brute forcing attack to obtain notification credentials and affect the transaction notification flow.

### Known Issues

*

## 2020-05-15 — Magento 2 — Version 6.1.0

*\<p>Refer to our technical release notes on \<a href="https\://github.com/Adyen/adyen-magento2/releases/tag/6.1.0">GitHub\</a> for more information on the 3D Secure 2 setup for PWA integrations.\</p>*

### New

* We have introduced a new feature that you can use to sync the configuration between environments. For example, you can use this to sync the configuration between a developer's local instance and a testers test environment before you go live.
* You can now manually adjust the cancellation of orders based on notifications. As this is not a very common scenario, you can only make manual adjustments using the database.

### Improved

* Added the Visa/Dankort logo.

### Fixed

* When we do not receive a return URL in the 3D Secure 1 response, we no longer cancel the order. Instead, we look at the notifications to see what should happen with the payment, as these are more reliable.
* Your shoppers can now click the **Pay** button and complete a checkout without providing a billing address.
* Fixed a Google Pay bug and several other bugs.

### Known Issues

*

## 2020-03-31 — Magento 2 — Version 6.0.0

*\<p>Refer to our technical release notes on \<a href="https\://github.com/Adyen/adyen-magento2/releases/tag/6.0.0">GitHub\</a> for information on backwards compatibility changes.\</p>*

### Changed

* The Adyen API Library for PHP is updated from version 5 to 6.
* For PWA storefront integrations, we introduced a new API endpoint to retrieve the current payment status of an order. The documentation will be updated soon.
* The Checkout Component is updated from version 3.0.0 to 3.4.0.

### New

* Support for dual-branded Mexican cards and payments in Mexican peso (MXN).

### Improved

* In modification requests, we now pass the store ID from the order. Previously we passed the default store ID. For merchants with multiple stores this wasn't always what they expected.

### Fixed

* We didn't directly provide the order ID in the Magento `payment-information` API response. This caused other Magento plugins to not always work.
* Recurring payments with Apple Pay didn't work.
* Apple Pay was shown as available payment method on browsers that do not support it.
* The local language that was set in the Configuration panel didn't always match the language of the webshops.
* Merchants on Magento version 2.2.7 weren't able to download and configure the Adyen Magento plugin.
* Klarna discount lines had positive amounts instead of negative amounts.
* In a PWA storefront integration, the session wasn't always available when retrieving the payment methods.

### Known Issues

*

## 2020-02-18 — Magento 2 — Version 5.4.0

### New

* You can now see an overview of all Adyen notifications on the Magento admin page.

### Fixed

* The fashioncheque gift card logo has been added.
* Google Pay is working on the production environment again.

### Known Issues

*

## 2020-01-28 — Magento 2 — Version 5.3.0

### New

* If a refund fails, a notification will be shown on the admin panel.

### Known Issues

*

## 2020-01-21 — Magento 2 — Version 5.2.0

### Fixed

* In some scenarios, an order was not being created after a payment request was processed using guest checkout.
* Google Pay button didn't appear as a payment method at checkout.

### Known Issues

*

## 2019-12-16 — Magento 2 — Version 5.1.0

### New

* Added support for Combo Cards in Brazil. A shopper can choose whether they want to pay with debit or credit by using a drop-down menu.

### Fixed

* Credit cards were not appearing in the list of available payment methods in the Magento PWA Storefront.
* In some scenarios, stock levels were incorrect after an order was canceled.
* In some scenarios, shoppers weren't able to pay using Afterpay Touch.

### Known Issues

*

## 2019-11-01 — Magento 2 — Version 5.0.0

### New

* You now have the option to store the shopper's payment details for [recurring payments](/get-started-with-adyen/adyen-glossary/#recurring-payments-definition) when initiating backend orders ([MOTO](/get-started-with-adyen/adyen-glossary/#/mail-ordertelephone-order-moto)).

* The checkout form additionally supports logos for the following payment methods:

  * Klarna Pay Now
  * Direct Debit (Great Britain)
  * Boekenbon Gift Cards
  * VVV Cadeaubon Gift Cards

### Improved

* Web Drop-in and Components updated to version 3.2.0. Refer to the [Web Drop-In and Components release notes](/online-payments/components-drop-in-release-notes#web-drop-in-and-components-3-2-0-september-16-2019) to learn more about the changes.
* We now record individual steps of the payment request process in the log files.
* The option of initiating backend orders (MOTO) is now permanently enabled.

### Fixed

* In some scenarios the order was not being created after the payment request was processed.
* In some scenarios, 3D Secure payments were not working.
* When shoppers updated their billing address at checkout, the old address was being sent with the payment request.
* Returning shoppers using previously [stored card details](/get-started-with-adyen/adyen-glossary/#one-click-payments-definition) were unable to complete the purchase after a failed 3D Secure 2 challenge.
* We now send the `shopperInteraction` field in recurring payment requests using billing agreements.
* We now include the `shopperIP` in payment requests.

### Known Issues

* The 3D Secure 2 popup wasn't initiated for guest checkout.

  A fix for this issue is available in version 5.0.2.

*

## 2019-09-27 — Salesforce Commerce Cloud - B2C Commerce — Version 19.2.0

### New

* Shoppers paying with Konbini or Dragonpay can now complete the whole payment flow without being externally redirected.
* We added a security check to prevent website spoofing and session hijacking.
* You can now access a masked version of shoppers' credit card details from the [order payment instrument](https://documentation.b2c.commercecloud.salesforce.com/DOC2/index.jsp?topic=%2Fcom.demandware.dochelp%2FCustomerServiceCenter%2FOrderPaymentInstrument.html).

### Improved

* To maintain the quality and reliability of the cartridge we have:

  * Implemented automatic end-to-end testing.
  * Refactored some of our integration.

* We have updated our integration for stored cards. As a result, you need to update your [store shopper details](/plugins/salesforce-commerce-cloud/set-up-the-cartridge#step-5-store-shopper-details) preferences.

### Fixed

* We now send the correct device fingerprint for RatePAY payments.
* We fixed an issue where shoppers' stored card details were sometimes not shown on the payment form.

## 2019-09-05 — Magento 2 — Version 4.5.0

### New

* Apple Pay additionally supports the following card brands:

  * Maestro
  * vPay
  * JCB
  * Elo

* You can now build a Progressive Web App shop. For more information, see [Magento headless integration](/plugins/magento-2/magento-headless-integration).

* You can now see which Adyen API key you are using for live and test payments. To view these in your Magento admin panel, go to:

  * **Stores** > **Configuration**.
  * In the menu, go to **Sales** > **Payment Methods** > **Adyen All-In-One Payment Solutions** > **CreditCard API integration**.\
    The last four digits of your stored **API key for Test** and **API key for Live** are visible.

* The email address of a guest shopper will now appear in your **Customer Area** > **Transactions** > **Payments**.

### Fixed

In this release we fixed the following issues:

* In some scenarios, billing agreements were not being stored.
* The [Shopper IP usage frequency](/risk-management/configure-standard-risk-rules/velocity-rules#shopper-ip-used-more-than-x-times-within-a-time-period) risk check would be triggered incorrectly.

## 2019-08-14 — Magento 2 — Version 4.4.0

### New

* Added support for Google Pay.
* Added support for point-of-sale installments.

### Fixed

* Improved plugin support for Magento 2.3.2.

## 2019-05-29 — Magento 2 — Version 4.2.0

### New

In [version 4.2.0](https://github.com/Adyen/adyen-magento2/releases/tag/4.2.0) we added native [3D Secure 2](/online-payments/3d-secure-for-regulation-compliance/#3d-secure-2-implementation-options), the latest authentication technology.

## 2019-05-10 — Magento 2 — Version 4.1.0

*\<p>Adyen can only offer support for the Magento 2 Adyen plugin version 4.1.0 or later.\</p>*

### Changed

In version 4.1.0, we replaced Adyen Hosted Payment Page (HPP) integration with Alternative payment methods. The styling for alternative payment methods changed from skins to CSS.\
This means that alternative payment methods such as iDEAL, Boleto, or Klarna, are now processed with our newest APIs, improving the shopper's experience by limiting the number of redirects.
