Plugin WooCommerce

​

Introduzione

​

Guida all’installazione passo passo

1. Scarica dodo-payments-for-woocommerce.zip dall’ultima release su GitHub.
   Download Plugin

   Scarica l’ultima versione del plugin Dodo Payments per WooCommerce
   Puoi anche installare il plugin dalla directory dei plugin di WordPress. Nella pagina Add Plugins, cerca Dodo Payments for WooCommerce, fai clic su Install Now, quindi fai clic su Activate e continua con la guida alla configurazione.
   WordPress Plugin Directory

   Installa Dodo Payments for WooCommerce da WordPress.org
2. Accedi al tuo sito WordPress come amministratore. WooCommerce deve essere installato e attivo.
3. Vai a Plugins → Add New Plugin.
   
4. Fai clic su Upload Plugin. Viene visualizzato un modulo di caricamento.
   
   
5. Fai clic su Browse… e seleziona il file zip che hai scaricato.
6. Fai clic su Install Now.
   
7. Al termine dell’installazione, fai clic su Activate Plugin. Puoi anche attivare il plugin in seguito da Plugins → Installed Plugins.
   
8. Il plugin è installato, ma non è ancora configurato. Continua con la guida alla configurazione riportata di seguito.

​

Guida alla configurazione

​

Configurazione delle API key e dei webhook

1. Vai a WooCommerce → Settings → Payments oppure fai clic su Payments nella sezione WooCommerce della barra laterale.
   
   
2. Attiva Dodo Payments se non è già attivo, quindi fai clic su Manage.
3. Si aprono le impostazioni del plugin, con una descrizione sotto ogni opzione. Verifica che Enable Dodo Payments sia selezionato, quindi inizia da Live API Key.
   
4. Nel dashboard di Dodo Payments, attiva l’interruttore Live Mode nella barra laterale. Vai a Developer → API Keys oppure usa questo link diretto, quindi fai clic su Add API key.
   
5. Inserisci un nome per la chiave, ad esempio WooCommerce Plugin, quindi fai clic su Create.
   
6. Fai clic su Copy API Key. Il dashboard mostra la chiave una sola volta. Incollala in Live API Key nelle impostazioni del plugin.
   
   
7. Configura quindi la chiave di firma del webhook. Dodo Payments invia gli aggiornamenti sui pagamenti al tuo store tramite webhook e il plugin usa la chiave per verificare che ogni webhook provenga da Dodo Payments.
8. In fondo alle impostazioni del plugin, sotto Webhook Endpoint, copia l’URL. Ha il formato https://your-store.com/?wc-api=dodo_payments.
   
9. Nel dashboard di Dodo Payments, ancora in modalità live, vai a Developer → Webhooks e fai clic su Add endpoint.
   
10. Incolla l’URL del passaggio 8 in Endpoint URL. Lascia vuoto Subscribed events per ricevere tutti gli eventi oppure seleziona solo gli eventi relativi a pagamenti, rimborsi e subscription, ovvero quelli gestiti dal plugin. Quindi fai clic su Create endpoint.
    
11. Si apre la scheda Overview dell’endpoint. In Signing secret, fai clic sull’icona dell’occhio per mostrare il secret, quindi fai clic sull’icona di copia.
    
12. Incolla il secret in Live Webhook Signing Key nelle impostazioni del plugin, quindi fai clic su Save changes.
    
13. Controlla Global Tax Category e All Prices are Tax Inclusive. Il plugin li applica quando crea un prodotto in Dodo Payments, ovvero la prima volta che un cliente effettua il checkout con il prodotto. Dopodiché, il prodotto mantiene le impostazioni fiscali presenti nel dashboard di Dodo Payments, dove puoi modificarle per ogni prodotto. Test API Key e Test Webhook Signing Key sono necessarie solo per Test Mode.
    

​

È tutto pronto!

​

Funzionalità principali

