> For the complete documentation index, see [llms.txt](https://developer.esw.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.esw.com/adobe-commerce-magento/release-notes.md).

# Release Notes

{% updates format="full" %}
{% update date="2026-03-02" %}

## v7.2.4

#### Fixes & Improvements

* Enhanced the shopper registration block on the order confirmation page to display only for guest shoppers when post-checkout registration is enabled.

***

{% endupdate %}

{% update date="2026-02-12" %}

## v7.2.3

#### Fixes & Improvements

* Added a configuration option to redirect to the homepage when switching between localized store views via the country selector.

***

{% endupdate %}

{% update date="2025-12-30" %}

## v7.2.2

#### Fixes & Improvements

* Added multi-source inventory support to package imports, resolving missing shipment updates in Magento for ESW Package API orders.

***

{% endupdate %}

{% update date="2025-12-15" %}

## v7.2.1

#### Fixes & Improvements

* Fixed an issue where tax-inclusive prices for the fixed pricing model were recalculated incorrectly during checkout.
* Fixed an issue where zero-value orders failed to redirect to checkout or applied incorrect shipping rates when native Magento taxation was enabled.

***

{% endupdate %}

{% update date="2025-11-14" %}

## v7.2.0

#### Added

* Shoppers can now complete zero-value orders through ESW checkout when 100% discounts are applied.

#### Fixes & Improvements

* The ESW Magento module now supports database table prefixes.
* Fixed an issue where the incorrect state was saved in billing addresses.
* Resolved a discrepancy in order totals between the preorder and order confirmation caused by import fee calculations.
* Fixed an issue where the shipping cost appeared as `0` on the cart page instead of the correct ESW shipping value.
* Resolved an issue where the selected shipping method on the cart page was not retained on the ESW checkout page.

***

{% endupdate %}

{% update date="2025-10-10" %}

## v7.1.0

#### Added

* Enabled mixed cart checkout for digital and physical products.
* Added support for a self-hosted checkout success page in Magento.
* Added support for Magento Admin session timeout sync between Magento and ESW checkout.

#### Fixes & Improvements

* Fixed order creation in the admin panel with free shipping.
* Fixed incorrect billing address saving by respecting the selected checkout address.
* Fixed inconsistent state code and name handling during edit, order confirmation, and preorder flows.
* Fixed addresses being saved to Magento even when **save to profile** was unticked during checkout.
* Fixed non-default addresses being overwritten during order placement in Adobe Commerce.
* Fixed incorrect billing and duplicate address saving by ensuring only the selected address is saved and set as default.
* Fixed preorder to populate the confirmation URL for the self-hosted success page.
* Allowed the shopper access token cookie to be set on a shared apex domain for cross-subdomain checkout authentication.
* Suppressed PHPMD warnings and improved code style, lint, and static analysis.
* Added **Return Prohibited** message display on the cart page.
* Fixed an issue where store pricing incorrectly used Pricing Advisor data even when the feature was disabled.

***

{% endupdate %}

{% update date="2025-08-06" %}

## v7.0.0

#### Fixes & Improvements

* The ESW Magento extension is now fully compatible with Magento `2.4.8` and PHP `8.4`, while continuing to support Magento versions up to `2.4.6` and PHP `8.2`.

***

{% endupdate %}

{% update date="2025-05-25" %}

## v6.0.0

#### Added

* Added embedded checkout support in the retailer storefront.
* Added JWT webhook authentication through JWKS.
* Added support for custom pricing category rules in Pricing Advisor V4.
* Added AB Tasty integration support.
* Added support for Magento promotional discounts on ESW shipping rates.

#### Fixes & Improvements

* Improved configuration flow by hiding the language selector in storefront and admin when only one language is available in Magento.

***

{% endupdate %}
{% endupdates %}

### Legacy releases

#### v5.2.1

**Fixes & Improvements**

* Fixed an issue with PAV4 cache during Xtento Product Feed Export.
* Resolved a precision issue in Xtento Product Feed Export to ensure price accuracy across supported ESW countries.
* Fixed an issue where an incorrect success message was shown when applying an already used promo code with limited usage.
* Fixed an issue in Catalog Export where `validation_errors` were not reset for successfully synchronized products.
* Improved post-purchase event handling by introducing the `eshopworld_checkout_order_confirm_success_action` event after successful order creation.

#### v5.2.0

**Added**

* Added country-specific product feeds for marketing use with the calculated pricing model.
* Added Magento address book support in ESW checkout.
* Added support for offline payment methods such as Cash on Delivery and Konbini.
* Added optional inventory checks before payment authorization during ESW checkout.

**Fixes & Improvements**

* Fixed an issue where incorrect order totals were saved when **Override Order Values** was enabled and multiple quantities of the same SKU with a discount were applied.

#### v5.1.2

**Fixes & Improvements**

* Added an option to override Magento order and item totals with ESW order confirmation values.
* Defaulted preorder and order confirmation schema configuration to `v3` for new installations without existing ESW records.
* Moved the shipping database schema declaration from the main checkout module to its own submodule.
* Removed the dependency on the `Json` class from the `Test/Integration` namespace in console command classes.
* Added a hidden variable to enable native Magento order email sending on order creation.
* Improved `reservedOrderId` regeneration on internal quote-to-order conversion errors.
* Added trimming for the title field during preorder build.
* Fixed an issue where the region in a domestic checkout address was not cleared during ESW quote-to-order conversion.

#### v5.1.1

**Added**

* Added native welcome mat and country-currency selector support for the Hyvä theme.
* Added import and export support for ESW module configuration data in CSV format.

**Fixes & Improvements**

* Fixed an issue where the tracking URL for packages synced from Magento to ESW was created incorrectly with Package API `v4.0`.
* Removed the **Checkout Side Only Countries** setting because it is no longer needed with Pricing Advisor `v4.0`.
* Added support for order creation aligned with ESW data for the All-Exclusive country model.

#### v5.0.1

**Fixes & Improvements**

* Fixed an issue in the Order API where ESW data was returned in an incorrectly formatted JSON payload when an order was placed using order confirmation `v3`.

#### v5.0.0

**Added**

* Added catalog synchronization support for all SKU variations generated through fixed-SKU customizable options for simple and configurable products.
* Added full compatibility with ESW Package/ASN API `v4.0`.
* Added full compatibility with Returns `v3.0` through webhook.

**Fixes & Improvements**

* Added failure details to the products grid row when catalog synchronization is unsuccessful.
* Removed full cancellation triggering from Magento to align with the ESW Customer Service Portal.
* Added support for the new line-item appeasement event.
* Fixed delayed logistics flows caused by non-English product title sync during preorder.
* Prevented checkout when the exchange rate is absent in Pricing Advisor Service `v4` for calculated pricing countries.
* Dropped support for Magento versions up to `2.4.3` and PHP `7.4`.
* Added status history comments when Shipment, Credit Memo, or Invoice entities are created.
* Allowed Package, Catalog, and Returns submodules to be disabled individually.
* Added native tax setup and module list details to integration log exports.

#### v4.4.1

**Fixes & Improvements**

* Fixed the issue with loading country-specific prices through the URL `location` parameter when `geoip` config is enabled.

#### v4.4.0

**Added**

* Shoppers now receive an error notification and are blocked from continuing if they try to use an ESW country in native Magento checkout.

**Fixes & Improvements**

* Added PHP `8.3` support.

#### v4.3.0

**Added**

* Added support for bundling products with dynamic and fixed price types when using the calculated pricing model.

**Fixes & Improvements**

* Fixed inaccurate log entries for order discrepancies in the fixed pricing model when settlement or retailer currency differed from the website base currency.

#### v4.2.0

**Added**

* Added country-specific localized content support, such as free delivery threshold banners, for single website and store view setups.
* Added support for the default ESW disclaimer message on the cart page.

#### v4.1.1

**Fixes & Improvements**

* Fixed the frontend country-currency switcher widget issue where the selected country was set incorrectly.

#### v4.1.0

**Added**

* Added email marketing opt-in capture for newsletters through native Magento newsletter subscription integration.

**Fixes & Improvements**

* Fixed an issue where test credentials failed when switching from sandbox to production.

#### v4.0.1

**Fixes & Improvements**

* Added catalog synchronization support for custom product types and ESW product attribute assignment by product type from the admin panel.
* Updated the country code option list for the `hsCodeRegion` product field.
* Fixed an issue where delivery duty was not included in Magento order details for **Tax on Checkout Side Only Countries**.
* Fixed an issue where localized fields exported with the wrong store scope used the default store instead of the configured ESW store.

#### v4.0.0

**Added**

* Added full compatibility with ESW Pricing Advisor API `v4.0`.
* Added integration monitoring support for sending diagnostic configuration data to ESW.
* Added ESW Returns API `2.1` support with accurate shipping and item tax storage in credit memos.

**Fixes & Improvements**

* Moved logs and monitoring code into standalone modules in `src`.
* Improved cart item price calculation support when catalog prices include native tax.
* Fixed a JavaScript exception that blocked shipping rate loading when the module was disabled.

#### v3.0.3

**Fixes & Improvements**

* Fixed an exception caused when a third-party module added free products by intercepting promotion rules.
* Fixed a discrepancy in `Grand Total` when the forced calculated pricing model was used and ESW retailer currency matched the Magento base currency.

#### v3.0.2

**Fixes & Improvements**

* Fixed incorrect prices when switching stores directly with the URL country parameter for the calculated pricing model.
* Fixed small cents-level differences in mini-cart item prices when using calculated pricing with fixed rounding rules.
* Fixed an issue where a promotion label was sent to ESW checkout even if the promotion was disabled or expired.
* Fixed discounted item-level values shown incorrectly on ESW checkout for calculated pricing with multiplier and fixed rounding rules.
* Fixed a shipment creation error by allowing `null` values for `carrierReference`.
* Fixed an issue where there was no redirect to ESW checkout when two percentage discounts were used in the cart.
* Updated the ESW shipment details block to show only one record, with `carrierReference` taking priority over the ESW package reference.
* Added full currency list visibility in the **Currency** dropdown on the ESW shipping rates page.
* Fixed the discrepancy between `Grand Total` and `Total Paid` when shipping duty tax is applied.

#### v3.0.1

**Added**

* Added shopper registration after checkout with automatic order linking.
* Added order appeasement support through ESW webhook.
* Added full compatibility with ESW Checkout API and Order Confirmation Webhook `v3.0`.

**Fixes & Improvements**

* Fixed date filtering in extension logs.
* Removed native region, state, and postcode validation during ESW order creation in Adobe Commerce.
* Optimized the JavaScript country list variable for faster storefront loading.
* Added filters to the shipping rates page.
* Prevented country and currency cookies from being created when frontend elements are disabled.
* Enabled catalog multi-tenant configuration by default.
* Added a new feature flags section.
* Added PHP `8.2` support.
* Deprecated ESW Checkout API and Order Confirmation `v1.0`.

#### v2.8.4

**Fixes & Improvements**

* Added extension log details when order confirmation data save to the custom module table fails.
* Fixed an issue where a second attempt to save order confirmation data failed after Adobe Commerce state address validation was disabled.

#### v2.8.3

**Fixes & Improvements**

* Fixed price discrepancies between Adobe Commerce order data and ESW order confirmation data in multi-country fixed pricing website setups.
* Fixed STS credential validation failing at website level when credentials were already saved at default level.
* Fixed shipping rate display issues in the cart estimation block when subtotal-based custom conditions were used.
* Prevented Adobe Commerce order creation if ESW order data fails to save first.
* Added warnings to extension logs when order confirmation takes more than 30 seconds and a second confirmation request is received.
* Prevented ESW shipping method from being added to cart subtotal by default in Adobe Commerce PWA Studio.

#### v2.8.2

**Added**

* Added new extension release notifications in Adobe Commerce Admin.

**Fixes & Improvements**

* Fixed an order confirmation error when a coupon code was used and no shipping method was selected before redirecting to ESW checkout.
* Fixed aged FX rates in Adobe Commerce global rate updates for multi-tenant retailers.
* Fixed a JavaScript error triggered when adding a product to cart and switching country.
* Improved order confirmation processing performance.

#### v2.8.1

**Added**

* Added ESW order confirmation data to Magento native Order REST API for third-party synchronization.

**Fixes & Improvements**

* Added yes and no product attributes to the product metadata items dropdown configuration.
* Fixed the issue where the shipping address was empty in the GraphQL response.

#### v2.8.0

**Added**

* Added product restriction support by country and storefront.

#### v2.7.1

**Fixes & Improvements**

* Fixed a hubless package model issue where order items were marked as `Shipped` but the shipment entity was not created.

#### v2.7.0

**Added**

* Added automated catalog synchronization with cron-based export.
* Improved catalog multi-tenant support.
* Added stored card support in ESW checkout.
* Added native promotion engine support for ESW shipping methods in free shipping rules.

**Fixes & Improvements**

* Fixed the log time date filter in extension logs.
* Fixed an `Undefined Index` exception when catalog was enabled.
* Improved Adobe Sensei recommendation extension support.
* Fixed incorrect order confirmation data saving when the order contained an out-of-stock product in the custom table.
* Resolved inconsistencies between GraphQL and storefront catalog discount prices.

#### v2.6.1

**Added**

* Improved price rounding support through ESW Pricing Advisor **Pretty Pricing**.
* Added order cancellation support through ESW webhook.

**Fixes & Improvements**

* Fixed Adobe Commerce Community Edition compatibility when `module-inventory` is absent or disabled.
* Fixed an issue where Adobe Commerce shipment creation from ESW failed with an inventory quantity error.
* Improved support for Amasty Special Promotions.
* Improved integration test coverage.

#### v2.5.5

**Fixes & Improvements**

* Fixed validation when color and size attributes are empty.

#### v2.5.4

**Fixes & Improvements**

* Fixed an issue where updated product dropdown attribute values were not reflected in the exported product catalog.

#### v2.5.3

**Added**

* Added support for configuring prohibited return values through product attributes.
* Added support for overriding existing checkout product attribute values.
* Added support for non-Latin discount labels up to 50 characters.

**Fixes & Improvements**

* Set negative values to zero where shipping tax is applied at checkout.
* Fixed cron service errors when the website has no default store assigned.

#### v2.5.2

**Fixes & Improvements**

* Fixed backend price render formatting.

#### v2.5.1

**Fixes & Improvements**

* Updated catalog export to use the value code for the **Country of Manufacture** attribute.

#### v2.5.0

**Added**

* Added support for Adobe Commerce `v2.4`.
* Added customer ID in `registeredProfileId` during preorder for logged-in shoppers.

**Fixes & Improvements**

* Fixed an issue where empty color or size parameters were sent as `false` in preorder.
* Fixed an issue where an empty cart was sent in preorder.
* Fixed an issue where the catalog sent an attribute option ID instead of the value.

#### v2.4.3

**Fixes & Improvements**

* Updated the domain registered for the MaxMind GeoIP2 JavaScript Client API to match new MaxMind requirements.

#### v2.4.2

**Added**

* Added native Credit Memo API support for full ESW order cancellations.
* Added pricing model selection by `location` parameter in the product URL.

**Fixes & Improvements**

* Limited automatic invoice creation to ESW orders only.
* Applied rounding rules to countries in **Force calculated pricing model countries** when shopper currency matches base currency.
* Fixed shipping cost saving in order history when the currency exponent is `0`.

#### v2.4.1

**Added**

* Added GraphQL support for ESW checkout URL API calls alongside REST.
* Added the **Product Metadata Items** section in Checkout settings for additional product attributes and custom option mappings.

#### v2.4.0

**Added**

* Added **Export to ESW Catalog** to export multiple products from the catalog grid.
* Added support for full order and partial line-item cancellation through credit memo.
* Added frontend widget switcher support for multi-language store views across different websites.

#### v2.3.5

**Added**

* Rebuilt the Package and ASN configuration section under Order Fulfillment.
* Added new API endpoints for logged-in and guest ESW checkout users.
* Added support for setting ESW shipping country through the request header.
* Added support for enabling or disabling the Pricing Advisor feed per website.
* Optimized the Pricing Advisor feed database to store data at website level instead of store-view level.
* Added ESW Returns API `2.0` support for the hub shipping model.
* Added conditional rules for cart subtotal in shipping method currency for shipping rates.
* Added support for multiple frontend widget scenarios across websites and tabs.
* Added website-level multi-tenant support for Checkout, Package, and Pricing Advisor Feed service.
* Added Ship from Store support.

**Removed**

* Removed the dependency between Pricing Feed Enabled and calculated price conversion on the frontend.

#### v2.1.1

**Added**

* Added ESW Checkout 2 support for the calculated pricing model.
* Added Pricing Advisor `2.0` support.
* Prevented the quote collect total observer from triggering for shipping estimation, login, and create account actions.
* Added Package and ASN integration for the hub shipping model.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://developer.esw.com/adobe-commerce-magento/release-notes.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
