> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dodopayments.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Plugin WooCommerce

> Integra Dodo Payments senza soluzione di continuità con il tuo negozio WooCommerce per accettare pagamenti globali tramite UPI, carte e altro.

## Introduzione

Il plugin WooCommerce di Dodo Payments fornisce un'integrazione senza soluzione di continuità con il tuo negozio, consentendoti di accettare pagamenti tramite più metodi, tra cui UPI, carte, bonifici bancari e portafogli digitali. Questa guida completa ti guiderà attraverso il processo di installazione e configurazione.

## Guida all'Installazione Passo-Passo

1. Scarica l'ultima versione zip del plugin di pagamento WooCommerce.

   <Card title="Download Plugin" icon="download" href="https://github.com/dodopayments/dodo-woocommerce/releases">
     Ottieni l'ultima versione del nostro plugin WooCommerce
   </Card>

   In alternativa, puoi installarlo direttamente dalla directory dei plugin di WordPress:

   <Card title="WordPress Plugin Directory" icon="wordpress" href="https://wordpress.org/plugins/dodo-payments-for-woocommerce/">
     Installa Dodo Payments per WooCommerce da WordPress.org
   </Card>

2. Accedi al tuo sito WordPress come amministratore (presumiamo che WooCommerce sia già configurato)

3. Vai su **Plugin → Aggiungi Nuovo Plugin**

   <Frame>
     <img src="https://mintcdn.com/dodopayments/rsanoiHs7RZfcFW7/images/woocommerce/1.webp?fit=max&auto=format&n=rsanoiHs7RZfcFW7&q=85&s=f26041db02cf678f4785a8d72631d0e2" alt="Plugin Dodo Payments per WooCommerce" width="447" height="136" data-path="images/woocommerce/1.webp" />
   </Frame>

4. Fai clic sul pulsante **Carica Plugin** e verrà visualizzata una finestra di dialogo per la selezione del file

   <Frame>
     <img src="https://mintcdn.com/dodopayments/rsanoiHs7RZfcFW7/images/woocommerce/2.webp?fit=max&auto=format&n=rsanoiHs7RZfcFW7&q=85&s=9f20388bab236d046cbff312646dcd98" alt="Plugin Dodo Payments per WooCommerce" width="433" height="75" data-path="images/woocommerce/2.webp" />
   </Frame>

   <Frame>
     <img src="https://mintcdn.com/dodopayments/rsanoiHs7RZfcFW7/images/woocommerce/3.webp?fit=max&auto=format&n=rsanoiHs7RZfcFW7&q=85&s=c9cdccfe01ceda93932c9feea5ee5e65" alt="Plugin Dodo Payments per WooCommerce" width="1313" height="356" data-path="images/woocommerce/3.webp" />
   </Frame>

5. Fai clic su **Sfoglia…** e seleziona il file zip che hai scaricato

6. Fai clic sul pulsante **Installa ora** per avviare il processo di installazione

   <Frame>
     <img src="https://mintcdn.com/dodopayments/rsanoiHs7RZfcFW7/images/woocommerce/4.webp?fit=max&auto=format&n=rsanoiHs7RZfcFW7&q=85&s=3a785b07a5c0f47318893a73059875b5" alt="Plugin Dodo Payments per WooCommerce" width="1024" height="307" data-path="images/woocommerce/4.webp" />
   </Frame>

7. Dopo il completamento dell'installazione, clicca su **Attiva plugin** oppure attivalo dalla sezione **Plugin installati**

   <Frame>
     <img src="https://mintcdn.com/dodopayments/rsanoiHs7RZfcFW7/images/woocommerce/5.webp?fit=max&auto=format&n=rsanoiHs7RZfcFW7&q=85&s=d7a144b16abd059e81a694585f3d6923" alt="Plugin Dodo Payments per WooCommerce" width="897" height="289" data-path="images/woocommerce/5.webp" />
   </Frame>

8. Il plugin è ora installato, ma è necessaria ancora la configurazione. Prosegui con la guida alla configurazione qui sotto.

## Guida alla Configurazione

### Impostazione delle Chiavi API e dei Webhook

1. Vai su **WooCommerce → Impostazioni → Pagamenti** oppure fai clic sul pulsante **Pagamenti** nella barra laterale sinistra sotto la voce di menu WooCommerce

   <Frame>
     <img src="https://mintcdn.com/dodopayments/rsanoiHs7RZfcFW7/images/woocommerce/6.webp?fit=max&auto=format&n=rsanoiHs7RZfcFW7&q=85&s=292552cc453ac05b4a0a368cd0d2adb8" alt="Plugin Dodo Payments per WooCommerce" width="1887" height="958" data-path="images/woocommerce/6.webp" />
   </Frame>

   <Frame>
     <img src="https://mintcdn.com/dodopayments/rsanoiHs7RZfcFW7/images/woocommerce/7.webp?fit=max&auto=format&n=rsanoiHs7RZfcFW7&q=85&s=e289459e7a2c95082504229293c0863e" alt="Plugin Dodo Payments per WooCommerce" width="234" height="242" data-path="images/woocommerce/7.webp" />
   </Frame>

