La Carta della Cultura Giovani e il Carta del Merito sono iniziative del Ministero della Cultura che offrono un bonus di €500 ai giovani adulti e agli studenti meritevoli, da spendere in beni e servizi culturali. Per i commercianti che operano con WooCommerce, accettare le Carte Cultura rappresenta un'opportunità significativa per espandere la propria base di clienti.

In questa guida passo-passo, ti mostreremo come configurare il plugin WC Carte Cultura per WooCommerce per accettare pagamenti con Carta della Cultura Giovani e Carta del Merito nel tuo negozio, dall'installazione all'attivazione del voucher.

Cos'è il plugin WC Carte Cultura?

Il plugin ti consente di abilitare il pagamento con Carta della Cultura Giovani e Carta del Merito sul tuo negozio WooCommerce. Al momento del checkout, il voucher inserito dall'utente viene verificato per validità, credito disponibile e pertinenza in termini di tipologia di prodotto, garantendo la conformità alle regole del programma.

Versione gratuita vs Premium

La versione gratuita, disponibile su WordPress.org, copre l'intero flusso di pagamento: caricamento del proprio certificato .pem , modalità Sandbox per i test, configurazione delle categorie di prodotti acquistabili con i voucher e visualizzazione del logo Carte Cultura al checkout. Se possiedi già un certificato, è tutto ciò di cui hai bisogno per iniziare ad accettare voucher.

La versione premium aggiunge gli strumenti attorno a quel flusso: generazione della richiesta del certificato (.der) e del certificato finale (.pem) direttamente dal plugin, visualizzazione del metodo di pagamento solo per carrelli idonei, ordini in attesa con validazione manuale del voucher, esclusione dei costi di spedizione dall'importo del voucher, conversione di un voucher parziale in coupon, personalizzazione dei messaggi inviati al cliente via email e supporto prioritario.

In tutta questa guida, i passaggi e le opzioni contrassegnati con (Premium) richiedono la versione premium.

Requisiti

• WordPress 4.0+
• WooCommerce (testato fino alla versione 11.0.1)
• Certificato digitale Carte Cultura

Passaggio 1: Installazione del plugin

Installa il plugin WC Carte Cultura dal pannello di amministrazione di WordPress:

1. Vai su Plugin → Aggiungi nuovo.
2. Cerca "WC Carte Cultura" e installalo.
3. Attiva il plugin dalla pagina Plugin.
4. Una volta attivato vai in WooCommerce → WC Carte Cultura per impostare le tue preferenze.

Passaggio 2: Inserimento della chiave Premium (Premium)

Se stai utilizzando la versione premium, inserisci la tua chiave Premium nel campo dedicato nella pagina delle impostazioni del plugin. Questa chiave è necessaria per mantenere il plugin aggiornato e ricevere gli aggiornamenti. La versione gratuita non ha tale campo: viene aggiornata tramite WordPress.org come qualsiasi altro plugin gratuito.

Passaggio 3: Configurazione del certificato

Il certificato digitale è essenziale per la connessione sicura con il servizio Carte Cultura. Il plugin offre tre modalità — la prima è disponibile nella versione gratuita, le altre due richiedono la versione premium.

Opzione A: Carica il tuo certificato

Se possiedi già un certificato (.pem), tutto ciò che devi fare è caricarlo con la password associata:

1. Nella scheda Certificato , clicca su "Carica certificato".
2. Seleziona il file .pem dal tuo computer.
3. Inserisci la password utilizzata per generare il certificato.
4. Clicca su "Salva certificato".

Il plugin verificherà automaticamente la validità del certificato e mostrerà la data di scadenza.

Opzione B: Genera la richiesta del certificato (.der) (Premium)

Se non hai ancora un certificato, puoi generare la richiesta direttamente dal plugin. Il modulo è visibile anche nella versione gratuita, ma i suoi campi sono disabilitati: compilarlo e scaricare il file richiede la versione premium.

1. Compila i campi obbligatori: Stato, Provincia, Località, Ragione sociale, Dipartimento aziendale, Nome, Email e Password.
2. Clicca su "Scarica file .der".
3. Carica il file .der sul sito web Carte Cultura per richiedere il certificato.

Opzione C: Genera il certificato finale (.pem) (Premium)

