{"id":311673,"date":"2026-06-03T09:34:08","date_gmt":"2026-06-03T09:34:08","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/right-of-withdrawal-for-woocommerce\/"},"modified":"2026-06-03T09:32:45","modified_gmt":"2026-06-03T09:32:45","slug":"right-of-withdrawal-for-woocommerce","status":"publish","type":"plugin","link":"https:\/\/wordpress.org\/plugins\/right-of-withdrawal-for-woocommerce\/","author":18481876,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"1.0.0","stable_tag":"1.0.0","tested":"7.0.2","requires":"6.0","requires_php":"8.0","requires_plugins":null,"header_name":"Right of Withdrawal flow for shop","header_author":"Teet Bergmann (teetb), Martin Tee (peeterpaanike)","header_description":"EU Directive 2011\/83\/EU compliant right-of-withdrawal flow \u2014 14-day cooling-off period, item-level partial returns, server-side refund math, IBAN validation, admin workflow and HTML emails. HPOS-ready.","assets_banners_color":"","last_updated":"2026-06-03 09:32:45","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"","header_author_uri":"","rating":0,"author_block_rating":0,"active_installs":0,"downloads":124,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"1.0.0":{"tag":"1.0.0","author":"teetb","date":"2026-06-03 09:32:45"}},"upgrade_notice":{"1.0.0":"<p>First public release.<\/p>"},"ratings":[],"assets_icons":[],"assets_banners":[],"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.0.0"],"block_files":[],"assets_screenshots":[],"screenshots":[]},"plugin_section":[],"plugin_tags":[255182,263925,9682,55969,245590],"plugin_category":[],"plugin_contributors":[182393,234235],"plugin_business_model":[],"class_list":["post-311673","plugin","type-plugin","status-publish","hentry","plugin_tags-consumer-rights","plugin_tags-eu-directive","plugin_tags-refund","plugin_tags-returns","plugin_tags-withdrawal","plugin_contributors-peeterpaanike","plugin_contributors-teetb","plugin_committers-teetb"],"banners":[],"icons":{"svg":false,"icon":"https:\/\/s.w.org\/plugins\/geopattern-icon\/right-of-withdrawal-for-woocommerce.svg","icon_2x":false,"generated":true},"screenshots":[],"raw_content":"<!--section=description-->\n<p>Right of Withdrawal flow for shop implements the consumer right of withdrawal mandated by the European Union <a href=\"https:\/\/eur-lex.europa.eu\/legal-content\/EN\/TXT\/?uri=CELEX%3A32011L0083\">Consumer Rights Directive (2011\/83\/EU)<\/a>, giving customers a clean, server-validated way to exercise their 14-day cooling-off period.<\/p>\n\n<p>The plugin adds a \"Withdraw from order\" button in the customer's account, opens an accessible modal where customers can pick specific items, enter an IBAN and select a withdrawal reason, then notifies the shop via HTML email and tracks the refund through to completion.<\/p>\n\n<h4>Key features<\/h4>\n\n<ul>\n<li>Full or partial withdrawal \u2014 customers select specific items and quantities.<\/li>\n<li><strong>Server-side amount calculation<\/strong> \u2014 line totals are read from the order, never trusted from the client. Coupon discounts are correctly accounted for via <code>WC_Order_Item::get_total()<\/code>.<\/li>\n<li><strong>IBAN format + Mod-97 validation<\/strong> (works in any EU country with <code>bcmod<\/code> or pure-PHP fallback).<\/li>\n<li>Order-meta storage (withdrawal date, IBAN, reason, items, refund status).<\/li>\n<li>Admin metabox with status updates: <em>Mark as refunded<\/em> \/ <em>Mark as partially refunded<\/em>.<\/li>\n<li>Optional automatic creation of an order refund record (with optional restock).<\/li>\n<li>Direct link to the withdrawal modal from the order confirmation email. The link opens the customer's account \"View order\" page; standard WordPress \/ WooCommerce authentication applies \u2014 no custom login, no magic-link auto-login.<\/li>\n<li>HTML emails for both customer and admin; styled inline for Gmail\/Outlook compatibility.<\/li>\n<li>HPOS (Custom Order Tables) compatible.<\/li>\n<li>Settings page nested under the <strong>WooCommerce<\/strong> menu.<\/li>\n<\/ul>\n\n<h4>Compliance reference<\/h4>\n\n<ul>\n<li><a href=\"https:\/\/eur-lex.europa.eu\/legal-content\/EN\/TXT\/?uri=CELEX%3A32011L0083\">Directive 2011\/83\/EU on consumer rights<\/a>, Articles 9\u201314 (Right of withdrawal).<\/li>\n<li>The 14-day period is configurable; the plugin defaults to the directive's prescribed minimum.<\/li>\n<li>Refunds are processed to the bank account supplied by the consumer (IBAN), satisfying the directive's requirement to use the same payment means <em>unless<\/em> the consumer explicitly agrees to another method.<\/li>\n<\/ul>\n\n<h4>Requirements<\/h4>\n\n<ul>\n<li>WooCommerce 7.0 or later<\/li>\n<li>PHP 8.0 or later<\/li>\n<li>WordPress 6.0 or later<\/li>\n<\/ul>\n\n<!--section=installation-->\n<ol>\n<li>Upload the plugin folder to <code>\/wp-content\/plugins\/<\/code>.<\/li>\n<li>Activate the plugin through the <strong>Plugins<\/strong> menu in WordPress.<\/li>\n<li>Go to <strong>WooCommerce \u2192 Right of Withdrawal<\/strong> and configure the settings.<\/li>\n<li>Pick the terms-and-conditions page and customise the button appearance.<\/li>\n<\/ol>\n\n<!--section=faq-->\n<dl>\n<dt id=\"is%20the%20plugin%20hpos%20compatible%3F\"><h3>Is the plugin HPOS compatible?<\/h3><\/dt>\n<dd><p>Yes. The plugin declares full compatibility with the WooCommerce Custom Order Tables (HPOS) and uses the <code>WC_Order<\/code> meta API throughout \u2014 never <code>get_post_meta()<\/code> on the order ID.<\/p><\/dd>\n<dt id=\"does%20the%20refund%20amount%20account%20for%20coupon%20discounts%3F\"><h3>Does the refund amount account for coupon discounts?<\/h3><\/dt>\n<dd><p>Yes. The plugin reads <code>WC_Order_Item::get_total()<\/code> (the post-coupon line total) plus <code>get_total_tax()<\/code>, so a customer returning a coupon-discounted item gets the correct, post-discount refund.<\/p><\/dd>\n<dt id=\"how%20do%20i%20change%20the%20withdrawal%20period%3F\"><h3>How do I change the withdrawal period?<\/h3><\/dt>\n<dd><p>Default is the EU-mandated 14 days. You can change the number and the unit (days \/ months \/ years) in the settings, and choose whether the period starts from the order's payment date or completion date.<\/p><\/dd>\n<dt id=\"does%20the%20email%20button%20log%20the%20customer%20in%20automatically%3F\"><h3>Does the email button log the customer in automatically?<\/h3><\/dt>\n<dd><p>No. The button in the order email is a regular link to the customer's \"View order\" page. If the customer is not signed in, WordPress \/ WooCommerce shows the standard login form and returns the customer to the same page after authentication. The plugin does not implement its own login flow.<\/p><\/dd>\n<dt id=\"where%20does%20the%20customer%20start%20a%20withdrawal%20request%3F\"><h3>Where does the customer start a withdrawal request?<\/h3><\/dt>\n<dd><p>Two entry points: the \"Withdraw from order\" action button in <strong>My Account \u2192 Orders<\/strong>, and the same button in the order confirmation email. Both open the same modal on the customer's \"View order\" page.<\/p><\/dd>\n<dt id=\"can%20a%20customer%20submit%20more%20than%20one%20partial%20withdrawal%20for%20the%20same%20order%3F\"><h3>Can a customer submit more than one partial withdrawal for the same order?<\/h3><\/dt>\n<dd><p>Yes. The plugin tracks per-line cumulative withdrawn quantities \u2014 a customer can return 1 of 3 items today, then 1 more next week. Further submissions are blocked once every line has been fully accounted for.<\/p><\/dd>\n<dt id=\"does%20it%20work%20for%20guest%20checkout%20%28no%20customer%20account%29%3F\"><h3>Does it work for guest checkout (no customer account)?<\/h3><\/dt>\n<dd><p>No. The modal renders only for logged-in customers viewing their own order. Guest orders have no customer to authenticate, so the email button has no destination for them. This is by design \u2014 without an account the plugin cannot verify who is requesting the refund.<\/p><\/dd>\n<dt id=\"which%20countries%27%20ibans%20are%20accepted%3F\"><h3>Which countries' IBANs are accepted?<\/h3><\/dt>\n<dd><p>Any country that uses IBAN. The plugin validates the standard format (2-letter country code + 2 check digits + up to 30 alphanumeric characters) and runs the Mod-97 checksum (uses <code>bcmod<\/code> if available, falls back to pure PHP). Non-IBAN formats are rejected at submit time.<\/p><\/dd>\n<dt id=\"what%20happens%20when%20the%20admin%20clicks%20%22mark%20as%20refunded%22%3F\"><h3>What happens when the admin clicks \"Mark as refunded\"?<\/h3><\/dt>\n<dd><p>If \"Create WooCommerce refund automatically\" is enabled (default), a <code>WC_Order_Refund<\/code> record is created with the exact line items and amount the customer requested; the order totals update accordingly, and stock is restocked if enabled. A confirmation email is then sent to the customer. Without auto-refund, only the order status and metadata are updated \u2014 no <code>WC_Order_Refund<\/code> is created.<\/p><\/dd>\n<dt id=\"where%20can%20i%20find%20the%20plugin%27s%20settings%3F\"><h3>Where can I find the plugin's settings?<\/h3><\/dt>\n<dd><p><strong>WooCommerce \u2192 Settings \u2192 Right of Withdrawal<\/strong>. The tab has five sub-tabs: General (notifications, deadline, terms page), Refund behaviour (auto-refund, restock), Withdrawal button (label, colours), Modal appearance (colours, opacity, width) and Required fields in modal (reason, IBAN, contact email, terms checkbox).<\/p><\/dd>\n<dt id=\"can%20i%20customise%20the%20list%20of%20withdrawal%20reasons%20shown%20to%20the%20customer%3F\"><h3>Can I customise the list of withdrawal reasons shown to the customer?<\/h3><\/dt>\n<dd><p>Yes. The reasons are filterable. In a child-theme <code>functions.php<\/code> or a small custom plugin:<\/p>\n\n<pre><code>add_filter('rowfs_withdrawal_reasons', function ($reasons) {\n    $reasons['gift_unsuitable'] = __('Gift was unsuitable', 'your-textdomain');\n    unset($reasons['found_better_price']);\n    return $reasons;\n});\n<\/code><\/pre><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>1.0.0<\/h4>\n\n<ul>\n<li>Initial public release.<\/li>\n<li>EU Directive 2011\/83\/EU compliant withdrawal flow.<\/li>\n<li>Inline-styled email button for Gmail\/Outlook compatibility.<\/li>\n<li>Coupon-aware refund math (uses <code>get_total()<\/code> not <code>get_subtotal()<\/code>).<\/li>\n<li>HPOS support; partial-withdrawal item-level selection.<\/li>\n<\/ul>","raw_excerpt":"EU Directive 2011\/83\/EU compliant 14-day right-of-withdrawal flow \u2014 partial returns, IBAN refunds, HTML emails, HPOS-ready.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/311673","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=311673"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/teetb"}],"wp:attachment":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=311673"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=311673"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=311673"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=311673"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=311673"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=311673"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}