Skip to main content
Il Customer Portal è un sito ospitato in cui i tuoi clienti gestiscono i propri abbonamenti, visualizzano e scaricano le fatture e recuperano le chiavi di licenza senza contattare il supporto.

Create Portal Session (API)

Crea un link al portale per un cliente, valido per 24 ore.

Subscriptions

Piani ricorrenti, upgrade, downgrade e componenti aggiuntivi.
Customer Portal rinnovato con abbonamenti attivi, metodi di pagamento e cronologia di fatturazione

Che cos’è il Customer Portal?

Il portale è un sito self-service, personalizzato con il nome della tua attività, in cui i clienti possono:
  • Accedere alla cronologia di fatturazione: visualizzare i pagamenti passati e scaricare le fatture.
  • Gestire gli abbonamenti: visualizzare i dettagli dell’abbonamento, metterlo in pausa e riprenderlo, nonché annullarlo immediatamente o alla prossima data di fatturazione, in base alle tue impostazioni.
  • Aggiornare i metodi di pagamento: modificare il metodo di pagamento di un abbonamento o riattivare un abbonamento sospeso.
  • Recuperare le chiavi di licenza: visualizzare le chiavi di licenza associate ai propri acquisti.
  • Tornare alla tua app: quando passi un return_url, il portale mostra un link per tornare alla tua attività. Su dispositivi mobili, una freccia indietro nell’intestazione riporta alla panoramica del portale.
Se blocchi un cliente, il suo portale diventa di sola lettura. Il cliente può comunque accedere e visualizzare fatture, abbonamenti e chiavi di licenza, ma non può annullare, mettere in pausa o riprendere un abbonamento, cambiare piano o aggiornare un metodo di pagamento. Il profilo del portale restituisce read_only: true, in modo che un’integrazione personalizzata possa disabilitare i propri controlli.

Vantaggi principali

  • Minore volume di richieste al supporto: i clienti gestiscono autonomamente le richieste di fatturazione più comuni.
  • Accesso più rapido: i clienti ricevono fatture e chiavi di licenza non appena accedono.
  • Minore rischio di abbandono: i clienti visualizzano le date di rinnovo e i dettagli del piano prima dell’addebito.
  • Link firmati con scadenza: ogni link di accesso è firmato e scade dopo 24 ore.
  • Esperienza localizzata: il portale è disponibile in 21 lingue e ne seleziona una dalle impostazioni del browser del cliente.

Metodi di accesso

I clienti accedono al portale tramite un link statico o dinamico. Il link statico non scade mai. Il cliente lo apre, inserisce il proprio indirizzo email e riceve un link di accesso tramite email. Il link statico dipende dall’ambiente: Test Mode (per test e sviluppo):
Live Mode (per la produzione con transazioni reali):
Sostituisci {business_id} con il tuo ID attività, quindi condividi il link con i tuoi clienti. Il Link statico nella finestra di dialogo Condividi invito lo contiene già.
Schermata di accesso tramite email
1

Merchant Flow

  1. Vai a Sales → Customers e apri un cliente, oppure usa la colonna Invite nell’elenco.
  2. Fai clic su Share Invite.
  3. Copia il Link statico e condividilo con il cliente.
2

Customer Flow

  1. Apri il link statico.
  2. Inserisci l’indirizzo email usato per l’acquisto e fai clic su Get Access Link.
  3. Apri il link di accesso ricevuto via email. È valido per 24 ore.
La pagina mostra sempre la stessa conferma. Dodo Payments invia un link solo quando l’indirizzo appartiene a un cliente della tua attività, quindi la pagina non rivela chi sono i tuoi clienti.
Le email di accesso non vengono inviate in modalità test. Per aprire un portale in modalità test, usa il Link dinamico o crea una sessione tramite API.
Un link dinamico fa accedere direttamente al portale un cliente, senza il passaggio dell’email. Scade 24 ore dopo la creazione.
Un link dinamico smette di funzionare dopo 24 ore. Quando scade, il cliente visualizza una pagina di scadenza. Genera un nuovo link e invialo nuovamente.
Magic link direct access
1

Merchant Flow

  1. Vai a Sales → Customers e apri il cliente.
  2. Fai clic su Share Invite.
  3. Copia il Link dinamico e condividilo con il cliente.
