Skip to main content
I prodotti sono la base di Dodo Payments. Che tu venda un download una tantum, un abbonamento ricorrente o un accesso basato sull’utilizzo, inizi creando un prodotto. Ogni prodotto definisce come viene prezzato, presentato al checkout e evaso dopo l’acquisto.

One‑Time

Addebita una sola volta per l’accesso a vita o per una singola consegna.

Subscriptions

Fattura secondo un calendario con prove gratuite, ratei e componenti aggiuntivi.

Usage‑Based

Misura il consumo e fattura in base all’uso effettivo.

​
Crea un prodotto

Puoi creare prodotti dal dashboard o tramite API. Scegli il modello di prezzo in anticipo, Una tantum, Abbonamento o Basato sull’uso e poi configura i dettagli. Il modello di prezzo non può essere cambiato in seguito; crea un nuovo prodotto se hai bisogno di un modello diverso.
1

Name & description

Fornisci un titolo chiaro e una descrizione concisa orientata al valore. Le descrizioni supportano Markdown.
Mantieni la prima frase rivolta al cliente e orientata al risultato; apparirà in primo piano nel checkout.
Prodotti
2

Pricing model & price

Seleziona il modello di prezzo:
  • Una tantum: Prezzo fisso pagato una sola volta.
  • Abbonamento: Prezzo ricorrente con intervallo e prova opzionale.
  • Basato sull’uso: Prezzo derivato da eventi misurati.
Poi imposta il prezzo:
  • Prezzo: importo base e valuta. Puoi impostare il prezzo base in qualsiasi valuta che Dodo Payments può addebitare, non solo USD. Usa il selettore di valute con ricerca per trovare una valuta; USD, GBP, EUR e INR sono fissate in cima all’elenco.
  • Sconto (%): sconto inline facoltativo mostrato nel checkout e nelle fatture.
  • Per gli abbonamenti, imposta Ripeti ogni (ad es., 1 mese o 1 anno), Giorni di prova e un Importo della prova facoltativo per una prova a pagamento. Il prezzo dell’abbonamento deve essere almeno $1 (o l’equivalente nella valuta scelta); gli importi inferiori a questo minimo non sono supportati e l’abbonamento non funzionerà.
I clienti al di fuori della tua valuta di base vengono comunque addebitati tramite Adaptive Currency, così puoi definire i prezzi nella valuta più adatta al tuo mercato senza modificare il modo in cui vengono addebitati gli acquirenti.
Vuoi un prezzo fisso per valuta o paese invece di una conversione FX in tempo reale? Imposta un pricing_mode sul prodotto e allega regole di Localized Pricing, ad esempio €9.99 in EUR o ₹999 in India.
La modifica del prezzo influisce solo sui nuovi acquisti. Gli abbonamenti esistenti seguono le regole di modifica del piano.
3

Product media

Carica immagini per mostrare il prodotto nel checkout e nelle fatture. Sono supportati i formati PNG/JPG/WebP fino a 3 MB. Puoi riordinarle o sostituirle in qualsiasi momento.
4

Automated entitlements (Under Advanced Settings)

Associa il fulfillment che si attiva automaticamente dopo il pagamento:
  • License Keys: emetti e convalida chiavi univoche
  • File Downloads: concedi accesso sicuro ai file
  • Custom: attiva la tua logica di entitlement tramite webhook
Aggiungi o rimuovi i vantaggi man mano che la tua offerta si evolve. Gli abbonati esistenti ottengono o perdono l’accesso di conseguenza.

​
Varianti e opzioni di prezzo

Invece di creare varianti all’interno di un unico prodotto, crea prodotti separati per ogni opzione di prezzo (ad esempio, Mensile e Annuale). Raggruppali quindi in una Product Collection per presentare tutte le opzioni in un unico checkout e consentire il cambio di piano nel Customer Portal.
Product Collections

​
Perché questo approccio?

  • Modelli di prezzo chiari: ogni prodotto ha un unico modello di prezzo ben definito (una tantum, abbonamento o basato sull’utilizzo)
  • API prevedibili: integrazioni più semplici senza logica delle varianti annidata
  • Reporting più semplice: monitora ricavi e metriche per prodotto senza aggregare le varianti
  • Checkout flessibile: mostra più prodotti affiancati, consentendo ai clienti di confrontarli e scegliere

​
Come funzionano le Product Collections

  1. Crea i prodotti: configura prodotti individuali per ogni piano (ad es., Starter Mensile, Starter Annuale, Pro Mensile, Pro Annuale)
  2. Raggruppali in una collection: aggiungi i prodotti correlati a una Product Collection
  3. Checkout unificato: i clienti vedono tutte le opzioni in un unico checkout e selezionano il piano preferito
  4. Cambio di piano: i clienti possono eseguire l’upgrade o il downgrade tra prodotti della stessa collection tramite il Customer Portal

Product Collections

Raggruppa i prodotti correlati per offrire esperienze di checkout unificate e percorsi di upgrade/downgrade senza interruzioni.

​
Gestione dei prodotti

Puoi gestire i prodotti tramite dashboard o programmaticamente tramite API. L’API offre il controllo completo sulla creazione, l’aggiornamento, il recupero, il caricamento delle immagini e l’archiviazione dei prodotti.

