Documentation

WWU Withdrawal Button mette WooCommerce, FluentCart ed Easy Digital Downloads a norma con il bouton de rétractation en ligne richiesto dalla Direttiva UE 2023/2673 (art. 54-bis Codice del Consumo). Pulsante statutario, modulo in due passaggi, ricevuta su supporto durevole, log immodificabile e marca temporale. Gratuito e open source (GPLv3).

Come funziona (in pratica)

Per il cliente è semplicissimo — quattro passaggi:

1. Clic sul pulsante. Il cliente apre il suo ordine e clicca «Recedere dal contratto qui» — dall'area account, dal link nell'email d'ordine, oppure dalla pagina pubblica (senza account: cerca l'ordine con numero + email). La dicitura è quella esatta prevista dalla legge per ogni lingua.
2. Modulo in due passaggi. Rivede da cosa sta recedendo (può spuntare solo alcuni prodotti — recesso parziale), poi conferma. Nessun motivo obbligatorio, nessun dark pattern.
3. Ricevuta su supporto durevole. Appena conferma, riceve email + PDF + link permanente verificabile con cosa ha recesso e data/ora esatte. L'ordine passa a «recesso richiesto» e tu ricevi una notifica.
4. Prova immodificabile. Ogni passaggio finisce in un log append-only con hash-chain e marca temporale (data certa). Tu poi gestisci il rimborso come sempre — registrato anch'esso come prova del rispetto dei 14 giorni.

Tutto il resto del plugin serve a rendere questo flusso corretto, facile da gestire e difendibile. In sintesi, cosa include (ogni voce ha la sua sezione qui sotto):