2

Customer Flow

  1. Apri il link dinamico.
  2. Il Customer Portal si apre direttamente, senza richiedere un indirizzo email.

Funzionalità del portale

La panoramica del portale è una singola pagina. Su desktop, un pannello a sinistra descrive il portale. L’area principale elenca gli abbonamenti, i metodi di pagamento e la cronologia di fatturazione del cliente.

Active Subscriptions

Ogni abbonamento mostra il nome del piano, il prezzo, la data di rinnovo e la validità. Manage subscription apre i dettagli, dove il cliente può modificare i dati di fatturazione, cambiare piano, mettere in pausa o annullare l’abbonamento.

Payment Methods

Metodi di pagamento salvati, come carte con circuito e ultime quattro cifre, UPI, wallet e metodi bancari. Modifica il metodo di pagamento di un abbonamento dalla relativa pagina dei dettagli.

Billing History

Ogni pagamento in una tabella con Date, Status, Amount, Pricing Type, Entitlements e download della Invoice.

Billing Information

Nome, email, numero di telefono e indirizzo di fatturazione, mostrati nella pagina dei dettagli dell’abbonamento. I clienti possono modificare il nome e l’indirizzo di fatturazione.

Panoramica del portale

La pagina panoramica mostra gli abbonamenti attivi, i metodi di pagamento salvati e la cronologia di fatturazione in un’unica visualizzazione scorrevole.
Customer Portal main page showing active subscriptions and payment methods

Metodi di pagamento e cronologia di fatturazione

Più in basso nella pagina si trovano i metodi di pagamento salvati e la cronologia di fatturazione, con lo stato di ogni pagamento e un link per scaricare ogni fattura.
Payment methods and billing history with invoice downloads

Supporto delle lingue

Il Customer Portal è disponibile in 21 lingue, così i clienti possono gestire abbonamenti, metodi di pagamento e cronologia di fatturazione nella propria lingua.

Come funziona la selezione della lingua

  • Rilevamento automatico: alla prima visita, il portale legge la lingua preferita dal browser e la carica se supportata. Altrimenti usa l’inglese.
  • Override manuale: i clienti possono cambiare lingua in qualsiasi momento tramite il selettore della lingua nell’angolo in basso a destra della pagina, su desktop e dispositivi mobili.
  • Preferenza persistente: il portale memorizza la scelta nel cookie NEXT_LOCALE per un anno, ricordando la lingua tra una visita e l’altra.

Lingue supportate

Modifiche del piano (upgrade/downgrade)

I clienti possono eseguire upgrade o downgrade dal portale tra prodotti appartenenti alla stessa Product Collection.
Per consentire ai clienti con abbonamenti esistenti di cambiare piano, aggiungi i prodotti in abbonamento a una Product Collection e attiva Allow Subscription Updates. I clienti potranno quindi passare da un piano all’altro della raccolta dal portale.

Azioni disponibili

Come funzionano le modifiche del piano

  1. Il cliente fa clic su Change Plan nella pagina dei dettagli dell’abbonamento.
  2. Il portale elenca gli altri piani nella Product Collection.
  3. Il cliente seleziona un piano. Un pannello Confirm Plan Change mostra il piano attuale e quello aggiornato, il dettaglio delle voci (un credito per il vecchio piano e un addebito per quello nuovo), le imposte e l’importo dovuto ora. Il cliente può anche inserire qui un codice sconto.
  4. Il cliente conferma con il pulsante Pay, che mostra l’importo dovuto.
  5. Dodo Payments calcola il prorating e riscuote l’addebito, tramite il metodo di pagamento salvato oppure su una pagina di checkout ospitata se riscuoti i pagamenti per il cambio piano tramite payment link (consulta Riscossione dei pagamenti per il cambio piano tramite payment link).
  6. L’abbonamento passa al nuovo piano. Il fatto che ciò avvenga immediatamente o solo dopo il buon esito dell’addebito dipende dalla tua gestione dei pagamenti non riusciti. Un cambio piano pagato tramite payment link attende sempre il pagamento.