• Hosted Checkout: i clienti pagano su una pagina di checkout di Dodo Payments, quindi tornano alla pagina di conferma dell’ordine del tuo store.
• Multiple Payment Methods: il checkout mostra i metodi di pagamento disponibili per la posizione, la valuta e il dispositivo di ciascun cliente.
• Order Status Sync: i webhook impostano l’ordine su Completed, Processing, Failed o Cancelled quando cambia lo stato del pagamento. I pagamenti non riusciti e annullati reinseriscono gli articoli nelle scorte.
• Refunds: emetti rimborsi dal dashboard di Dodo Payments. Quando un rimborso va a buon fine, il plugin imposta l’ordine su Refunded.
• Subscriptions: con WooCommerce Subscriptions, le modifiche allo stato vengono sincronizzate in entrambe le direzioni, anche quando una subscription viene annullata, sospesa o riattivata. Le modifiche alle date delle subscription in WooCommerce non vengono sincronizzate.
• Order Notes: il plugin aggiunge note all’ordine per ogni sessione di checkout, modifica dello stato ed errore, così puoi seguire ogni pagamento dalla pagina dell’ordine.
• Multi-currency Support: i prodotti vengono sincronizzati con Dodo Payments nella valuta del tuo store WooCommerce. Il flag Allow Currency Selection determina se i clienti possono cambiare valuta al checkout.

​

Risoluzione dei problemi

​

Problemi comuni

1. Errori nell’elaborazione dei pagamenti
   • Verifica che l’API key corrisponda alla modalità del plugin. Con Test Mode disattivato, il plugin usa Live API Key, che deve provenire dal dashboard in modalità live. Con Test Mode attivato, usa Test API Key.
   • Controlla le note dell’ordine. Quando il plugin non riesce a creare un checkout, aggiunge una nota con l’errore, ad esempio una che inizia con Dodo Payments Error:.
   • Se Dodo Payments non compare al checkout, verifica che la pagina di checkout utilizzi il checkout classico e non il blocco Checkout.
   • Se l’ordine contiene un codice sconto, verifica che sia un singolo codice percentuale.
   • I pagamenti live iniziano dopo che il tuo account supera la verifica dell’account.
2. Problemi di sincronizzazione dei webhook
   • Verifica che Endpoint URL corrisponda esattamente all’URL indicato in Webhook Endpoint nelle impostazioni del plugin.
   • Verifica che la signing key nel plugin corrisponda al Signing secret dell’endpoint e che entrambi provengano dalla stessa modalità.
   • Controlla il log degli errori PHP per le righe che iniziano con Dodo Payments:, ad esempio Dodo Payments: Could not verify webhook event. In modalità live, il plugin restituisce 200 anche quando la verifica non riesce, quindi i log di Dodo Payments mostrano la consegna come riuscita. In Test Mode, restituisce 401.
   • Verifica che il tuo sito disponga di un certificato SSL valido. Endpoint URL accetta solo URL HTTPS.
   • Verifica che il tuo server, il firewall e i plugin di sicurezza accettino richieste POST all’URL del webhook dagli indirizzi IP di Dodo Payments.
   • Apri la scheda Logs in Developer → Webhooks per visualizzare ogni consegna e la risposta del tuo sito.

​

Risorse di supporto

• Invia un’e-mail a support@dodopayments.com.
• Consulta la documentazione di Dodo Payments.

​

Best practice di manutenzione

1. Aggiorna il plugin quando viene rilasciata una nuova versione, per ricevere correzioni di sicurezza e nuove funzionalità.
2. Testa tutti i flussi di pagamento in Test Mode prima di accettare pagamenti live.
3. Mantieni WordPress e WooCommerce aggiornati.
4. Esegui regolarmente il backup del tuo sito.
5. Controlla gli ordini e il dashboard di Dodo Payments per individuare attività insolite.
6. Conserva le API keys in modo sicuro e non condividerle mai pubblicamente.