Carte Cultura (Carta della Cultura Giovane e Carta del Merito) è un'iniziativa del governo italiano che offre ai giovani idonei un voucher da spendere in prodotti e servizi culturali. Se gestisci un negozio WooCommerce, accettare pagamenti Carte Cultura può aprire la tua attività a migliaia di potenziali clienti che desiderano utilizzare il loro bonus culturale online.
In questa guida, ti illustreremo tutto ciò che devi sapere per accettare pagamenti Carte Cultura su WooCommerce utilizzando il plugin WC Carte Cultura di ilGhera.
Cos'è Carte Cultura
Carte Cultura è l'evoluzione del programma 18app, composto da due voucher:
- Carta della Cultura Giovane — per i residenti in Italia di 18 anni, che fornisce un voucher da €500 per acquisti culturali
- Carta del Merito — per studenti che si sono diplomati con lode (100 e lode), che fornisce anch'essa un voucher da €500
Entrambi i voucher possono essere utilizzati per acquistare prodotti culturali come libri, biglietti per musei, biglietti per concerti, biglietti per il cinema, musica registrata, spettacoli teatrali e di danza, corsi di lingua e altro ancora.
Come Funziona WC Carte Cultura
La WC Carte Cultura si integra direttamente con il servizio web Carte Cultura del governo italiano (API SOAP) per convalidare i voucher in tempo reale durante il checkout. Ecco come funziona:
- Configurazione del Certificato — Carica il tuo certificato .pem fornito dal sistema Carte Cultura per autenticare il tuo negozio
- Mappatura delle Categorie di Prodotto — Mappa le tue categorie di prodotto WooCommerce con le categorie di acquisto consentite da Carte Cultura (Formazione, Libri, Cinema, Teatro, Musica, ecc.)
- Integrazione nel Checkout — I clienti inseriscono il loro codice voucher direttamente nella pagina di checkout di WooCommerce
- Validazione in Tempo Reale — Il plugin verifica la validità del voucher, il credito residuo e l'idoneità del prodotto tramite il servizio web SOAP del governo
- Payment Processing — In caso di convalida riuscita, l'importo del voucher viene applicato all'ordine. Se il voucher copre l'intero importo, l'ordine viene completato. In caso contrario, il saldo rimanente può essere pagato con un altro metodo di pagamento
Funzionalità principali
Gestione del Certificato
Il plugin gestisce l'intero ciclo di vita del certificato: carica il tuo certificato .pem, genera richieste di firma del certificato (.der) e gestisce le password del certificato. Un controllo del certificato integrato verifica le date di scadenza e ti avvisa prima della scadenza.
Generazione del Certificato (Premium)
La versione premium include uno strumento integrato per generare la richiesta di firma del certificato (file .der) richiesta dal sistema Carte Cultura. Senza un certificato valido, il tuo negozio non può autenticarsi con l'API governativa — questo è il passaggio che consente al tuo negozio di accettare voucher Carte Cultura. Il plugin ti guida attraverso ogni fase del processo di creazione del certificato.
Test in Sandbox
Prima di andare in produzione, testa l'intero flusso di lavoro con la modalità sandbox integrata. Il plugin include un certificato demo che si collega all'ambiente di test Carte Cultura, permettendoti di convalidare il flusso di checkout senza voucher reali.
Idoneità del Prodotto
Configura quali categorie di prodotto WooCommerce sono idonee per gli acquisti Carte Cultura. Il plugin convalida ogni articolo nel carrello rispetto alle categorie di acquisto consentite dal voucher, impedendo ai clienti di utilizzare il voucher su prodotti non idonei.
Pagamenti Parziali con Conversione in Coupon
Se l'importo del voucher non copre l'intero totale dell'ordine, il plugin può convertire automaticamente il voucher in un coupon WooCommerce per il saldo rimanente. Ciò consente ai clienti di combinare Carte Cultura con altri metodi di pagamento senza problemi.
Gestione Ordini
Visualizza i dettagli del voucher direttamente nel pannello di amministrazione dell'ordine, inclusi il codice voucher, l'importo utilizzato e lo stato di convalida. Il plugin supporta anche la sospensione degli ordini per la revisione manuale quando necessario.
Versione gratuita vs Premium
Il plugin è disponibile in due versioni:
- Versione gratuita — Disponibile su WordPress.org, include le funzionalità di base del gateway di pagamento Carte Cultura con gestione del certificato e mappatura delle categorie di prodotto
- Premium version — Aggiunge funzionalità chiave: generazione del certificato (file .der) per autenticare il tuo negozio con il sistema Carte Cultura, conversione in coupon per pagamenti parziali, sospensione degli ordini per revisione manuale, supporto prioritario e aggiornamenti automatici tramite Plugin Update Checker
La versione Premium parte da €9,98/mese o €119,80/anno.
Per iniziare
- Installa e attiva il plugin WC Carte Cultura da WordPress.org o carica la versione Premium
- Vai su WooCommerce → WC Carte Cultura nel tuo pannello di amministrazione WordPress
- Carica il tuo certificato .pem e imposta la password del certificato
- Mappa le tue categorie di prodotto con le categorie di acquisto Carte Cultura
- Configura le impostazioni del gateway (abilita prima la sandbox per i test)
- Testa il flusso di checkout con l'ambiente sandbox
- Passa alla modalità di produzione quando sei pronto
Requisiti tecnici
- WordPress 4.0+
- WooCommerce 4.0+
- Estensione PHP SOAP abilitata
- Estensione OpenSSL abilitata
- Un certificato .pem valido dal sistema Carte Cultura
- Certificato SSL sul tuo negozio (richiesto per la trasmissione sicura del voucher)
Conclusione
Accettare pagamenti Carte Cultura su WooCommerce è semplice con il plugin WC Carte Cultura. Il plugin gestisce tutta la complessità della comunicazione SOAP con il servizio web governativo, la gestione del certificato e la convalida in tempo reale del voucher — permettendoti di concentrarti sulla vendita di prodotti culturali.
Scarica WC Carte Cultura gratuito — gateway di pagamento Carte Cultura di base disponibile su WordPress.org.
Ottieni WC Carte Cultura Premium — include generazione del certificato, conversione in coupon, supporto prioritario e aggiornamenti automatici.
0 commenti