Subscription details page with Change Plan, Pause Subscription, and Cancel Subscription buttons
Confirm Plan Change panel showing current vs. updated plan, a line-item breakdown, discount code entry, and the Pay button
I cambi piano funzionano solo tra prodotti nella stessa raccolta e il prodotto di destinazione deve essere un prodotto in abbonamento o basato sull’utilizzo. I prodotti una tantum vengono rifiutati.
Per impostazione predefinita, un cambio piano immediato addebita il metodo di pagamento salvato del cliente. Con Collect Plan Change Payments by Payment Link attivo, il portale apre invece una pagina di checkout Dodo Payments ospitata in una nuova scheda e il cliente paga lì. Questo vale per upgrade e downgrade che comportano un addebito.
Settings → Subscriptions page with the Collect Plan Change Payments by Payment Link toggle enabled and its tooltip explaining the behavior
Hosted Dodo Checkout page from a separate example, where the customer pays for a plan change
L’abbonamento rimane sul suo piano attuale finché il pagamento del checkout non va a buon fine. Un pagamento non riuscito o abbandonato lascia invariato l’abbonamento. Dopo un pagamento rifiutato, il cliente avvia nuovamente la modifica del piano dal Customer Portal per ottenere un nuovo link di checkout. I downgrade programmati (effective_at: next_billing_date) non passano dal checkout; vengono applicati alla successiva data di fatturazione, come di consueto.
Questa impostazione si applica solo ai cambi piano immediati. Finché un payment link per il cambio piano non è stato pagato e non è scaduto, il portale rifiuta ulteriori richieste di cambio piano per quell’abbonamento.

Plan Change via Payment Link (API)

Come richiedere un payment link con collect_via_payment_link e gestire la risposta.

Controlli aziendali

Configura ciò che i clienti possono fare con i propri abbonamenti in Settings → Subscriptions:
  • Allow Subscription Updates: consente ai clienti di eseguire upgrade o downgrade. Disattivato per impostazione predefinita.
  • Allow Immediate Cancellation: consente ai clienti di terminare l’abbonamento e perdere subito l’accesso. Attivato per impostazione predefinita.
  • Allow Cancellation at Next Billing Date: consente ai clienti di annullare l’abbonamento al termine del periodo già pagato. Attivato per impostazione predefinita.
  • Allow Subscription Pause: consente ai clienti di mettere in pausa e riprendere autonomamente i propri abbonamenti. Disattivato per impostazione predefinita.
  • Collect Plan Change Payments by Payment Link: invia i clienti a una pagina di checkout per pagare un cambio piano immediato, invece di addebitare il metodo di pagamento salvato. Disattivato per impostazione predefinita.

Product Collections

Configura le raccolte di prodotti e imposta i percorsi di upgrade e downgrade.

Dettagli dell’abbonamento

Manage subscription su qualsiasi abbonamento attivo apre la relativa pagina dei dettagli, che mostra:
  • Dettagli del piano: nome dell’abbonamento, prezzo, data di rinnovo e periodo di validità.
  • Metodo di pagamento: il metodo di pagamento dell’abbonamento, con un pulsante Edit.
  • Informazioni di fatturazione: nome, email, numero di telefono e indirizzo di fatturazione, con un pulsante Edit per il nome e l’indirizzo di fatturazione.
  • Cronologia di fatturazione: una tabella di tutti i pagamenti relativi a questo abbonamento.
  • Pause Subscription: mostrato quando consenti la pausa self-service.
  • Cancel Subscription: apre la finestra di dialogo per l’annullamento.
Subscription details page showing plan info, payment method, billing information, and cancel option

Annullamento di un abbonamento

I clienti annullano l’abbonamento dalla pagina dei dettagli. Cancel Subscription apre una finestra di dialogo con due opzioni:
  • Cancel at next billing date: l’abbonamento resta attivo fino al termine del periodo di fatturazione corrente, quindi viene annullato.
  • Cancel now: l’abbonamento viene annullato immediatamente.
