The Customer Portal is a secure, hosted area where your customers can manage subscriptions, view invoices and access license keys details—without contacting support.
Create Portal Session (API)
Programmatically create secure, time‑bound portal sessions.
Subscriptions
Manage recurring plans, upgrades, downgrades, and add‑ons.
What Is the Customer Portal?
The portal provides a trusted, branded self‑service experience for customers to:- Accedere alla cronologia di fatturazione: visualizza le fatture e scarica le ricevute.
- Gestire gli abbonamenti: visualizza i dettagli degli abbonamenti, metti in pausa e riprendi gli abbonamenti e annullali immediatamente o alla prossima data di fatturazione.
- Aggiornare i metodi di pagamento: modifica i metodi di pagamento per gli abbonamenti attivi o riattiva gli abbonamenti sospesi.
- Recuperare le chiavi di licenza: accedi a tutte le chiavi associate agli acquisti.
- Navigare con facilità: usa il pulsante Indietro per spostarti tra le sezioni del portale senza perdere il contesto.
Key Benefits
- Volume di supporto ridotto: I clienti risolvono autonomamente le richieste comuni di fatturazione
- Time-to-value più veloce: Accesso immediato a fatture e chiavi
- Rischio di abbandono ridotto: Visibilità chiara sui rinnovi e dettagli del piano
- Sicuro per progettazione: Accesso tokenizzato con link a scadenza
- Esperienza localizzata: Il portale è disponibile in 21 lingue, con rilevamento automatico basato sulle preferenze del browser del cliente
Access Methods
Customers can reach the portal using either a static link or a one‑time dynamic link.Static link (email‑based access)
Customers can request portal access by entering their email at a static link that never expires. The static portal link format varies by environment: Test Mode (for testing and development):{business_id} with your actual business identifier, then share the appropriate link with customers so they can enter their email and receive secure access to the portal.
1
Merchant flow
- Go to Sales → Customer.
- Click Share invite.
- Copy the Static link and share it with your customer.
2
Customer flow
- Open the static link.
- Enter the email used at purchase.
- Receive a secure login link to access the portal.
Existing customers are recognized automatically.
Dynamic link (magic link)
A personalized, one‑time magic link that sends customers directly into the portal. The link expires in 24 hours.
1
Merchant flow
- Go to Sales → Customer.
- Click Share invite.
- Copy the Dynamic link and share it with your customer.
2
Customer flow
- Open the dynamic link.
- Access the Customer Portal directly without entering an email.
Portal Features
The revamped Customer Portal provides a clean, unified interface with a left sidebar and organized sections for all account management needs.Active Subscriptions
Visualizza tutti gli abbonamenti attivi con nome del piano, prezzo, data di rinnovo e validità. Fai clic su “Manage subscription” per visualizzare i dettagli, modificare le informazioni di fatturazione, mettere in pausa o annullare l’abbonamento.
Payment Methods
View all saved payment methods (cards, UPI, etc.) at a glance. Edit payment methods directly from subscription details.
Billing History
View all transactions in a detailed table with date, status, pricing type, entitlements, and downloadable invoices.
Billing Information
View and edit your name, email, phone number, and billing address from the subscription details page.
Portal Overview
The main portal page displays all active subscriptions, saved payment methods, and billing history in a single scrollable view.Payment Methods & Billing History
Scroll down to view saved payment methods and a complete billing history with status indicators and downloadable invoices.
Supporto Linguistico
Il Portale Clienti è disponibile in 21 lingue, così i tuoi clienti possono gestire i loro abbonamenti, metodi di pagamento e cronologia delle fatture nella lingua che preferiscono.Come funziona la selezione della lingua
- Rilevamento automatico: Alla prima visita, il portale rileva la lingua preferita del cliente dalle impostazioni del browser e carica la traduzione corrispondente se disponibile. L’inglese è usato come fallback.
- Sostituzione manuale: I clienti possono cambiare la lingua attiva in qualsiasi momento dal selettore di lingua nell’intestazione del portale (disponibile sia su desktop che su mobile).
- Preferenza persistente: La lingua selezionata è memorizzata nel cookie
NEXT_LOCALE(valido per 1 anno) in modo che il portale ricordi la scelta tra le sessioni.
Lingue Supportate
Modifiche al Piano (Upgrade/Downgrade)
Quando i prodotti sono organizzati in Collezioni di Prodotti, i clienti possono effettuare l’upgrade o il downgrade tra i piani direttamente dal Portale Clienti.Azioni Disponibili
Come Funzionano le Modifiche al Piano
- Il cliente fa clic su Change Plan nella pagina dei dettagli dell’abbonamento.
- Vengono mostrate le opzioni di upgrade/downgrade disponibili in base alla raccolta di prodotti.
- Il cliente seleziona il nuovo piano. Un pannello Confirm Plan Change mostra il piano attuale e quello aggiornato, il dettaglio delle voci (credito per il vecchio piano, addebito per quello nuovo), le imposte e l’importo dovuto ora. In questa sezione i clienti possono anche aggiungere un codice sconto.
- Il cliente conferma con Pay ${amount}.
- Viene calcolato il pro-rata e l’addebito viene elaborato, utilizzando il metodo di pagamento salvato oppure una pagina di checkout ospitata se l’attività riscuote i pagamenti per il cambio di piano tramite payment link (vedi sotto).
- L’abbonamento viene aggiornato al nuovo piano. Il fatto che ciò avvenga immediatamente o solo dopo la conferma dell’addebito dipende dalla gestione dei pagamenti non riusciti; un cambio di piano pagato tramite payment link attende sempre il pagamento.
I cambi di piano sono disponibili solo tra prodotti appartenenti alla stessa raccolta. I prodotti devono utilizzare un tipo di fatturazione basato su abbonamento o sull’utilizzo.
Riscuotere i pagamenti per il cambio di piano tramite payment link
Per impostazione predefinita, un cambio di piano immediato addebita direttamente il metodo di pagamento salvato del cliente. Attivando Collect Plan Change Payments by Payment Link il comportamento cambia: invece di addebitare la carta salvata, il cliente viene indirizzato a una pagina Dodo Checkout per effettuare il pagamento. Questo vale sia per gli upgrade sia per i downgrade che comportano un addebito.
L’abbonamento rimane sul piano attuale fino al completamento del pagamento nel checkout: un pagamento non riuscito o abbandonato lascia invariato l’abbonamento, consentendo al cliente di riprovare nella stessa sessione di checkout. I downgrade programmati (
effective_at: next_billing_date) non sono interessati e continuano ad applicarsi alla data di fatturazione successiva senza passare dal checkout.Plan Change via Payment Link (API)
Come richiedere un payment link con
collect_via_payment_link e gestire la risposta.Controlli dell’attività
Le attività possono configurare il comportamento degli abbonamenti del portale nelle impostazioni degli abbonamenti:- Allow Subscription Updates: abilita o disabilita la possibilità per i clienti di effettuare l’upgrade o il downgrade dei propri abbonamenti
- Allow Subscription Cancellation: abilita o disabilita la possibilità per i clienti di annullare autonomamente i propri abbonamenti
- Allow Subscription Pause: abilita o disabilita la possibilità per i clienti di mettere in pausa e riprendere autonomamente i propri abbonamenti
- Collect Plan Change Payments by Payment Link: indirizza i clienti a una pagina di checkout per pagare un cambio di piano immediato, invece di addebitare il metodo di pagamento salvato. Disattivato per impostazione predefinita.
Product Collections
Scopri come configurare le raccolte di prodotti e definire i percorsi di upgrade/downgrade.
Dettagli dell’abbonamento
Quando i clienti fanno clic su “Manage subscription” per un abbonamento attivo, vengono indirizzati alla pagina dei dettagli dell’abbonamento. Questa pagina mostra:- Dettagli del piano: nome dell’abbonamento, prezzo, data di rinnovo e periodo di validità
- Metodo di pagamento: la carta o il metodo di pagamento collegato all’abbonamento, con un pulsante “Edit”
- Informazioni di fatturazione: nome, email, numero di telefono e indirizzo di fatturazione, con un pulsante “Edit”
- Cronologia di fatturazione: una tabella dettagliata di tutti i pagamenti per questo abbonamento
- Pausa: un’opzione per mettere in pausa l’abbonamento, mostrata quando è consentita la pausa self-service
- Cancel Subscription: un pulsante in evidenza per annullare l’abbonamento
Annullamento di un abbonamento
I clienti possono annullare il proprio abbonamento direttamente dalla pagina dei dettagli dell’abbonamento. Facendo clic su “Cancel Subscription” si apre una finestra di conferma con due opzioni:- Annulla alla prossima data di fatturazione: l’abbonamento rimane attivo fino alla fine del periodo di fatturazione corrente, quindi viene annullato automaticamente.
- Annulla ora: l’abbonamento viene annullato immediatamente.
L’annullamento self-service è controllato dall’impostazione Allow Subscription Cancellation in Settings → Subscriptions, attivata per impostazione predefinita. Quando viene disattivata, il pulsante Cancel Subscription viene disabilitato e un tooltip chiede al cliente di contattarti; entrambi i percorsi di annullamento del portale, annulla ora e annulla alla prossima data di fatturazione, vengono rifiutati. I clienti che hanno già un annullamento programmato mantengono l’opzione per revocarlo, così possono scegliere di rimanere. Gli annullamenti eseguiti autonomamente non sono mai interessati.
Motivi dell’annullamento
Prima di confermare l’annullamento, ai clienti viene chiesto “Why are you cancelling?” e viene richiesto di scegliere un motivo da un elenco curato. Il motivo viene salvato sull’abbonamento ed esposto nei payload dei webhook e nell’API, così puoi analizzare i fattori che determinano il churn e personalizzare i flussi di win-back.
Il valore selezionato viene scritto nel campo
cancellation_feedback dell’abbonamento. È possibile acquisire anche un campo di testo libero facoltativo cancellation_comment.
subscription.cancelled e puoi valorizzarli programmaticamente su PATCH /subscriptions/{subscription_id} quando programmi o esegui un annullamento tramite l’API.
Mettere in pausa un abbonamento
La pausa offre ai clienti un’opzione intermedia tra mantenere un abbonamento e annullarlo completamente. Un abbonamento in pausa interrompe la fatturazione, ma conserva il piano e la cronologia, consentendo al cliente di riprenderlo in seguito senza dover ricominciare da capo. I clienti aprono la finestra di pausa dalla pagina dei dettagli dell’abbonamento. La finestra indica il piano attuale, avvisa che l’accesso termina immediatamente e spiega come cambiano le date di fatturazione. Il cliente conferma con Pause subscription.
- L’accesso viene interrotto 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 rimane in pausa finché il cliente non lo riprende.
- Non si perde tempo. La data di fatturazione successiva e la data di rinnovo vengono entrambe posticipate di una durata pari a quella della pausa.
active e l’accesso viene ripristinato.
La pausa self-service è controllata dall’impostazione Allow Subscription Pause in Settings → Subscriptions ed è disabilitata per impostazione predefinita. Quando è disattivata, i clienti non possono avviare una nuova pausa, anche se un cliente che si trova già in pausa può comunque riprendere una pausa avviata autonomamente. Le pause eseguite autonomamente dalla dashboard non sono mai interessate.
How Pausing Works
Comportamento completo della pausa, inclusi gli effetti sulla fatturazione, la liquidazione dell’utilizzo e i webhook.
Aggiornamento dei metodi di pagamento
I clienti possono aggiornare i propri metodi di pagamento direttamente dalla pagina dei dettagli dell’abbonamento facendo clic su “Edit” accanto al metodo di pagamento. Questa funzionalità è particolarmente importante per riattivare gli abbonamenti sospesi a causa di pagamenti non riusciti.Riattivazione degli abbonamenti sospesi
Quando un abbonamento passa allo statoon_hold a causa di un pagamento non riuscito, i clienti devono aggiornare il metodo di pagamento per riattivarlo. Il processo di aggiornamento automaticamente:
- Crea un addebito per gli importi ancora dovuti
- Genera una fattura per l’addebito
- Elabora il pagamento utilizzando il nuovo metodo di pagamento
- Riattiva l’abbonamento allo stato
activedopo il pagamento riuscito
Dopo aver aggiornato correttamente il metodo di pagamento per un abbonamento
on_hold, i clienti visualizzeranno una pagina di conferma e riceveranno notifiche email relative al pagamento riuscito e alla riattivazione dell’abbonamento.Flusso di aggiornamento del metodo di pagamento
1
Access subscription details
Fai clic su “Manage subscription” per un abbonamento attivo dalla pagina iniziale del portale.
2
Click Edit on payment method
Fai clic sul pulsante “Edit” accanto al metodo di pagamento per aprire l’interfaccia di aggiornamento del metodo di pagamento.
3
Select or add payment method
Scegli un metodo di pagamento salvato esistente oppure aggiungine uno nuovo inserendo in modo sicuro i dati della carta.
4
Confirm changes
Conferma l’aggiornamento. Per gli abbonamenti
on_hold, verrà creato automaticamente un addebito per gli importi ancora dovuti.5
Complete payment (if on hold)
Se l’abbonamento è sospeso, i clienti verranno reindirizzati per completare il pagamento degli importi ancora dovuti. Dopo il pagamento riuscito, l’abbonamento viene riattivato automaticamente.
6
Confirmation
I clienti ricevono la conferma che il metodo di pagamento è stato aggiornato e, se applicabile, che l’abbonamento è stato riattivato.
Esempi di integrazione
Crea tramite API una sessione Customer Portal con durata limitata per un cliente specifico, quindi reindirizza l’utente all’URL della sessione.Customer Portal unificato
Oltre ai portali clienti specifici per ogni attività, Dodo Payments offre un Customer Portal unificato all’indirizzo customer.dodopayments.com, dove i clienti possono visualizzare e gestire tutti i propri acquisti e abbonamenti presso diverse attività che utilizzano Dodo Payments.
Funzionalità del portale unificato
- Visibilità tra le attività: visualizza in un unico posto tutti gli acquisti e gli abbonamenti effettuati presso qualsiasi merchant Dodo Payments
- Gestione centralizzata: gestisci gli abbonamenti di diverse attività da un’unica dashboard
- Cronologia di fatturazione unificata: accedi alle fatture e alla cronologia dei pagamenti di tutti gli acquisti
- Single sign-on: accedi una sola volta con l’email per visualizzare gli acquisti di tutti i merchant Dodo Payments
Risoluzione dei problemi
- Link scaduto: genera e invia un nuovo link dinamico.
- Email non riconosciuta: chiedi al cliente di utilizzare l’email associata all’acquisto
- Abbonamento sospeso: se un abbonamento è sospeso, i clienti devono aggiornare il metodo di pagamento tramite il portale per saldare gli importi dovuti e riattivare l’abbonamento. Il processo di aggiornamento addebiterà automaticamente gli importi ancora dovuti.
- Aggiornamento del metodo di pagamento non riuscito: se il pagamento non riesce durante il processo di aggiornamento per un abbonamento
on_hold, l’abbonamento rimarrà sospeso. I clienti possono riprovare con un metodo di pagamento diverso.
Design & Theme Customization
Personalizza l’aspetto del tuo Customer Portal con temi, tipografia, colori e anteprima live predefiniti dalla pagina Design.