2. Abilita il fornitore di pagamento **Dodo Payments** se non è già attivo, quindi fai clic su **Gestisci** per configurare il plugin

3. Vedrai varie opzioni di configurazione, ognuna con testo esplicativo utile. Inizia impostando la tua Chiave API Live

   <Frame>
     <img src="https://mintcdn.com/dodopayments/rsanoiHs7RZfcFW7/images/woocommerce/8.webp?fit=max&auto=format&n=rsanoiHs7RZfcFW7&q=85&s=0cad2f1d5bbba36d54e1d54e8ffb8961" alt="Plugin Dodo Payments per WooCommerce" width="1658" height="867" data-path="images/woocommerce/8.webp" />
   </Frame>

4. Accedi alla tua dashboard Dodo Payments in **Modalità Live**, quindi vai su **Dodo Payments (Modalità Live) > Sviluppatore > Chiavi API** oppure visita [questo collegamento diretto](https://app.dodopayments.com/developer/api-keys) e fai clic su **Aggiungi Chiave API**

   <Frame>
     <img src="https://mintcdn.com/dodopayments/rsanoiHs7RZfcFW7/images/woocommerce/9.webp?fit=max&auto=format&n=rsanoiHs7RZfcFW7&q=85&s=baa03ad325826db734456fd30e30363c" alt="Plugin Dodo Payments per WooCommerce" width="1876" height="991" data-path="images/woocommerce/9.webp" />
   </Frame>

5. Assegna alla tua Chiave API un nome descrittivo e fai clic su **Crea**

   <Frame>
     <img src="https://mintcdn.com/dodopayments/rsanoiHs7RZfcFW7/images/woocommerce/10.webp?fit=max&auto=format&n=rsanoiHs7RZfcFW7&q=85&s=af89376b00b5265c1d375dcc6fa218f3" alt="Plugin Dodo Payments per WooCommerce" width="549" height="365" data-path="images/woocommerce/10.webp" />
   </Frame>

6. Copia la Chiave API generata e incollala nel campo **Chiave API Live** nelle impostazioni del plugin WooCommerce

   <Frame>
     <img src="https://mintcdn.com/dodopayments/rsanoiHs7RZfcFW7/images/woocommerce/11.webp?fit=max&auto=format&n=rsanoiHs7RZfcFW7&q=85&s=bd998ae7bb40791d2193b807813521cb" alt="Plugin Dodo Payments per WooCommerce" width="570" height="491" data-path="images/woocommerce/11.webp" />
   </Frame>

   <Frame>
     <img src="https://mintcdn.com/dodopayments/rsanoiHs7RZfcFW7/images/woocommerce/12.webp?fit=max&auto=format&n=rsanoiHs7RZfcFW7&q=85&s=dd3f751317c6be0401c50bde584705e2" alt="Plugin Dodo Payments per WooCommerce" width="1395" height="115" data-path="images/woocommerce/12.webp" />
   </Frame>

7. Successivamente, configura la Chiave di Firma Webhook per abilitare la sincronizzazione dello stato dei pagamenti tra Dodo Payments e WooCommerce

8. Scorri fino alla fine della pagina delle impostazioni del plugin e copia l'URL del webhook visualizzato lì

   <Frame>
     <img src="https://mintcdn.com/dodopayments/rsanoiHs7RZfcFW7/images/woocommerce/13.webp?fit=max&auto=format&n=rsanoiHs7RZfcFW7&q=85&s=becfefe5c5e04aeecefb8b8d126ff571" alt="Plugin Dodo Payments per WooCommerce" width="1062" height="239" data-path="images/woocommerce/13.webp" />
   </Frame>

9. Torna alla dashboard Dodo Payments e vai su **Dodo Payments (Modalità Live) > Sviluppatore > Webhook** e fai clic su **Aggiungi Webhook**

   <Frame>
     <img src="https://mintcdn.com/dodopayments/rsanoiHs7RZfcFW7/images/woocommerce/14.webp?fit=max&auto=format&n=rsanoiHs7RZfcFW7&q=85&s=fda4e9a992317218190c439b9addb6d3" alt="Plugin Dodo Payments per WooCommerce" width="1884" height="994" data-path="images/woocommerce/14.webp" />
   </Frame>

10. Incolla l'URL copiato al punto 8 nella finestra di dialogo e fai clic su **Aggiungi Webhook**

    <Frame>
      <img src="https://mintcdn.com/dodopayments/rsanoiHs7RZfcFW7/images/woocommerce/15.webp?fit=max&auto=format&n=rsanoiHs7RZfcFW7&q=85&s=da9541f69ffaa9e37f4135c6163329c0" alt="Plugin Dodo Payments per WooCommerce" width="542" height="417" data-path="images/woocommerce/15.webp" />
    </Frame>

11. Dopo aver creato il webhook, fai clic sull'icona a forma di occhio accanto alla **Chiave di Firma** oscurata per rivelarla e copiarla

    <Frame>
      <img src="https://mintcdn.com/dodopayments/rsanoiHs7RZfcFW7/images/woocommerce/16.webp?fit=max&auto=format&n=rsanoiHs7RZfcFW7&q=85&s=9f342ef95be984773dd065c0fd46f1a4" alt="Plugin Dodo Payments per WooCommerce" width="1527" height="356" data-path="images/woocommerce/16.webp" />
    </Frame>

12. Incolla la Chiave di Firma nel campo **Chiave di Firma Webhook Live** nelle impostazioni del plugin e salva le modifiche

    <Frame>
      <img src="https://mintcdn.com/dodopayments/rsanoiHs7RZfcFW7/images/woocommerce/17.webp?fit=max&auto=format&n=rsanoiHs7RZfcFW7&q=85&s=2cfee72402218b0170d63c2b136d9de9" alt="Plugin Dodo Payments per WooCommerce" width="1608" height="155" data-path="images/woocommerce/17.webp" />
    </Frame>

13. Esamina le impostazioni rimanenti come **Categoria fiscale globale** e **Tutti i prezzi includono le tasse**, poiché queste opzioni determinano come i prodotti vengono sincronizzati da WooCommerce a Dodo Payments. Nota che **Chiave API di Test** e **Chiave di Firma Webhook di Test** sono necessarie solo se prevedi di utilizzare la Modalità Test

    <Frame>
      <img src="https://mintcdn.com/dodopayments/rsanoiHs7RZfcFW7/images/woocommerce/18.webp?fit=max&auto=format&n=rsanoiHs7RZfcFW7&q=85&s=746184a19efe5bfb14febfc6955c4c8e" alt="Plugin Dodo Payments per WooCommerce" width="1612" height="677" data-path="images/woocommerce/18.webp" />
    </Frame>

## Sei a Posto!

Il tuo negozio WooCommerce è ora integrato con Dodo Payments! I clienti possono selezionare Dodo Payments al checkout per accedere a tutti i metodi di pagamento supportati.

<Frame>
  <img src="https://mintcdn.com/dodopayments/rsanoiHs7RZfcFW7/images/woocommerce/19.webp?fit=max&auto=format&n=rsanoiHs7RZfcFW7&q=85&s=958daded5beb84eb4e54e02c267d7ecc" alt="Opzione di checkout Dodo Payments in WooCommerce" width="1864" height="913" data-path="images/woocommerce/19.webp" />
</Frame>

Quando i clienti scelgono Dodo Payments, verranno reindirizzati senza soluzione di continuità alla pagina di checkout di Dodo Payments per completare la loro transazione.

<Frame>
  <img src="https://mintcdn.com/dodopayments/rsanoiHs7RZfcFW7/images/woocommerce/20.webp?fit=max&auto=format&n=rsanoiHs7RZfcFW7&q=85&s=a78bd2b289d9cc8df8d36da9db540c14" alt="Pagina di pagamento Dodo Payments" width="1887" height="1006" data-path="images/woocommerce/20.webp" />
</Frame>

## Caratteristiche Chiave

* **Esperienza di Checkout Senza Soluzione di Continuità**: Reindirizza i clienti a una pagina di checkout sicura e ottimizzata
* **Molteplici Metodi di Pagamento**: Supporto per varie opzioni di pagamento locali e internazionali
* **Aggiornamenti di Stato in Tempo Reale**: Sincronizzazione istantanea dello stato degli ordini tramite webhook
* **Registri di Transazione Dettagliati**: Storia dei pagamenti completa nel tuo dashboard WooCommerce
* **Supporto Multi-Valuta**: Accetta pagamenti in più valute

## Risoluzione dei Problemi

### Problemi Comuni

1. **Errori di Elaborazione dei Pagamenti**
   * Verifica che le chiavi API siano configurate correttamente
   * Assicurati che l'URL del webhook sia impostato correttamente
   * Controlla che il tuo certificato SSL sia valido

2. **Problemi di Sincronizzazione del Webhook**
   * Conferma che la chiave di firma del webhook corrisponda
   * Rivedi i log del server per eventuali errori
   * Verifica che il tuo server possa ricevere richieste webhook in arrivo

### Risorse di Supporto

Per ulteriore assistenza:

* Contattaci all'indirizzo [support@dodopayments.com](mailto:support@dodopayments.com)
* Consulta la nostra [documentazione completa](https://docs.dodopayments.com)

## Migliori Pratiche di Manutenzione

1. Aggiorna regolarmente il plugin per patch di sicurezza e nuove funzionalità
2. Testa tutti i flussi di pagamento in modalità sandbox prima di elaborare transazioni live
3. Mantieni WordPress e WooCommerce aggiornati all'ultima versione
4. Implementa backup regolari del sito
5. Monitora i log delle transazioni per eventuali attività insolite
6. Conserva le chiavi API in modo sicuro e non condividerle mai pubblicamente
