What Is Carta del Docente?
Carta del Docente is a €500 annual voucher that the Italian government provides to teachers for professional development and educational purchases. Since its introduction, it has become one of the most widely used teacher benefit programs in Italy, covering everything from books and software to cultural events and musical instruments.
For WooCommerce store owners targeting the Italian education market, accepting Carta del Docente as a payment method is not just a nice-to-have — it is often a requirement. Teachers expect to use their voucher wherever educational products are sold, and stores that do not support it risk losing a significant portion of this customer base.
How Carta del Docente Works
The program is managed by the Italian Ministry of Education (MIM) through a SOAP web service. Each teacher receives a €500 annual budget on their digital wallet, from which they can generate one or more vouchers of any amount. A teacher might generate a €20 voucher to buy a book, a €50 voucher for software, or a €200 voucher for a training course — the total across all vouchers cannot exceed €500 per year.
When a teacher shops on your store, they enter their voucher code at checkout. The process involves three main steps:
- Voucher verification — The plugin checks the voucher code against the MIM web service to confirm its validity and remaining credit.
- Payment processing — If valid, the voucher amount is applied to the order. If the order total exceeds the voucher value, the teacher pays the difference with another payment method.
- Voucher consumption — Once the order is completed, the plugin sends a confirmation to the MIM service to mark the voucher as consumed.
This entire flow happens automatically during checkout, with no manual intervention required from the store owner.
Key Features of the Plugin
The WooCommerce Carta del Docente plugin by ilGhera integrates this government voucher system directly into your WooCommerce store. Here is what it offers:
Full Voucher Lifecycle Management
The plugin handles the complete voucher lifecycle: verification at checkout, real-time credit checking, partial payment support (when the voucher doesn’t cover the full order), and automatic consumption confirmation when the order is completed. Teachers can enter their voucher code directly in the checkout page, and the plugin takes care of the rest.
Product Category Mapping
Carta del Docente can only be used to purchase specific categories of goods: books (including digital), hardware and software, training and professional development, theater, cinema, exhibitions, live performances, museums, and musical instruments (added in version 1.5.3 following Law 143/2024).
The plugin lets you map each WooCommerce product category to the corresponding Carta del Docente goods category. This ensures that only eligible products can be purchased with the voucher, keeping your store compliant with the program rules.
Certificate Management
To connect with the MIM web service, you need an SSL certificate (.pem file) issued by the Italian Ministry of Education. The certificate must include both the public certificate and the private key.
In the free version, you need to generate this certificate manually — a process that requires technical knowledge of SSL certificates and command-line tools. This can be a significant barrier for store owners without a technical background.
The Premium version eliminates this complexity entirely: it generates the certificate in a few clicks from the plugin settings page, with no need to touch any code or use command-line tools. This alone makes the Premium version worth the investment for most store owners.
Both versions include a sandbox mode with a demo certificate, so you can test the entire workflow before going live.
Smart Payment Gateway Display (Premium)
The Premium version intelligently shows the Carta del Docente payment option only when the cart contains products that are eligible for purchase with the voucher. If a teacher adds a non-eligible product to their cart, the Carta del Docente gateway is hidden, preventing confusion and failed transactions at checkout.
Automatic Voucher-to-Coupon Conversion (Premium)
When a teacher enters a voucher code whose value is lower than the order total, the Premium version automatically converts the voucher amount into a store coupon and applies it to the order. The remaining balance is then paid by the customer using another payment method. This seamless conversion ensures a smooth checkout experience without any manual intervention.
Free vs Premium
The plugin is available in two versions. The free version on WordPress.org includes the core functionality: voucher verification, checkout integration, and basic certificate management. It is fully functional and suitable for stores with standard requirements.
The Premium version adds advanced features that make a real difference for store owners:
- Simple certificate generation — No technical skills required
- Smart gateway display — Shows Carta del Docente only for eligible products
- Automatic voucher-to-coupon conversion — When the voucher is lower than the order total
Compatibility and Requirements
The plugin is tested with WordPress 7.0 and WooCommerce 10.8.0, and it is compatible with all major WooCommerce themes. It requires PHP SOAP extension to be enabled on your server, as the communication with the MIM web service uses SOAP over HTTPS with client certificate authentication.
For the production environment, you will need a valid SSL certificate issued by the Italian Ministry of Education.
Getting Started
Installing the plugin is straightforward. After activation, go to WooCommerce → Settings → Payments and enable the Carta del Docente payment gateway. Upload your certificate in the plugin settings page, configure the product category mappings, and you are ready to accept teacher vouchers.
Use the sandbox mode first to test the entire workflow with the demo certificate. Once everything works correctly, switch to production mode with your real certificate.
Ready to accept Carta del Docente payments on your WooCommerce store? Try the free version on WordPress.org to get started, then upgrade to ilGhera Carta Docente for WooCommerce — Premium for simple certificate generation, smart gateway display, and automatic voucher-to-coupon conversion.
0 Comments