​
Gestione tramite dashboard

  • Aggiorna: modifica nome, descrizione, immagini, prezzo, campi e vantaggi in qualsiasi momento (il modello di prezzo è immutabile).
  • Archivia: nascondi un prodotto dai nuovi acquisti senza interrompere i clienti esistenti. Puoi annullare l’archiviazione in un secondo momento.
  • Bozze: un prodotto in lavorazione viene salvato come bozza, così puoi riprenderlo in seguito. Le bozze vengono conservate separatamente per la modalità di test e la modalità live, quindi un prodotto non terminato in una modalità non confluisce mai nell’altra. Usa Clear Draft per eliminarla e ricominciare da capo.
Le pagine dei moduli dei prodotti e delle collection includono pulsanti di azione nell’intestazione, così puoi salvare senza scorrere fino in fondo a un modulo lungo.

​
Gestione tramite API

Le istruzioni seguenti consentono di creare, aggiornare, gestire e recuperare i prodotti, incluso il caricamento delle immagini.
Un prodotto può essere un articolo una tantum o un servizio basato su abbonamento. Per creare un nuovo prodotto, invia una richiesta POST all’endpoint /products con dettagli quali nome, descrizione, prezzo, valuta e indicazione che specifichi se si tratta di un prodotto ricorrente.Per i prodotti ricorrenti, imposta l’oggetto price su un prezzo ricorrente (type: recurring_price) e specifica payment_frequency_interval e subscription_period_interval (Day, Week, Month o Year) insieme ai conteggi corrispondenti.

Create Product API

Consulta la struttura dettagliata della richiesta e della risposta nella documentazione dell’API Create Product.
Per modificare un prodotto esistente, invia una richiesta PATCH all’endpoint /products/{product_id}. Puoi aggiornare proprietà quali nome, prezzo e descrizione mantenendo invariati gli altri dettagli.Assicurati che product_id nell’endpoint corrisponda a un prodotto esistente.

Update Product API

Consulta la struttura dettagliata della richiesta e della risposta nella documentazione dell’API Update Product.
Puoi recuperare un elenco dei prodotti archiviati nel tuo account utilizzando una richiesta GET all’endpoint /products. In questo modo puoi recuperare i dettagli dei prodotti, inclusi quelli attivi e archiviati.

Retrieve Products API

Consulta la struttura dettagliata della richiesta e della risposta nella documentazione dell’API Retrieve Products.
Puoi associare un’immagine a un prodotto caricandola su AWS S3 tramite un URL pre-firmato fornito dall’API. Innanzitutto, richiedi un URL di caricamento dell’immagine dall’endpoint /products/{product_id}/images, quindi utilizza l’URL fornito per caricare l’immagine entro 60 secondi.
L’URL pre-firmato scade dopo 60 secondi, quindi l’immagine deve essere caricata entro questo intervallo.
Dopo aver ricevuto l’URL pre-firmato dall’API, carica l’immagine utilizzando il metodo PUT. Questo garantisce un accesso sicuro e temporaneo ad AWS S3 per il caricamento dell’immagine.Librerie supportate per il caricamento su S3:
  • Node.js: axios, node-fetch
  • Python: requests, boto3
  • Go: net/http
  • PHP: GuzzleHttp
  • Ruby: rest-client
Se il caricamento ha esito positivo, AWS S3 restituirà uno stato 200 OK, a indicare che l’immagine è stata archiviata correttamente.

Upload Product Image API

Consulta la struttura dettagliata della richiesta e della risposta nella documentazione dell’API Upload Product Image.
Se non desideri più visualizzare o utilizzare un prodotto, puoi archiviarlo utilizzando una richiesta DELETE all’endpoint /products/{id}. Questa azione nasconde il prodotto, ma non lo elimina definitivamente.

Archive Product API

Consulta la struttura dettagliata della richiesta e della risposta nella documentazione dell’API Archive Product.
Se devi ripristinare un prodotto archiviato, invia una richiesta POST all’endpoint /products/{product_id}/unarchive. Il prodotto verrà riattivato e sarà nuovamente disponibile per l’utilizzo.

Unarchive Product API

Consulta la struttura dettagliata della richiesta e della risposta nella documentazione dell’API Unarchive Product.
Crea flussi di pagamento o abbonamento dai prodotti e gestisci automaticamente il fulfillment tramite vantaggi e webhook.

Checkout Sessions

Crea sessioni di checkout per acquisti una tantum o in abbonamento.

Payment Webhooks

Reagisci agli eventi del ciclo di vita del pagamento.

Subscription Webhooks

Gestisci gli eventi di creazione, rinnovo e annullamento degli abbonamenti.

​
Best practice

  • Inizia dalla chiarezza: crea prodotti separati per ogni opzione di prezzo (Mensile e Annuale)
  • Utilizza le prove in modo ponderato: combina le prove con l’onboarding per favorire l’attivazione
  • Automatizza il fulfillment: utilizza vantaggi e webhook per effettuare la consegna immediatamente
  • Aggiungi metadati: archivia gli ID del tuo sistema per la riconciliazione
Sei pronto a creare prodotti e iniziare a vendere: una tantum, ricorrenti o in base all’utilizzo.

​
Correlati

Product Analytics

Monitora ricavi, clienti, fidelizzazione, abbonati e MRR per ogni singolo prodotto.

Localized Pricing

Imposta prezzi fissi per valuta o per paese su un prodotto invece di affidarti ai tassi di cambio in tempo reale.
Ultima modifica il 31 luglio 2026