> ## 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.

# Framer Plugin

> Integra la funzionalità di checkout di Dodo Payments nei tuoi progetti Framer con il nostro potente plugin. Accetta pagamenti con esperienze di checkout personalizzabili.

## Panoramica

Il plugin Dodo Payments per Framer integra senza soluzione di continuità il processamento dei pagamenti nei tuoi siti web Framer. Crea esperienze di checkout personalizzabili con supporto per ambienti di test e produzione.

<Card title="Official Plugin" icon="link" href="https://www.framer.com/marketplace/plugins/dodo-payments">
  Accedi al plugin ufficiale Dodo Payments nel marketplace di Framer.
</Card>

## Caratteristiche

<CardGroup cols={2}>
  <Card title="Hosted or Overlay Checkout" icon="credit-card">
    Scegli un flusso a pagina intera o una sovrapposizione inline che si integri perfettamente con il tuo sito.
  </Card>

  <Card title="Drag-and-Drop Setup" icon="hand-pointer">
    Aggiungi il componente, incolla le tue chiavi, pubblica.
  </Card>

  <Card title="Instant Digital Delivery" icon="envelope">
    Invia link di download sicuri o chiavi di licenza appena il pagamento viene confermato.
  </Card>

  <Card title="Worldwide Coverage" icon="globe">
    Acquiring a livello bancario su sei continenti, con metodi locali già integrati.
  </Card>

  <Card title="Automatic Tax & Invoicing" icon="receipt">
    IVA, GST, imposte sulle vendite e ricevute gestite per ogni ordine.
  </Card>

  <Card title="No-Code Subscriptions" icon="toggle-on">
    Attiva un interruttore per vendere piani di abbonamento per i tuoi prodotti.
  </Card>
</CardGroup>

## Guida all'Impostazione

<Steps>
  <Step title="Generate API Key">
    Visita la [Dodo Payments Dashboard](https://app.dodopayments.com/developer/api-keys) e crea una nuova chiave API.

    <Tabs>
      <Tab title="Live Mode">
        Per l'utilizzo in produzione con elaborazione dei pagamenti reali.
      </Tab>

      <Tab title="Test Mode">
        Perfetto per sviluppo e test senza costi reali.
      </Tab>
    </Tabs>

    <Check>
      Copia la tua chiave API in modo sicuro: ti servirà per il passaggio successivo.
    </Check>
  </Step>

  <Step title="Authenticate Plugin">
    1. Apri il plugin Dodo Payments in Framer
    2. Vai alla pagina di Autenticazione
    3. Incolla la tua chiave API
    4. Seleziona la modalità appropriata (Test o Live)
    5. Fai clic su **Continue** per autenticarti

    <Warning>
      Mantieni al sicuro le tue chiavi API e non condividerle mai pubblicamente.
    </Warning>
  </Step>

  <Step title="Manage Products">
    Dopo l'autenticazione, vedrai la lista dei tuoi prodotti:

    * **Prodotti esistenti**: Visualizzati automaticamente
    * **Nessun prodotto**: Clicca sul pulsante **Più (+)** accanto a 'Prodotti'

    <Info>
      Verrai reindirizzato alla dashboard di Dodo Payments per creare prodotti con prezzi, descrizioni e impostazioni.
    </Info>
  </Step>

  <Step title="Add Buy Buttons">
    1. Seleziona un prodotto dalla tua lista disponibile
    2. Fai clic sul pulsante `Add Buy Button`
    3. Un pulsante di acquisto con il testo `Buy {product_name}` verrà aggiunto alla tua tela

    <Warning>
      Il pulsante Add Buy Button sarà disabilitato se non hai le autorizzazioni corrette per il progetto.
    </Warning>
  </Step>
</Steps>

## Personalizzazione

<Steps>
  <Step title="Select Checkout Experience">
    Scegli l'esperienza di checkout che preferisci:

    * **Overlay (Embedded)**: Il checkout appare come sovrapposizione all'interno del tuo progetto Framer, mantenendo l'utente sul tuo sito.
    * **Hosted**: Gli utenti vengono reindirizzati a una pagina di checkout ospitata da Dodo Payments per un'esperienza semplificata.
  </Step>

  <Step title="Customize Appearance Options">
    Personalizza l'esperienza di checkout con le seguenti impostazioni di aspetto:

    * **Checkout Theme**: Scegli tra temi chiari o scuri per allinearti all'estetica del tuo brand.
    * **Button Label**: Personalizza il testo (es. 'Buy Now', 'Purchase', 'Get Started').
    * **Button Styles**: Regola colori, font, dimensioni e altre proprietà di stile.
    * **Return URL**: Imposta una pagina Framer a cui l'utente tornerà dopo il checkout.
  </Step>
</Steps>

## Risoluzione dei Problemi

<AccordionGroup>
  <Accordion title="Authentication Issues">
    **Problema**: il plugin non si autentica

    **Soluzioni**:

    * Verifica che la tua chiave API sia corretta
    * Assicurati di usare la modalità giusta (Test/Live)
    * Controlla la tua connessione a internet
  </Accordion>

  <Accordion title="Button Creation Issues">
    **Problema**: Add Buy Button è disabilitato

    **Soluzioni**:

    * Verifica di avere le autorizzazioni corrette nel tuo progetto Framer
    * Assicurati di essere autenticato correttamente
    * Prova a ricaricare il plugin
  </Accordion>

  <Accordion title="Product Display Issues">
    **Problema**: i prodotti non vengono visualizzati

    **Soluzioni**:

    * Assicurati di aver creato prodotti nella dashboard di Dodo Payments
    * Controlla che la tua chiave API abbia le autorizzazioni corrette
    * Prova a ri-autenticarti
  </Accordion>
</AccordionGroup>