Due impostazioni in Settings → Subscriptions controllano separatamente queste opzioni: Allow Immediate Cancellation e Allow Cancellation at Next Billing Date. Entrambe sono attive per impostazione predefinita. Disattivandone una, rimuovi solo l’opzione corrispondente, quindi puoi offrirne una senza l’altra. Se entrambe sono disattivate, Cancel Subscription è disabilitato e il relativo tooltip chiede al cliente di contattarti. Un cliente con un annullamento già programmato visualizza Revoke Cancellation, per poter restare, e Cancel immediately, che corrisponde alla stessa azione di Cancel now. Queste impostazioni non influiscono sugli annullamenti effettuati da te.
Cancel subscription dialog with options to cancel at next billing date or cancel immediately

Motivi dell’annullamento

Prima di confermare, il cliente deve rispondere a Why are you cancelling? scegliendo un motivo da un elenco predefinito. Può anche aggiungere un commento facoltativo di massimo 500 caratteri in Additional comments. Dodo Payments salva entrambi nell’abbonamento e li restituisce nei payload dei webhook e nell’API, così puoi analizzare il motivo per cui i clienti abbandonano e personalizzare i messaggi per riconquistarli.
Cancellation modal with the 'Why are you cancelling?' dropdown showing reasons like Too expensive, Missing features, and Other
Il motivo viene salvato nel campo cancellation_feedback dell’abbonamento e il commento in cancellation_comment.
Entrambi i campi sono presenti anche nel payload del webhook subscription.cancelled. Per impostarli autonomamente, passali a PATCH /subscriptions/{subscription_id} quando annulli o programmi un annullamento tramite API.
Usa cancellation_feedback insieme a Subscription Dunning per personalizzare le email di riconquista. Ad esempio, invia un codice sconto ai clienti che hanno scelto too_expensive e un sondaggio di feedback a quelli che hanno scelto missing_features.

Mettere in pausa un abbonamento

La pausa offre ai clienti un’alternativa tra mantenere e annullare un abbonamento. Un abbonamento in pausa interrompe la fatturazione, ma conserva piano e cronologia, consentendo al cliente di riprenderlo in seguito invece di acquistarlo nuovamente. I clienti aprono la finestra di dialogo Pause your subscription dalla pagina dei dettagli dell’abbonamento. La finestra mostra il piano attuale, avvisa che l’accesso termina immediatamente e spiega come cambiano le date di fatturazione. Il cliente conferma con Pause subscription.
Pause your subscription dialog showing the current plan, a warning that access is revoked immediately, and the pause confirmation button
La finestra di dialogo informa il cliente su ciò che accade e il sistema si comporta come descritto:
  • L’accesso si interrompe immediatamente. Le funzionalità, i download e le chiavi di licenza inclusi nell’abbonamento smettono di funzionare finché l’abbonamento non viene ripreso.
  • La pausa non ha una data di fine. L’abbonamento resta in pausa finché il cliente non lo riprende.
  • Non si perde tempo pagato. La prossima data di fatturazione e la data di rinnovo avanzano entrambe di una durata pari a quella della pausa.
La ripresa segue lo stesso flusso e viene confermata con Resume subscription. L’abbonamento torna a active e l’accesso viene ripristinato.
L’impostazione Allow Subscription Pause in Settings → Subscriptions controlla la pausa self-service ed è disattivata per impostazione predefinita. Quando è disattivata, i clienti non possono avviare una nuova pausa, ma possono comunque riprendere una pausa avviata da loro. Le pause avviate dalla dashboard non sono interessate.

How Pausing Works

Comportamento completo della pausa, inclusi effetti sulla fatturazione, regolazione dell’utilizzo e webhook.

Aggiornamento dei metodi di pagamento

I clienti modificano il metodo di pagamento di un abbonamento con Edit, accanto al metodo di pagamento nella pagina dei dettagli dell’abbonamento. Questo è anche il modo in cui un cliente riattiva un abbonamento sospeso dopo un pagamento non riuscito.

Riattivazione degli abbonamenti in attesa

Un abbonamento passa a on_hold quando un pagamento non va a buon fine. Il portale mostra Your subscription is currently on hold e chiede al cliente di aggiornare il metodo di pagamento. Quando lo fa, Dodo Payments:
  1. Crea un addebito per gli importi ancora dovuti
  2. Genera una fattura per l’addebito
  3. Riscuote il pagamento con il nuovo metodo di pagamento
  4. Riattiva l’abbonamento a active quando il pagamento va a buon fine
