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 prodotto, crea prodotti separati per ogni opzione di prezzo (ad esempio, Mensile e Annuale). Puoi presentare più prodotti affiancati nello stesso checkout e consentire ai clienti di passare da uno all’altro.
Questo mantiene le API prevedibili e semplifica la reportistica. Ogni prodotto ha un singolo modello di prezzo.

​
Gestire i prodotti

Puoi gestire i prodotti tramite il dashboard o programmaticamente tramite API. L’API fornisce il pieno controllo sulla creazione, aggiornamento, recupero, caricamento di immagini e archiviazione dei prodotti.

​
Gestione del dashboard

  • Aggiorna: Modifica nome, descrizione, immagini, prezzo, campi e benefici 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 API

Le seguenti istruzioni ti consentono di creare, aggiornare, gestire e recuperare prodotti, inclusi i caricamenti di immagini.
Un prodotto può essere un articolo una tantum 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 i prodotti ricorrenti, imposta recurring: true e specifica un billing_cycle (daily, weekly, monthly, yearly).

API Crea Prodotto

Visualizza la struttura dettagliata della richiesta e della risposta nella documentazione dell’API Crea 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 il product_id nell’endpoint corrisponda a un prodotto esistente.

API Aggiorna Prodotto

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

API Recupera Prodotti

Visualizza la struttura dettagliata della richiesta e della risposta nella documentazione dell’API Recupera Prodotti.
Puoi associare un’immagine a un prodotto caricandola su AWS S3 utilizzando un URL pre-firmato fornito dall’API. Prima, richiedi un URL di caricamento immagine dall’endpoint /products/{product_id}/images, quindi utilizza l’URL fornito per caricare l’immagine entro 60 secondi.
L’URL pre-firmato scade in 60 secondi, quindi l’immagine deve essere caricata entro quel lasso di tempo.
Una volta ricevuto l’URL pre-firmato 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 successo, AWS S3 restituirà uno stato 200 OK, indicando che l’immagine è stata memorizzata con successo.

API Carica Immagine Prodotto

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

API Archivia Prodotto

Visualizza la struttura dettagliata della richiesta e della risposta nella documentazione dell’API Archivia 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 Ripristina Prodotto

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

​
Migliori pratiche

  • Inizia con chiarezza: Prodotti separati per ogni opzione di prezzo (Mensile vs Annuale)
  • Usa le prove in modo ponderato: Abbina le prove con l’onboarding per guidare l’attivazione
  • Automatizza la soddisfazione: Usa benefici 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 utilizzo.