Dopo aver ottenuto il file .cer dal sito web Carte Cultura, la versione premium lo converte nel certificato finale per te:

1. Carica il file .cer nel plugin.
2. Clicca su "Genera certificato".
3. Il plugin genererà automaticamente il certificato finale .pem.

Passaggio 4: Modalità Sandbox

Prima di andare in produzione, ti consigliamo di testare l'integrazione in modalità Sandbox — disponibile sia nella versione gratuita che in quella premium:

1. Abilita la casella di controllo "Modalità Sandbox" nelle impostazioni.
2. Richiedi voucher di prova scrivendo a numeroverde@cultura.gov.it.
3. Testa il flusso di pagamento completo con i voucher di prova.

Passaggio 5: Configurazione delle categorie

Le Carte Cultura possono essere utilizzate solo per beni e servizi specifici. Configura le categorie dei prodotti acquistabili:

1. Nella scheda Opzioni , seleziona le categorie di prodotti corrispondenti ai beni acquistabili.
2. Puoi aggiungere più categorie cliccando su "Aggiungi categoria".
3. Ogni categoria può essere associata a uno specifico ambito di utilizzo (beni).

Passaggio 6: Opzioni avanzate

Il plugin offre diverse opzioni per personalizzare il comportamento del pagamento. Solo la prima fa parte della versione gratuita:

• Utilizzo dell'immagine — Mostra il logo Carte Cultura nella pagina di checkout.
• Verifica del prodotto (Premium) — Mostra il metodo di pagamento solo se i prodotti nel carrello sono acquistabili con i voucher Carta della Cultura Giovani e Carta del Merito.
• Ordini in attesa (Premium) — I voucher vengono validati con il completamento manuale degli ordini.
• Costi di spedizione (Premium) — Escludi i costi di spedizione dal pagamento con le Carte Cultura.
• Conversione in coupon (Premium) — Se il voucher inserito è inferiore al totale del carrello, viene convertito in un codice promozionale e applicato all'ordine.

Passaggio 7: Personalizzazione delle email (Premium)

La versione premium ti consente di personalizzare i messaggi che i tuoi clienti ricevono. Questi campi compaiono solo quando l'opzione Ordini in attesa del Passaggio 6 è abilitata, poiché descrivono il flusso di validazione manuale:

• Ordine ricevuto — Messaggio aggiunto all'email di ordine inviata all'utente alla ricezione dell'ordine.
• Oggetto dell'email — Oggetto dell'email inviata in caso di validazione non riuscita.
• Intestazione dell'email — Intestazione dell'email inviata in caso di validazione non riuscita.
• Ordine non riuscito — Messaggio aggiunto all'email quando la validazione del voucher non ha successo (supporta lo shortcode [checkout-url] , che collega direttamente il cliente alla pagina di pagamento).

Passaggio 8: Primo pagamento

Una volta completata la configurazione, il metodo di pagamento Carte Cultura sarà disponibile al checkout:

1. Il cliente aggiunge i prodotti al carrello e procede al checkout.
2. Seleziona il metodo di pagamento Carte Cultura.
3. Inserisce il proprio codice voucher.
4. Il plugin verifica automaticamente la validità del voucher, il credito disponibile e la pertinenza del prodotto.
5. Se il voucher è valido, l'ordine viene completato e il voucher viene consumato.

Conclusione

Configurare il pagamento con le Carte Cultura nel tuo negozio WooCommerce è semplice con il plugin WC Carte Cultura per WooCommerce. Inizia con la versione gratuita per accettare voucher con il tuo certificato, e passa alla versione premium quando hai bisogno che il plugin generi il certificato per te, gestisca gli ordini in attesa o converta i voucher parziali in coupon — accettando pagamenti con Carta della Cultura Giovani e Carta del Merito in modo conforme e automatizzato, espandendo la tua base di clienti e offrendo un'esperienza di acquisto fluida ai tuoi clienti.

Pronto per iniziare? Prova ilGhera Carte Cultura per WooCommerce gratuitamente su WordPress.org, poi passa a ilGhera Carte Cultura per WooCommerce — Premium per la generazione del certificato (richiesta .der e .pem finale), ordini in attesa con validazione manuale del voucher, verifica dell'idoneità del carrello, esclusione dei costi di spedizione, conversione del voucher in coupon, email personalizzabili per i clienti e supporto prioritario.