Un abbonamento in on_hold non si rinnova. Il cliente deve aggiornare il metodo di pagamento per saldare gli importi dovuti e riattivarlo.
Quando vengono pagati gli importi dovuti per un abbonamento on_hold, l’abbonamento torna nuovamente a essere active.

Riattivazione degli abbonamenti durante un periodo di tolleranza

Se imposti un periodo di tolleranza, un rinnovo non riuscito sposta l’abbonamento a past_due anziché a on_hold. Il cliente mantiene l’accesso fino alla scadenza. Il recupero funziona allo stesso modo: il cliente aggiorna il metodo di pagamento e l’abbonamento torna a active. Se non interviene, alla scadenza l’abbonamento passa a on_hold o cancelled, in base alla tua configurazione, e l’accesso termina.

Flusso di aggiornamento del metodo di pagamento

1

Access Subscription Details

Fai clic su Manage subscription sull’abbonamento dalla panoramica del portale.
2

Click Edit on Payment Method

Fai clic su Edit accanto al metodo di pagamento.
3

Select or Add Payment Method

Scegli un metodo di pagamento salvato oppure fai clic su Add Payment Method e inserisci i nuovi dati.
4

Confirm Changes

Conferma l’aggiornamento. Per un abbonamento on_hold, viene creato un addebito per gli importi ancora dovuti.
5

Complete Payment (If On Hold)

Se l’abbonamento è sospeso, il cliente viene reindirizzato al pagamento degli importi ancora dovuti. Quando il pagamento va a buon fine, l’abbonamento viene riattivato.
6

Confirmation

Il portale conferma che il metodo di pagamento è stato aggiornato e, per un abbonamento sospeso, che è nuovamente attivo.
Quando non ci sono importi dovuti, la modifica della carta crea un pagamento di importo zero per verificare la nuova carta. Il cliente non riceve alcuna email di ricevuta per questo pagamento, ma il webhook payment.succeeded viene comunque attivato. Un aggiornamento della carta che salda anche gli importi dovuti invia la ricevuta abituale.

Esempi di integrazione

Per inviare un cliente dalla tua app al portale, crea una sessione del portale sul tuo server e reindirizza il cliente all’link restituito. Il link è valido per 24 ore.
Per fare in modo che Dodo Payments invii il link al cliente anche tramite email, passa send_email: true.

Unified Customer Portal

Oltre al portale della tua attività, Dodo Payments gestisce un Unified Customer Portal all’indirizzo customer.dodopayments.com. Qui i clienti possono visualizzare e gestire i propri acquisti e abbonamenti presso tutte le attività che vendono tramite Dodo Payments.
Unified Customer Portal

Funzionalità di Unified Portal

  • Visibilità tra attività: visualizza in un unico posto gli acquisti e gli abbonamenti di tutti i merchant Dodo Payments.
  • Gestione centralizzata: gestisci gli abbonamenti con diverse attività da un unico sito.
  • Cronologia di fatturazione unificata: accedi alle fatture e alla cronologia dei pagamenti per tutti gli acquisti.
  • Accesso singolo: accedi una volta con un indirizzo email per visualizzare gli acquisti di tutti i merchant Dodo Payments.
Unified Customer Portal funziona insieme al portale della tua attività. I clienti possono usare l’uno o l’altro.

Risoluzione dei problemi

  • Link scaduto: genera un nuovo link dinamico e invialo al cliente.
  • Email non riconosciuta: chiedi al cliente di usare l’indirizzo email associato al suo acquisto. Non viene inviata alcuna email di accesso per un indirizzo che non appartiene a un cliente della tua attività.
  • Abbonamento sospeso: il cliente aggiorna il metodo di pagamento nel portale. Dodo Payments addebita gli importi ancora dovuti e riattiva l’abbonamento quando il pagamento va a buon fine.
  • Aggiornamento del metodo di pagamento non riuscito: se il pagamento non va a buon fine durante l’aggiornamento di un abbonamento on_hold, l’abbonamento rimane sospeso. Il cliente può riprovare con un metodo di pagamento diverso.

Design & Theme Customization

Personalizza il portale con temi, tipografia e colori predefiniti, con un’anteprima in tempo reale, dalla pagina Design.
Ultima modifica il 28 settembre 2026