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

# Pagamenti una tantum

> Vendi beni o servizi digitali a prezzo fisso con un'unica carica anticipata, senza rinnovi.

<Info>
  I pagamenti una tantum ti permettono di vendere accesso a vita, download o servizi ad uso singolo con un unico addebito. Non ci sono rinnovi, regole di prorata o cicli di fatturazione. Solo un'esperienza di acquisto pulita e immediata.
</Info>

<CardGroup cols={2}>
  <Card title="License Keys" icon="code" href="/features/license-keys">
    Rilascia chiavi di licenza uniche dopo l'acquisto.
  </Card>

  <Card title="Digital Delivery" icon="code" href="/features/digital-product-delivery">
    Consegna automaticamente file e contenuti dopo il pagamento.
  </Card>

  <Card title="Payment Webhooks" icon="code" href="/developer-resources/webhooks/intents/payment">
    Reagisci agli eventi di pagamento riuscito/fallito e di ricevuta.
  </Card>

  <Card title="Refunds API" icon="code" href="/api-reference/refunds/post-refunds">
    Crea rimborsi completi o parziali in modo programmato.
  </Card>
</CardGroup>

## Cosa sono i pagamenti una tantum?

I pagamenti una tantum sono acquisti fissi e anticipati - ideali per:

* **Licenze software**: Sblocco a vita o di versioni principali
* **Download digitali**: E-book, modelli, grafiche o plugin
* **Servizi**: Audit, pacchetti di onboarding o consulenze una tantum
* **Corsi e biglietti**: Corsi, workshop o sessioni dal vivo

## Vantaggi principali

* **Checkout semplice**: Nessun rinnovo o logica di ripartizione
* **Evasione istantanea**: Consegna immediata di licenze o file
* **Prezzi flessibili**: Sconti e tasse supportati
* **Sviluppatore‑first**: API chiare per creazione, rimborsi e webhook

## Creazione di prodotti una tantum

Crea prodotti nel tuo dashboard di Dodo Payments, quindi vendili tramite checkout ospitato, link di pagamento o la tua API.

<Frame>
  <img src="https://mintcdn.com/dodopayments/r-ndtvzx3WhKqwER/images/products.png?fit=max&auto=format&n=r-ndtvzx3WhKqwER&q=85&s=fb41221c4f2af4de0155e71de1ac6904" alt="Prodotti a Pagamento Unico" style={{ maxHeight: '500px', width: 'auto' }} width="1911" height="927" data-path="images/products.png" />
</Frame>

### Configurazione del prodotto

Configura i campi nel dashboard per definire come appare e si vende il tuo 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ù precisa per garantire la corretta riscossione delle tasse per regione.
</Tip>

#### Prezzi

* **Tipo di prezzo**: Scegli <b>Pagamento unico</b>
* **Prezzo** (obbligatorio): Carica fissa con valuta
* **Sconto applicabile (%)**: Percentuale di sconto opzionale visualizzata nel checkout e nelle fatture

<Warning>
  La modifica del prezzo del prodotto influisce solo sui nuovi acquisti. I clienti esistenti non sono interessati.
</Warning>

#### Impostazioni avanzate

* **Prezzi inclusivi di tasse**: Visualizza i prezzi inclusivi delle tasse applicabili
* **Genera chiavi di licenza**: Emissione di una chiave unica dopo l'acquisto. Vedi <a href="/features/license-keys">Chiavi di licenza</a>
* **Consegna di prodotti digitali**: Consegna automatica di file o contenuti. Vedi <a href="/features/digital-product-delivery">Consegna di prodotti digitali</a>
* **Metadati**: Allegare coppie chiave-valore personalizzate per tagging interno o integrazioni. Vedi <a href="/api-reference/metadata">Metadati</a>

<Tip>
  Usa i metadati per memorizzare identificatori dal tuo sistema (ad esempio orderId) per riconciliare in seguito eventi e ricevute.
</Tip>

## Gestione API

<AccordionGroup>
  <Accordion title="Create payments">
    Usa `POST /checkouts` per creare addebiti una tantum dai prodotti.

    <Card title="API Reference" icon="code" href="/api-reference/checkout-sessions/create">
      Visualizza l'API per creare pagamenti.
    </Card>
  </Accordion>

  <Accordion title="Refund payments">
    Usa `POST /refunds` per creare rimborsi completi o parziali.

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

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

    <Card title="List Payments" icon="code" href="/api-reference/payments/get-payments">
      Esplora l'API per l'elenco.
    </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">
      Ispeziona gli articoli acquistati per un pagamento.
    </Card>
  </Accordion>

  <Accordion title="Payment webhooks">
    Reagisci ad 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

* **Strumenti basati su licenza**: Sblocca funzionalità con una chiave una tantum
* **Asset digitali**: Temi, modelli, set di icone o media
* **Servizi professionali**: Implementazione o configurazione a tariffa fissa
* **Educazione**: Biglietti per corsi e workshop una tantum

## Esempi di integrazione

### Sessioni di checkout (pagamento unico)

Crea una sessione di checkout con un prodotto una tantum nel carrello:

```typescript theme={null}
const session = await client.checkoutSessions.create({
  product_cart: [
    { product_id: 'prod_one_time', quantity: 1 }
  ]
});
```

## Migliori pratiche

* **Chiarire i deliverables**: Comunica ai compratori esattamente cosa ricevono e come viene consegnato
* **Consegna istantanea**: Utilizza chiavi di licenza o consegna digitale per accesso immediato
* **Traccia con metadati**: Memorizza i tuoi ID per una facile riconciliazione

<Info>
  I pagamenti una tantum sono la strada più veloce per vendere prodotti a prezzo fisso. Parti in modo semplice, verifica la consegna e adatta la tua offerta in base alla conversione e al feedback.
</Info>