Vai al contenuto principale
I prodotti sono la base di Dodo Payments. Che tu venda un download una tantum, un abbonamento ricorrente o accesso basato sull’uso, inizi creando un prodotto. Ogni prodotto definisce come viene prezzato, presentato al checkout e soddisfatto dopo l’acquisto.

Una tantum

Addebita una sola volta per accesso a vita o un singolo prodotto.

Abbonamenti

Fattura secondo un programma con prove, proration e add-on.

Basato sull'uso

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

Nome e descrizione

Fornisci un titolo chiaro e una descrizione concisa orientata al valore. Il Markdown è supportato nelle descrizioni.
Mantieni la prima frase orientata al cliente e focalizzata sui risultati; appare in modo prominente al checkout.
Prodotti
2

Modello di prezzo e prezzo

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.
  • Sconto (%): Sconto inline opzionale mostrato al checkout e nelle fatture.
  • Per gli abbonamenti, imposta Ripeti ogni (ad es., 1 mese o 1 anno) e Giorni di prova se necessario.
Cambiare il prezzo influisce solo sui nuovi acquisti. Gli abbonamenti esistenti seguono le regole di cambio piano.
3

Media del prodotto

Carica immagini per mostrare il prodotto al checkout e nelle fatture. Supportati PNG/JPG/WebP fino a 3 MB. Riordina o sostituisci in qualsiasi momento.
4

Diritti automatizzati (Sotto Impostazioni avanzate)

Allega soddisfazione che si attiva automaticamente dopo il pagamento:
  • Chiavi di licenza: Emissione e validazione di chiavi uniche
  • Download di file: Concedi accesso sicuro ai file
  • Personalizzato: Attiva la tua logica di diritto tramite webhook
Aggiungi o rimuovi benefici man mano che la tua offerta evolve. Gli abbonati esistenti guadagnano o perdono accesso di conseguenza.

​
Varianti e opzioni di prezzo

Invece di varianti sotto un unico prodotto, crea prodotti separati per ciascuna opzione di prezzo (ad esempio, Mensile e Annuale). Raggruppali in una Collezione di Prodotti per presentare tutte le opzioni in un unico checkout e abilitare il passaggio di piano nel Portale Clienti.
Collezioni di Prodotti

​
Perché questo approccio?

  • Modelli di prezzo chiari: Ogni prodotto ha un singolo modello di prezzo ben definito (una tantum, abbonamento o basato sull’uso)
  • API prevedibili: Integrazioni più semplici senza logica delle varianti annidate
  • Reportistica più semplice: Traccia il fatturato e le metriche per prodotto senza aggregazione delle varianti
  • Checkout flessibile: Mostra più prodotti affiancati, consentendo ai clienti di confrontare e scegliere

​
Come funzionano le Collezioni di Prodotti

  1. Crea prodotti: Configura prodotti individuali per ciascun piano (ad es., Starter Mensile, Starter Annuale, Pro Mensile, Pro Annuale)
  2. Raggruppa in una collezione: Aggiungi prodotti correlati a una Collezione di Prodotti
  3. Checkout unificato: I clienti vedono tutte le opzioni in un unico checkout e selezionano il piano preferito
  4. Cambio piano: I clienti possono aggiornare o ridurre il piano tra i prodotti nella stessa collezione tramite il Portale Clienti

Collezioni di Prodotti

Raggruppa prodotti correlati per esperienze di checkout unificate e percorsi di aggiornamento/riduzione senza soluzione di continuità.

​
Gestione dei prodotti

Puoi gestire i prodotti tramite la dashboard o programmaticamente tramite API. L’API fornisce il pieno controllo sulla creazione, aggiornamento, recupero, caricamento delle immagini e 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 da nuovi acquisti senza interrompere i clienti esistenti. Puoi ripristinarlo in seguito.

​
Gestione tramite API

Le seguenti istruzioni ti consentono di creare, aggiornare, gestire e recuperare prodotti, inclusa la possibilità di caricare immagini.
Un prodotto può essere un articolo unico o un servizio basato su abbonamento. Per creare un nuovo prodotto, invia una POST richiesta all’endpoint /products con dettagli come nome, descrizione, prezzo, valuta e se si tratta di un prodotto ricorrente.Per prodotti ricorrenti, imposta recurring: true e specifica un billing_cycle (daily, weekly, monthly, yearly).

API Creazione Prodotto

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

API Aggiornamento Prodotto

Visualizza la struttura dettagliata della richiesta e della risposta nella documentazione dell’API Aggiornamento Prodotto.
Puoi recuperare un elenco di prodotti memorizzati nel tuo account utilizzando una GET richiesta all’endpoint /products. Questo ti consente di recuperare dettagli sui prodotti, inclusi i prodotti attivi e archiviati.

API Recupero Prodotti

Visualizza la struttura dettagliata della richiesta e della risposta nella documentazione dell’API Recupero Prodotti.
Puoi associare un’immagine a un prodotto caricandola su AWS S3 utilizzando un URL prefirmato fornito dall’API. Innanzitutto, richiedi un URL di caricamento di immagini dall’endpoint /products/{product_id}/images, quindi utilizza l’URL fornito per caricare l’immagine entro 60 secondi.
L’URL prefirmato scade in 60 secondi, quindi l’immagine deve essere caricata entro quel lasso di tempo.
Una volta ricevuto l’URL prefirmato dall’API, carica l’immagine utilizzando il metodo PUT. Questo garantisce 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, indicando che l’immagine è stata memorizzata con successo.

API Caricamento Immagine Prodotto

Visualizza la struttura dettagliata della richiesta e della risposta nella documentazione dell’API Caricamento Immagine Prodotto.
Se non desideri più visualizzare o utilizzare un prodotto, puoi archiviarlo utilizzando una POST richiesta all’endpoint /products/{product_id}/archive. Questa operazione nasconde il prodotto ma non lo elimina permanentemente.

API Archiviazione Prodotto

Visualizza la struttura dettagliata della richiesta e della risposta nella documentazione dell’API Archiviazione Prodotto.
Se hai bisogno di ripristinare un prodotto archiviato, invia una POST richiesta all’endpoint /products/{product_id}/unarchive. Questo riattiverà il prodotto e lo renderà nuovamente disponibile per l’uso.

API Ripristino Prodotto

Visualizza la struttura dettagliata della richiesta e della risposta nella documentazione dell’API Ripristino Prodotto.

​
Migliori pratiche

  • Inizia con chiarezza: Prodotti separati per ciascuna opzione di prezzo (Mensile vs Annuale)
  • Usa prove in modo riflessivo: Associa le prove con l’onboarding per stimolare l’attivazione
  • Automatizza la soddisfazione: Usa vantaggi e webhook per consegnare istantaneamente
  • Tagga con metadati: Memorizza i tuoi ID di sistema per la riconciliazione
Sei pronto per creare prodotti e iniziare a vendere - una tantum, ricorrenti o per uso.