Vai al contenuto principale
Le Collezioni di Prodotti ti consentono di raggruppare prodotti correlati (ad esempio i piani Starter, Pro, Enterprise) sotto un unico ombrello. Mostra tutte le opzioni in un unico checkout, definisci percorsi di upgrade/downgrade e offri ai clienti la flessibilità di cambiare piano direttamente dal Portale Cliente.
Schermata della pagina di checkout della Collezione di Prodotti che mostra più prodotti visualizzati

Punti Salienti

  • Struttura basata su collezioni: Raggruppa prodotti correlati (piani, livelli, opzioni di prezzo) sotto un’unica collezione per una gestione organizzata.
  • Una collezione, molti prodotti: Includi più prodotti come Starter, Pro, Lifetime, ecc., ciascuno con il proprio modello di pricing.
  • Esperienza di checkout dinamica: Mostra tutti i prodotti di una collezione in un’unica vista di checkout, consentendo ai clienti di scegliere il piano preferito.
  • Controllo a livello di mercante: Abilita, disabilita e riordina prodotti all’interno di ciascuna collezione. Il primo prodotto è automaticamente pre-selezionato al checkout.
  • Consapevolezza del ciclo di vita: Permetti ai clienti di aggiornare o diminuire tra i prodotti nella stessa collezione tramite il Portale Clienti.

Creare una Collezione di Prodotti

Le Collezioni di Prodotti vengono create e gestite dal dashboard o tramite API. Ogni collezione funge da contenitore per prodotti correlati.
1

Create the collection

Definisci la collezione con un nome e una descrizione facoltativa. Carica un’immagine per rappresentare visivamente la collezione nel checkout.
Schermata del modulo di creazione della Collezione di Prodotti nel dashboard con campi per nome, descrizione e caricamento immagine
Campi della collezione:
  • Nome (obbligatorio): Nome visualizzato per la collezione (ad es. “Piani SaaS”, “Livelli di Licenza”)
  • Descrizione (opzionale): Breve spiegazione mostrata nel checkout
  • Immagine (opzionale): Branding visivo per la collezione
2

Add products to the collection

Aggiungi prodotti esistenti alla tua collezione. I prodotti possono essere organizzati in gruppi per una struttura migliore.
Schermata della pagina dei prodotti della Collezione di Prodotti che mostra un elenco di prodotti e la possibilità di aggiungerli alla collezione
Organizzazione dei prodotti:
  • Gruppi: Organizza opzionalmente i prodotti in gruppi nominati (ad es. “Piani Mensili”, “Piani Annuali”)
  • Prodotti non raggruppati: I prodotti senza un gruppo appaiono a livello di collezione.
  • Ordinamento: Trascina e rilascia per impostare l’ordine di visualizzazione.
Ogni prodotto può appartenere a una sola collezione. Se un prodotto è già in un’altra collezione, dovrai prima rimuoverlo.
3

Configure ordering and visibility

Controlla l’ordine di visualizzazione e la visibilità dei prodotti all’interno della collezione.Opzioni di configurazione:
  • Stato del prodotto: Abilita o disabilita singoli prodotti all’interno della collezione
  • Ordine di visualizzazione: Trascina e rilascia per impostare la sequenza in cui i prodotti appaiono nel checkout
Il primo prodotto della collezione viene automaticamente pre-selezionato come predefinito al checkout. Riorganizza i prodotti per cambiare quello selezionato di default.

Checkout della Collezione

Le collezioni abilitano un’esperienza di checkout unificata dove i clienti possono visualizzare e selezionare tutti i prodotti disponibili in un unico luogo.

Tipi di Checkout

TipoDescrizioneCaso d’uso
Checkout CollezioneMostra tutti i prodotti attivi all’interno di una collezioneSelezione del piano di abbonamento, prezzi a livelli
Checkout Prodotto SingoloMostra solo un prodotto specificoAcquisto diretto, link promozionali

Esperienza di Checkout della Collezione

Quando si utilizza un checkout della collezione:
  1. Tutti i prodotti attivi mostrati: I clienti vedono ogni prodotto abilitato nella collezione
  2. Primo prodotto pre-selezionato: Il primo prodotto nell’ordine di collezione è automaticamente selezionato
  3. Dettagli del prodotto mostrati: Ogni prodotto mostra il proprio nome, descrizione e prezzo
  4. Selezione singola: Il cliente seleziona un prodotto da acquistare
  5. Flusso standard continua: Dopo la selezione, il checkout procede con la tarifazion e le impostazioni di fatturazione del prodotto scelto
Schermata della pagina di checkout della Collezione di Prodotti che mostra più prodotti visualizzati
Il checkout per collezioni è ideale per le attività in abbonamento dove vuoi che i clienti confrontino i piani affiancati prima di acquistare.

Integrazione API

