Vai al contenuto principale
Le Collezioni di Prodotti ti permettono di raggruppare prodotti correlati (ad es. piani Starter, Pro, Enterprise) sotto un’unica etichetta. Mostra tutte le opzioni in un unico checkout, definisci i percorsi di aggiornamento/diminuzione e offri ai clienti la flessibilità di cambiare piano direttamente dal Portale Clienti.
Screenshot 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

Crea la collezione

Definisci la collezione con un nome e una descrizione opzionale. Carica un’immagine per rappresentare visivamente la collezione nel checkout.
Screenshot del modulo di creazione della Collezione di Prodotti nel dashboard che mostra 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

Aggiungi prodotti alla collezione

Aggiungi prodotti esistenti alla tua collezione. I prodotti possono essere organizzati in gruppi per una migliore struttura.
Screenshot 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 solo a una collezione. Se un prodotto è già in un’altra collezione, dovrai prima rimuoverlo.
3

Configura ordinamento e visibilità

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 nella collezione è automaticamente pre-selezionato come predefinito al checkout. Riordina i prodotti per cambiare quale viene 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
Screenshot della pagina di checkout della Collezione di Prodotti che mostra più prodotti visualizzati
Il checkout della collezione è ideale per le aziende di abbonamento in cui si desidera che i clienti confrontino i piani fianco a fianco 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;
Quando si utilizza product_collection_id, i codici sconto non possono essere applicati durante la creazione della sessione. I clienti possono comunque inserire codici sconto durante il checkout se abilitati.

Integrazione del Portale Clienti

I clienti possono aggiornare o diminuire tra i prodotti all’interno della stessa collezione direttamente dal Portale Clienti.

Azioni di Gestione del Piano

AzioneDescrizioneControllo Mercante
Visualizza Piano CorrenteMostra nome, prezzo e data di rinnovo del prodotto attualeSempre disponibile
Aggiorna PianoPassa a un prodotto di livello superiore nella stessa collezioneConfigurabile (predefinito: consentito)
Diminuisci PianoPassa a un prodotto di livello inferiore nella stessa collezioneConfigurabile (predefinito: consentito)
AnnullaAnnulla completamente l’abbonamentoSempre disponibile
Screenshot dell'interfaccia di cambio piano del portale clienti della Collezione di Prodotti che mostra le azioni di gestione del piano

Regole di Aggiornamento/Diminuzione

  • Aggiornamenti e diminuzioni sono disponibili solo tra prodotti nella stessa collezione
  • La proporzione è applicata in base alle impostazioni del tuo abbonamento
  • Le notifiche email vengono inviate all’azienda per ogni aggiornamento, diminuzione o cancellazione
Screenshot dell'interfaccia di cambio piano del portale clienti della Collezione di Prodotti che mostra le azioni di gestione del piano
I clienti non possono cambiare a prodotti al di fuori della loro collezione attuale. Crea collezioni separate per linee di prodotto distinte.

Impostazioni di Abbonamento

Configura come funzionano abbonamenti e cambi di piano nella tua azienda dalla sezione Impostazioni di Abbonamento nel tuo dashboard.
Screenshot della pagina delle impostazioni di abbonamento che mostra le opzioni Abilita più abbonamenti e Abilita aggiornamenti di abbonamento

Impostazioni disponibili

ImpostazioneDescrizionePredefinito
Abilita più abbonamentiI clienti possono avere più abbonamenti attivi contemporaneamenteAbilitato
Abilita aggiornamenti di abbonamentoI clienti possono aggiornare o diminuire i propri abbonamenti esistenti in qualsiasi momento tramite il Portale ClientiDisabilitato
Le modifiche ai piani tramite il Portale Clienti sono disabilitate per impostazione predefinita. Abilita “Consenti Aggiornamenti di Abbonamento” nelle tue Impostazioni di Abbonamento per consentire ai clienti di aggiornare o diminuire tra i prodotti nella stessa collezione.

Modifiche al Piano di Abbonamento

Scopri di più sui modi di proration e sul comportamento delle modifiche ai piani.

Gestire Collezioni

Le Collezioni di Prodotti vengono create e gestite esclusivamente tramite il dashboard di Dodo Payments.
Creare, aggiornare e eliminare collezioni è disponibile solo tramite il dashboard. L’API fornisce accesso in sola lettura per recuperare i dati delle collezioni per scopi di integrazione.

Operazioni del Dashboard

  • Crea: Configura nuove collezioni con prodotti e gruppi
  • Aggiorna: Modifica nome, descrizione, immagine e organizzazione dei prodotti
  • Riordina: 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 non sono più collegati)
Screenshot del dashboard della Collezione di Prodotti che mostra le operazioni di gestione delle collezioni

Migliori Pratiche

  • Raggruppa logicamente: Organizza i prodotti in base all’intervallo di fatturazione (mensile/annuale) o livello di funzione (starter/pro/enterprise)
  • Ordina strategicamente: Posiziona il piano più popolare o raccomandato per primo, poiché sarà pre-selezionato al checkout
  • Usa nomi chiari: I nomi dei prodotti dovrebbero comunicare chiaramente le differenze di valore
  • Abilita entrambe le direzioni: Consenti sia aggiornamenti che diminuzioni per offrire flessibilità ai clienti
  • Considera la proporzione: Scegli un modo di proporzione che si allinei con il tuo modello di business
  • Testa approfonditamente: Verifica i flussi di checkout e modifica piano in modalità di test prima di andare live
Sei pronto a creare collezioni di prodotti e offrire ai clienti un’esperienza di selezione unificata dei piani.