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

# Prezzi Paga Quanto Vuoi

> Consenti ai clienti di scegliere il proprio prezzo sopra un minimo. Facoltativamente mostra un prezzo suggerito. Ottimizzato per acquisti una tantum.

**Paga Quanto Vuoi (PWYW)** consente ai clienti di decidere quanto pagare—almeno quanto un minimo definito dal commerciante. Aumenta il coinvolgimento, incoraggia il supporto della comunità e fornisce prezzi flessibili per i prodotti digitali.

<Frame>
  <iframe className="w-full aspect-video rounded-md" src="https://www.youtube.com/embed/Lh0Q01b33NY" title="Pay What You Want Pricing | Dodo Payments" frameBorder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowFullScreen />
</Frame>

## Cos'è Paga Quanto Vuoi?

PWYW è un modello di prezzo in cui i clienti impostano il proprio prezzo all'interno dei limiti che definisci. È ideale per:

* **Prodotti e media digitali**: Modelli, e‑book, corsi, plugin
* **Lanci sperimentali**: Accesso anticipato, versioni beta, promozioni a tempo
* **Bundle e extra**: Aggiungi un livello PWYW per aumentare la partecipazione

## Vantaggi Chiave

* **Prezzi guidati dai clienti**: Gli acquirenti scelgono quanto pagare
* **Piano di entrate**: Imposta un minimo per proteggere i margini
* **Aspettative ancorate**: Prezzo suggerito facoltativo per guidare le scelte
* **Checkout senza soluzione di continuità**: Checkout ospitato e ricevute gestite per te
* **Sviluppatore‑first**: API chiare per creazione, rimborsi e webhook

<Warning>
  PWYW è disponibile solo per prodotti **Single Payment** (una tantum).
</Warning>

## Creare Paga Quanto Vuoi

Crea un prodotto una tantum e abilita PWYW nel tuo dashboard di Dodo Payments. Le sezioni seguenti mappano direttamente al modulo di creazione.

### Creazione del prodotto

#### Dettagli del prodotto

* **Nome del prodotto** (obbligatorio): Nome visualizzato nel checkout e nelle fatture
* **Descrizione del prodotto** (obbligatoria): Dichiarazione di valore chiara che i clienti vedono prima di pagare
* **Immagine del prodotto** (obbligatoria): PNG/JPG/WebP fino a 3 MB
* **Marca**: Associa il prodotto a un marchio specifico per la tematizzazione e le email
* **Categoria fiscale** (obbligatoria): Scegli la categoria corretta per determinare le regole fiscali

<Tip>
  Scegli la categoria fiscale più accurata per garantire una corretta riscossione delle tasse per regione.
</Tip>

#### Prezzi

* **Tipo di prezzo**: Scegli <b>Pagamento Singolo</b>
* **Paga Quanto Vuoi** (attiva/disattiva): Abilita per consentire agli acquirenti di scegliere l'importo
* **Prezzo minimo** (obbligatorio): Importo più basso che un cliente può pagare
* **Prezzo suggerito** (facoltativo): Importo raccomandato mostrato sulla pagina del prodotto

<Tip>
  Utilizza i metadata per memorizzare gli identificativi del tuo sistema (ad es. orderId) in modo da poter riconciliare eventi e ricevute in seguito.
</Tip>

## Gestione API

<AccordionGroup>
  <Accordion title="Create checkout sessions (PWYW)">
    Usa `POST /checkout-sessions/create` per creare sessioni di checkout una tantum dai prodotti. Il checkout chiederà agli acquirenti di inserire un importo che soddisfi il tuo minimo PWYW.

    <Card title="API Reference" icon="code" href="/api-reference/checkout-sessions/create">
      Consulta l'API di creazione delle sessioni di checkout.
    </Card>
  </Accordion>

  <Accordion title="Refund payments">
    Usa `POST /refunds` per creare rimborsi totali o parziali. I clienti ricevono il rimborso dell'esatto importo pagato.

    <Card title="API Reference" icon="code" href="/api-reference/refunds/post-refunds">
      Scopri come rimborsare un pagamento.
    </Card>
  </Accordion>

  <Accordion title="List and retrieve">
    Usa `GET /payments` per elencare i pagamenti e `GET /payments/{payment_id}` per recuperarne uno. Recupera le righe di importo con `GET /payments/{payment_id}/line-items`.

    <Card title="List Payments" icon="code" href="/api-reference/payments/get-payments">
      Esplora l'API di elencazione.
    </Card>

    <Card title="Get Payment Detail" icon="code" href="/api-reference/payments/get-payments-1">
      Consulta l'API di recupero.
    </Card>

    <Card title="Retrieve Line Items" icon="code" href="/api-reference/payments/retrieve-line-items">
      Esamina gli articoli acquistati per un pagamento.
    </Card>
  </Accordion>

  <Accordion title="Payment webhooks">
    Reagisci a eventi come payment.succeeded o payment.failed nel tuo backend.

    <Card title="Webhook Guide" icon="code" href="/developer-resources/webhooks/intents/payment">
      Gestisci gli eventi del ciclo di vita del pagamento.
    </Card>
  </Accordion>
</AccordionGroup>

## Casi d'uso comuni

* **Asset digitali**: Temi, modelli, set di icone, media o plugin
* **Contenuti e istruzione**: E‑book, corsi, workshop con prezzi per sostenitori
* **Comunità e donazioni**: Raccolte fondi, sponsorizzazioni open‑source, supporto ai creatori
* **Esperimenti di lancio**: Accesso beta e campagne a tempo per valutare la domanda

## Esempi di integrazione

### Sessioni di checkout (pagamento singolo, PWYW)

Aggiungi un prodotto PWYW al carrello. Il checkout raccoglie l'importo dell'acquirente (rispettando il tuo minimo) — non sono richiesti campi extra.

```typescript theme={null}
const session = await client.checkoutSessions.create({
  product_cart: [
    { product_id: 'prod_pwyw_demo', quantity: 1 }
  ],
  return_url: 'https://yoursite.com/checkout/success'
});
```

## Migliori pratiche

* **Scegli un minimo sensato**: Copri i costi mantenendo la partecipazione facile
* **Utilizza un prezzo suggerito**: Ancorare le aspettative per migliorare il valore medio dell'ordine
* **Spiega chiaramente il valore**: Dì agli acquirenti cosa sblocca il loro contributo
* **Testa campagne A/B**: Offerte a tempo e sperimenta con i messaggi
* **Monitora la distribuzione**: Tieni traccia degli importi pagati per affinare il minimo e il prezzo suggerito

<Info>
  PWYW è un modo flessibile per coinvolgere più clienti mantenendo un livello minimo di ricavi. Parti in modo semplice, testa approfonditamente e itera in base a conversione, distribuzione dei contributi e tassi di rimborso.
</Info>