Crea una sessione di checkout per una collezione:
const session = await client.checkoutSessions.create({
  product_collection_id: 'pdc_abc123',
  product_cart: [], // Required: pass an empty array for collection checkout
  return_url: 'https://yoursite.com/return'
});

// Redirect customer to the checkout
window.location.href = session.url;
When using product_collection_id, discount codes cannot be applied at session creation. Customers can still enter discount codes during checkout if enabled.

Integrazione del Portale Clienti

I clienti possono aggiornare o diminuire tra i prodotti all’interno della stessa collezione direttamente dal Portale Clienti.
Hai già prodotti in abbonamento? Aggiungili semplicemente a una Collezione di Prodotti per attivare i flussi di upgrade/downgrade nel Portale Cliente. Non c’è bisogno di ricreare i tuoi prodotti.

Azioni di gestione del piano

AzioneDescrizioneControllo del commerciante
Visualizza il piano attualeMostra il nome del prodotto corrente, il prezzo e la data di rinnovoSempre disponibile
Effettua un upgrade del pianoPassa a un prodotto di livello superiore nella stessa collezioneConfigurabile (predefinito: consentito)
Effettua un downgrade del pianoPassa a un prodotto di livello inferiore nella stessa collezioneConfigurabile (predefinito: consentito)
AnnullaAnnulla completamente l’abbonamentoSempre disponibile
Schermata dell'interfaccia di modifica del piano nel portale cliente della Collezione di Prodotti che mostra le azioni di gestione del piano

Regole di upgrade/downgrade

  • Upgrade e downgrade sono disponibili solo tra prodotti all’interno della stessa collezione
  • La rateizzazione viene applicata in base alle impostazioni dell’abbonamento
  • Vengono inviate notifiche email all’azienda a ogni upgrade, downgrade o cancellazione
Schermata dell'interfaccia di modifica del piano nel portale cliente della Collezione di Prodotti che mostra le azioni di gestione del piano
I clienti non possono passare a prodotti al di fuori della loro collezione attuale. Crea collezioni separate per linee di prodotti distinte.

Impostazioni delle sottoscrizioni

Configura il funzionamento degli abbonamenti e delle modifiche ai piani per la tua attività dalla sezione Impostazioni delle sottoscrizioni nel dashboard.
Schermata della pagina delle impostazioni delle sottoscrizioni che mostra i toggle Consenti più sottoscrizioni e Consenti aggiornamenti di sottoscrizione

Impostazioni disponibili

ImpostazioneDescrizionePredefinito
Consenti più sottoscrizioniI clienti possono avere più di un abbonamento attivo contemporaneamenteAbilitato
Consenti aggiornamenti di sottoscrizioneI clienti possono upgrade o downgrade dei loro abbonamenti esistenti in qualsiasi momento tramite il Portale ClienteDisabilitato
Le modifiche ai piani tramite il Portale Cliente sono disabilitate di default. Abilita “Consenti aggiornamenti di sottoscrizione” nelle Impostazioni delle sottoscrizioni per permettere ai clienti di upgrade o downgrade tra i prodotti della stessa collezione.

Subscription Plan Changes

Learn more about proration modes and plan change behavior.

Gestione delle collezioni

Le Collezioni di Prodotti vengono create e gestite esclusivamente tramite il dashboard di Dodo Payments.
La creazione, modifica e eliminazione delle collezioni è disponibile solo tramite il dashboard. L’API fornisce accesso in sola lettura per recuperare i dati delle collezioni a scopo di integrazione.

Operazioni nel dashboard

  • Crea: Configura nuove collezioni con prodotti e gruppi
  • Aggiorna: Modifica nome, descrizione, immagine e organizzazione dei prodotti
  • Riorganizza: Trascina e rilascia per cambiare l’ordine di visualizzazione dei prodotti
  • Abilita/Disabilita prodotti: Controlla quali prodotti appaiono nel checkout
  • Elimina: Rimuovi una collezione (i prodotti rimangono ma vengono scollegati)
Schermata del dashboard della Collezione di Prodotti che mostra le operazioni di gestione della collezione

Migliori pratiche

  • Raggruppa logicamente: Organizza i prodotti per intervallo di fatturazione (mensile/annuale) o livello di funzionalità (starter/pro/enterprise)
  • Ordina strategicamente: Posiziona il piano più popolare o consigliato per primo, poiché verrà pre-selezionato al checkout
  • Usa nomi chiari: I nomi dei prodotti devono comunicare chiaramente le differenze di valore
  • Abilita entrambe le direzioni: Consenti sia gli upgrade che i downgrade per offrire flessibilità ai clienti
  • Considera la rateizzazione: Scegli una modalità di rateizzazione che si allinei con il tuo modello di business
  • Testa accuratamente: Verifica i flussi di checkout e di modifica del piano in modalità test prima di andare live
Sei pronto per creare collezioni di prodotti e offrire ai clienti un’esperienza di selezione del piano unificata.