• Per il cliente: pulsante statutario multilingua ovunque serva (account, email, pagina pubblica con lookup ospiti, shortcode, blocco), guide étape par étape su tempi e rimborso, nota «perché esente» quando il pulsante è giustamente assente, certificato di verifica leggibile della ricevuta, recesso parziale per prodotto.
• Per te (commerciante): cruscotto di onboarding con checklist a un clic e test di consegna email, gestione richieste (stati lavorata/rimborsata, badge integrità della catena, reinvio ricevuta, rimborso registrato), pagina Conformità con countdown, etichette in uso e clausole pronte, ricevuta come vera email WooCommerce con anteprima, campo CSS personalizzato.
• Gestione legale intelligente: abbonamenti (un solo diritto per contratto, pulsante sull'ordine iniziale), esenzioni Art. 59 con cattura del consenso al checkout e conferma su supporto durevole, ambito di applicabilità per Paese (UE/SEE o sempre), gestione B2B.
• Prova, marche temporali & integrità: log immodificabile con hash-chain + ancoraggio gratuito OpenTimestamps (Bitcoin) o eIDAS RFC 3161 qualificato (Sectigo gratis o QTSP nazionali), retry automatico delle marche, rimborso loggato.
• Privacy & GDPR: IP anonimizzato nell'hash, IP completo cancellabile dopo una retention configurabile (default 10 anni), registro consensi esportabile in CSV, due clausole privacy pronte (legittimo interesse).
• Documenti & conformità: generatore del modulo tipo Allegato I-B e delle clausole per precontrattuale / Condizioni / Privacy da incollare — con il promemoria che installare il pulsante non basta, vanno aggiornati anche i tuoi T&C.
• Automazioni & sviluppatori: API REST di sola lettura + webhook firmato (HMAC) + 33 hook documentati per Zapier/Make/n8n/CRM/helpdesk, privacy-first (l'IP del cliente non è mai esposto).
• Piattaforme & compatibilità: WooCommerce (HPOS + legacy), FluentCart ed Easy Digital Downloads con un solo plugin; compatibile con Complianz, TranslatePress e i cache plugin (WP Rocket / LiteSpeed / W3TC).

Requisiti

Installazione

1. Scarica wwu-withdrawal-button.zip (il pacchetto ufficiale include la libreria PDF).
2. In WordPress: Plugin → Aggiungi nuovo → Carica plugin → seleziona lo ZIP → Installa ora (se esiste già scegli «Sostituisci l'attuale con il caricato»).
3. Attiva. Il plugin crea da solo la pagina pubblica «Diritto di recesso» e le tabelle del log.

Configurazione

Vai su Withdrawal Button → Settings e procedi dall'alto verso il basso. Il Dashboard ha una checklist che diventa tutta verde quando sei a posto.

1. Abilita la funzione di recesso.
2. Dove si applica — «Solo UE/SEE» (minimo legale) o «Mostra sempre»; opzionale esclusione B2B (P.IVA).
3. Consumer guidance — finestra di recesso in giorni (min 14; puoi concederne di più) e, se vuoi, un testo guida personalizzato.
4. Receipt & evidence — allega PDF, email di notifica, marca temporale (OpenTimestamps gratis, o RFC 3161), retention, slug della scheda account.
5. Email delivery — configura l'SMTP, fai il test, poi «Preview the acknowledgement email».

Tutte le impostazioni

Aggiorna i tuoi documenti legali (obbligatorio)

Installare il pulsante non basta per essere a norma. La Direttiva sui diritti dei consumatori (art. 6) impone di informare il consumatore su come esercita il recesso: con l'introduzione del pulsante, le tue Condizioni di vendita e le informazioni precontrattuali vanno aggiornate nell'articolo sul recesso per prevedere la nuova modalità con pulsante. Il plugin aggiunge il pulsante, ma non modifica i tuoi documenti pubblicati.

Per renderlo semplice, il plugin genera le clausole pronte da incollare — le trovi in Withdrawal Button → Conformità (e via shortcode [wwu_wb_info type="precontractual|terms|privacy"]):

• Informazioni precontrattuali — la clausola «Diritto di recesso» che cita esplicitamente il pulsante «Recedere dal contratto qui», oltre al modulo tipo (Allegato I-B) che resta obbligatorio.
• Condizioni di vendita — la clausola «Modalità di recesso»: il consumatore recede tramite il pulsante online o il modulo tipo, con avviso di ricevimento su supporto durevole e divieto di rendere il recesso più difficile dell'acquisto.
• Privacy — le clausole sul registro dei recessi e sulla prova del consenso alle esenzioni.

Dove appare il pulsante

• WooCommerce — area cliente: lista ordini, dettaglio ordine, scheda «Diritto di recesso»; + link aggiunto automaticamente dentro le email d'ordine WooCommerce (per gli ospiti).
• FluentCart — portale cliente: pagina «Diritto di recesso», voce nel menu, banner e pulsante nel singolo ordine. Per le email: FluentCart non consente ai plugin di aggiungere contenuto in automatico, quindi Impostazioni → FluentCart mostra una guida opzionale 1-volta per inserire il merge-tag {{wwu.recesso_url}} nel template della ricevuta (3 passi).
• Easy Digital Downloads — pulsante sulla ricevuta d'acquisto e nelle righe della cronologia acquisti; + link aggiunto automaticamente nell'email di ricevuta EDD.
• Su ogni piattaforma: pagina pubblica con lookup ospiti (numero ordine + email), e ovunque con gli shortcode o il blocco Gutenberg.

Shortcode & blocco

Blocco editor: «Withdrawal — self-service» (dynamic, server-rendered) per inserire la superficie ovunque nell'editor a blocchi.

Esperienza cliente

1. Il cliente apre il suo ordine e clicca il pulsante statutario. Nel primo passaggio del modulo compare una checklist opzionale degli articoli dell'ordine: può selezionare solo i prodotti da restituire (recesso parziale, consentito dalla legge UE — Allegato I-B: «dei seguenti beni»). Se lascia la selezione vuota, il recesso riguarda l'intero ordine. Il recesso non è mai bloccato da questa scelta.
2. Modulo in due passaggi (revisione → conferma), nessun dark pattern, nessun motivo richiesto.
3. Alla conferma riceve subito un'attestazione di ricevimento via email (+ PDF + link verificabile), con l'elenco degli articoli selezionati; l'ordine passa a «recesso richiesto».

Gestione richieste

In Withdrawal Button → Requests: ogni richiesta con stato (Aperta / Lavorata / Rimborsata), badge integrità della catena, e azioni:

• Mark processed — segna come gestita (registrata nel log).
• Resend email — reinvia la ricevuta (utile dopo aver configurato l'SMTP).
• Refund order — apre la schermata rimborso WooCommerce. Il rimborso viene registrato nel log come prova del rispetto dei 14 giorni.

Marche temporali

Scegli in Receipt & evidence → Trusted timestamp:

Esenzioni (Art. 59)

Alcuni prodotti/servizi non hanno diritto di recesso (beni su misura, deperibili, sigillati aperti, biglietti per eventi a data fissa, contenuti digitali ad accesso immediato con consenso, servizi già eseguiti…). In Impostazioni → Esenzioni tagghi prodotti/categorie per motivo statutario specifico, ciascuno con riferimento di legge e spiegazione in linguaggio semplice. Il diritto di recesso resta il default (prodotti digitali inclusi).

Quando un ordine è interamente esente, il pulsante di recesso non compare — ma il cliente non resta senza spiegazioni. Dalla 1.0.0-alpha.43, una nota breve e accurata riporta l'eccezione specifica applicata con il relativo riferimento normativo (es. «Contenuto digitale ad accesso immediato — Art. 16(1)(m) CRD / Art. 59(1)(o) Cod. Consumo»). La nota è mostrata sul modulo di recesso, nelle pagine account WooCommerce ed EDD e nel portale FluentCart. Il testo è editabile in Impostazioni → Guida al consumatore. Compare solo sugli ordini realmente esenti, mai su quelli ordinari; la visibilità del pulsante non cambia.

Abbonamenti

La legge UE dà un solo diritto di recesso di 14 giorni conformément au contrat, che parte dalla conclusione del contratto (art. 9 Dir. 2011/83/UE = art. 52 Codice del Consumo). Un rinnovo non lo fa ripartire: è la continuazione dello stesso contratto, non un nuovo contratto a distanza. Quindi:

• Il pulsante compare solo sull'ordine iniziale dell'abbonamento (entro la sua finestra di 14 giorni).
• Sugli ordini di rinnovo il pulsante è nascosto — un unico controllo copre automaticamente tutte le superfici (area cliente, portale, email, shortcode, blocco).
• Funziona con WooCommerce Subscriptions, gli abbonamenti FluentCart e EDD Recurring. Il rilevamento del rinnovo è prudente e à sécurité intégrée: se lo stato non è determinabile, il pulsante reste visible (mai nascosto per errore).

In Impostazioni → Subscriptions ci sono due interruttori, entrambi disattivi per default:

FAQ

Basta installare il pulsante per essere a norma? No. Devi aggiornare anche le tue Condizioni di vendita e le informazioni precontrattuali nell'articolo sul recesso, per prevedere la nuova modalità con pulsante (art. 6 della Direttiva diritti dei consumatori). Il plugin genera le clausole pronte da incollare — vedi Aggiorna i tuoi documenti legali.

Posso dare più di 14 giorni? Sì — imposta «Withdrawal period» a piacere (≥14). Il testo mostrato si aggiorna.

Come funziona con gli abbonamenti? Il pulsante compare sull'ordine iniziale e sparisce sui renouvellements (un solo diritto di 14 giorni per contratto). Il recesso non è la disdetta: il cliente può sempre fermare i rinnovi futuri dal suo account, ma il recesso è il diritto di 14 giorni con rimborso. Vedi la sezione Abbonamenti.

L'email non parte? Configura un plugin SMTP e usa «Send test email». Non è la libreria PDF.

Funziona con i temi a blocchi / FSE? Sì: la pagina My Account di WooCommerce è ancora resa dallo shortcode classico, gli hook funzionano; c'è anche un blocco Gutenberg.

La legge si applica ai prodotti digitali (plugin, software, download)? Sì. L'obbligo del pulsante riguarda il professionista che vende online a consumatori UE, non il singolo prodotto — anche uno shop di plugin o di contenuti digitali è in scope. I prodotti digitali hanno i 14 giorni di recesso per default; il diritto si toglie solo con consenso espresso + presa d'atto + conferma su supporto durevole (art. 59 lett. o), che il plugin cattura al checkout. Le vendite B2B (con partita IVA) e ai consumatori extra-UE sono fuori scope.

È consulenza legale? No, è uno strumento tecnico di supporto alla conformità. Fai revisionare i tuoi documenti da un legale.

Per sviluppatori

Il plugin espone 33 hook pubblici documentati (action e filter) per personalizzare il flusso di recesso, i testi, la logica di visibilità del pulsante, la ricevuta e il log — senza modificare il core del plugin.

API REST & webhook (automazioni)

Dalla 1.0.0-alpha.44 il plugin offre un'API REST en lecture seule (namespace wwu-wb/v1, autenticazione con Password applicazione di WordPress) per elencare le richieste di recesso e verificare lo stato di un ordine, più un webhook in uscita firmato (HMAC-SHA256) che notifica il tuo endpoint nel momento in cui un recesso viene confermato — pronto per Zapier, Make, n8n, un CRM o un helpdesk. Privacy-first: l'IP del consumatore non viene mai esposto (solo un hash di riga per la verifica d'integrità). Non esiste — per scelta — un endpoint per créer un recesso (è la dichiarazione legale del consumatore). Superata una verifica di sicurezza dedicata prima del rilascio.

Changelog

Mantieni questa sezione allineata al docs/changelog/wwu-wb-CHANGELOG.md del repository.