Withdrawal Button Configuration Guide

Activates the withdrawal functionality on your storefront. When disabled, all withdrawal entry points (buttons, links, guest page) are hidden and the module won't process any requests.

Controls what happens after a customer confirms a withdrawal.

• Registration Only — The withdrawal is logged and the customer receives a confirmation email. You handle the actual cancellation or refund manually. This is the safest option and a good starting point.
• Semi-automatic — Same as Registration Only, plus admin users receive an email notification with a direct link to the withdrawal in the admin panel. Useful when you want to review each case but don't want to check the grid manually.
• Full Automatic — The module processes the withdrawal immediately. Unshipped orders are automatically canceled. Shipped orders get an offline credit memo. If neither action is possible (e.g. partially shipped), it falls back to registration only.

Recommended:

• Start with Registration Only while getting familiar with the module
• Move to Semi-automatic once your team is comfortable with the workflow
• Use Full Automatic only when you're confident the automated actions match your refund process

The number of days a customer has to withdraw from an order. The EU standard is 14 days, but you can offer a longer period if your terms allow it. You cannot set this lower than what your local law requires.

Determines when the withdrawal countdown begins.

• Order Date — From the moment the order was placed. Simplest and most common setup.
• Shipment Date — From the date the first shipment was created. Better for physical goods where the legal period typically starts at delivery.
• Delivery Date — From the actual delivery date. Requires a custom attribute or carrier integration to track delivery dates. Falls back to order date if no delivery date is available.

Recommended:

• Order Date for digital-first or simple stores
• Shipment Date for stores selling primarily physical goods

Product types that are not eligible for withdrawal. Orders containing only excluded product types cannot be withdrawn. If an order contains a mix of excluded and non-excluded types, it remains eligible.

Virtual and downloadable products are excluded by default — this aligns with EU rules where digital goods delivered immediately typically aren't eligible for withdrawal.

Comma-separated category IDs. Products in these categories follow the same logic as excluded product types: an order is only ineligible if all items belong to excluded categories.

When to use: For product categories that are legally exempt from withdrawal rights, such as personalized goods, sealed hygiene products, or perishables.

Specific SKUs to exclude from withdrawal eligibility. Enter one SKU per line or comma-separated. Same logic applies: the order is only ineligible when all items are excluded.

When to use: For individual products that are exempt, rather than entire categories or product types.

The email template sent to the customer after they confirm a withdrawal. Contains the reference code, timestamp, and order details. You can customize this template in Marketing → Email Templates.

The email template sent to admin users when a withdrawal is submitted. Only used in Semi-automatic and Full Automatic modes. Includes a direct link to the withdrawal in the admin panel.

Comma-separated email addresses that receive admin notifications. Only relevant when using Semi-automatic or Full Automatic mode.

When to use: Add your customer service team's email addresses here. Multiple addresses are supported.

When enabled, adds a tokenized withdrawal URL to order confirmation emails. Customers can click this link to start a withdrawal without logging in. The token expires after the withdrawal period ends.

When to use: Keep this enabled for the best customer experience. It's the easiest way for customers to exercise their withdrawal right, which is exactly what the EU directive aims for.

Shows a "Withdraw from order" link in the storefront footer. This links to the guest withdrawal lookup page (/withdrawal).

The text displayed in the footer link. Only visible when the footer link is enabled.

The text shown on the withdrawal button on the order detail page. Default: "Withdraw from this order". Customize this to match your store's tone or language.

An optional CSS class added to all withdrawal buttons and links. Use this if you need to style the withdrawal elements differently from your theme's defaults.

Enables detailed debug logging. When active, the module writes all withdrawal-related actions to var/log/magmodules_withdrawal_button_debug.log. Error-level events are always logged to the error log regardless of this setting.

When to use: Enable temporarily when troubleshooting issues. Disable in production to avoid unnecessary log growth.