README

EU withdrawal button for Magento 2 — the consumer right-of-withdrawal flow required by 19 June 2026 under Article 11a of the Consumer Rights Directive (2011/83/EU) as amended by Directive (EU) 2023/2673.

The Magento 2 withdrawal button your EU storefront needs before the 19 June 2026 deadline — a storefront-ready, guided flow (find order → select items → review & confirm) with durable-medium receipt emails and Annex I content in 22 EU locales, on Luma, Hyvä, and Breeze.

It adds only the legal withdrawal step required under Art. 11a, and works alongside your existing RMA / refund process rather than replacing it.

Documentation · Get Pro features

What it does

Storefront withdrawal flow — guided form (find order → select items → review & confirm) for guests and registered customers at /withdraw-contract/
Annex I in 22 EU locales — verbatim EUR-Lex translations where available, theme-overridable per locale
Durable-medium receipt — confirmation email with a frozen snapshot of the legal text shown to the consumer
Admin grid and workflow — filterable request list, mass actions, status state machine, CSV export
Article 16 exclusions — preset list configurable per category, with merchant override

Screenshots

Storefront — guided withdrawal flow (find order → select items → review & confirm):

Admin — manage withdrawal requests (status workflow, jurisdictions, refund totals, CSV export):

Durable-medium receipt email — the confirmation sent to the consumer with a frozen snapshot of the legal text they accepted. (The SHA-256 integrity-hash card and one-click verification shown here are a Pro add-on.)

Free vs Pro

Feature	Free	Pro
Storefront withdrawal flow	Yes	Yes
Annex I — 22 EU locales	Yes	Yes
Durable-medium receipt email	Yes	Yes
Admin grid + status workflow	Yes	Yes
Article 16 exclusion presets	Yes	Yes
Receipt verification — SHA-256 cryptographic audit	—	Yes
Annex I forensic snapshot — immutable per-request copy	—	Yes
Hash-chain audit log — DB-backed, tamper-evident	—	Yes
Magic-link guest access — one-click tokenised URL	—	Yes

→ Compare tiers and pricing

Install

composer require mageme/module-eu-withdrawal
bin/magento module:enable MageMe_EUWithdrawal
bin/magento setup:upgrade
bin/magento cache:flush

After installation, enable the module at Stores → Configuration → MageMe Extensions → EU Withdrawal.

→ Full installation guide and configuration reference

On Luma and Breeze (Swissup) storefronts the base module works out of the box — no extra package required. Only Hyvä themes need the companion module below.

Hyvä storefront

If your storefront runs on a Hyvä theme, install the theme companion alongside this module — it ports the customer-facing withdrawal flow and order-view integrations to Tailwind + Alpine.js:

composer require mageme/module-eu-withdrawal-hyva
bin/magento module:enable Hyva_MageMeEUWithdrawal
bin/magento setup:upgrade

If you also run Hyvä Checkout, add the checkout companion as well — it re-implements the pre-contract Annex I block and the digital-content waiver step (Art. 16(m)) for Hyvä Checkout's Magewire runtime:

composer require mageme/module-eu-withdrawal-hyva-checkout
bin/magento module:enable Hyva_MageMeEUWithdrawalCheckout
bin/magento setup:upgrade

→ Hyvä theme companion · Hyvä Checkout companion

Requirements

Magento 2.4.4 – 2.4.9 (Open Source / Commerce)
PHP 8.1, 8.2, 8.3, 8.4, or 8.5 — match your Magento version's PHP support matrix
MySQL 8.0+ / MariaDB 10.6+

Legal disclaimer

This module is provided AS-IS, without warranty. It is a technical implementation of the workflow described in Article 11a of Directive 2011/83/EU; it is not legal advice and has not been reviewed by EU consumer-law counsel.

The merchant is solely responsible for verifying that this implementation satisfies their jurisdiction's specific consumer-protection requirements, reviewing bundled translations for accuracy in their target markets, and adapting Article 16 exclusion presets to their actual catalogue.

Streaming and SaaS subscriptions — out of scope

This module's Art. 16(m) waiver flow is for one-time digital content — extensions, ebooks, courses, software licences, downloadable templates. It is not for ongoing digital services (streaming, SaaS subscriptions), where the waiver may not remove the withdrawal right — a digital-content vs digital-service distinction now before the CJEU in Case C-234/25. For subscription cancellations and pro-rata refunds, use your billing platform's own cancellation flow.

→ Full disclaimer and merchant compliance checklist

Digital-content waiver on API / headless orders

The Art. 16(m) waiver record is created only from a genuine storefront confirmation (the customer ticking both consent boxes). By default, digital-content orders placed through the REST/GraphQL API are blocked unless a genuine consent record exists for each digital item (the same protection the storefront enforces). If your headless integration collects the consent itself, record it through the waiver-event mechanism and the order will pass; or set Stores → Configuration → MageMe Extensions → EU Withdrawal → Digital Waiver → Enforce Waiver on API / Headless Orders to No to opt out of API enforcement (the storefront waiver step is unaffected either way).

Custom Magento development

Need a feature an extension doesn't cover, or a bespoke Magento build? MageMe takes on custom extension development and integration work.

→ Custom Magento development

Support

Documentation: docs.mageme.com
Bug reports and feature requests: GitHub Issues

Note: This GitHub Issues tracker is for free tier bug reports and feature requests only.

Changelog

See CHANGELOG.md. This module follows Semantic Versioning.

License

All tiers are governed by the MageMe End User License Agreement (mageme.com/license). The base module is distributed free of charge; Pro requires a paid commercial licence.

MageMe builds Magento 2 and Adobe Commerce extensions for B2B merchants — form building, quoting, catalog control, and EU compliance.

mageme / module-eu-withdrawal

Maintainers

Package info

Statistics

Security