Skip to main content

​
Overview

La pagina Customers elenca tutte le persone che hanno acquistato dalla tua azienda. Dalla pagina di un cliente puoi esaminare i pagamenti e gli abbonamenti, verificare e modificare i saldi del wallet, inviargli un link al Customer Portal e bloccarlo. Gli stessi record dei clienti sono disponibili tramite API.

Customer Dashboard

Visualizza tutti i clienti in un unico elenco, filtra per nome o email e apri i dettagli di qualsiasi cliente.

Customer Wallets

Conserva i saldi prepagati che Dodo Payments applica agli addebiti degli abbonamenti.

Customer Portal

Consenti ai clienti di gestire autonomamente abbonamenti, fatture e chiavi di licenza.

API Management

Crea, aggiorna e recupera i clienti tramite API.

​
Accessing the Customers Page

1

Navigate to Customers

Nella dashboard, vai a Sales → Customers.
2

View Customer List

La pagina elenca tutti i clienti attuali e passati della tua azienda.
Pagina dell'elenco dei clienti che mostra tutti i clienti con i loro dettagli

​
Customer Information

La tabella dei clienti mostra una riga per cliente, con le colonne riportate di seguito.

​
Customer List Columns

  • Customer Name: il nome completo del cliente, con un avatar.
  • Customer Id: l’identificatore univoco, che inizia con cus_. Usalo nelle chiamate API.
  • Email: l’indirizzo email del cliente. Il cliente lo usa per accedere al Customer Portal.
  • Phone Number: il numero di telefono del cliente, se fornito.
  • Created At: quando è stato creato il record del cliente. Passa il cursore sul valore per visualizzare l’ora in UTC.
  • Invite: un pulsante Share Invite che apre i link al Customer Portal per questo cliente.

​
Page Features

  • Column visibility: scegli quali colonne mostrare nella tabella.
  • Filters: trova i clienti per Name o Email Address.
  • Pagination: scorri l’elenco e imposta il numero di Rows per page.
Nascondi le colonne che non usi, così la tabella mostra solo ciò che è rilevante per il tuo flusso di lavoro.

​
Customer Details Page

Fai clic su un cliente per aprire la pagina Customer Information:
Pagina dei dettagli del cliente che mostra informazioni e cronologia delle transazioni

​
About Section

Nella parte superiore della pagina sono mostrati i dati principali del cliente:
  • Name: il nome completo del cliente.
  • Email: l’indirizzo email del cliente.
  • Customer ID: l’identificatore da usare nelle API e nelle richieste di supporto.
  • Created At: quando è stato creato il record del cliente.
Sotto i dettagli, la scheda Customer Portal contiene un pulsante Share Invite. Mostra un link statico e un link dinamico valido 24 ore al portale del cliente. Consulta Metodi di accesso.

​
Schede delle attività del cliente

Le schede sotto i dettagli mostrano l’attività del cliente. Le principali sono descritte qui. La pagina contiene anche le schede Credits, Entitlements e Sent Emails; per Sent Emails, consulta Log delle email dei clienti.
I pagamenti, i rimborsi e le contestazioni del cliente. La tabella dei pagamenti mostra:
  • Payment ID: l’identificatore del pagamento, che inizia con pay_.
  • Status: lo stato del pagamento, ad esempio Successful, Failed o Refunded.
  • Amount: l’importo del pagamento.
  • Date: quando è stato creato il pagamento.
  • Pricing Type: una tantum o abbonamento.
  • Payment Method: il metodo di pagamento utilizzato, ad esempio carta o UPI.
  • Customer Email: l’indirizzo email associato al pagamento.
  • Refund: un pulsante Initiate Refund.
  • Actions: ulteriori opzioni per il pagamento.
La scheda Wallets mostra ogni modifica al wallet di un cliente, così puoi tracciare come è stato raggiunto il saldo attuale.

​
Blocco di un cliente

Blocca un cliente che commette frodi o abusa dei rimborsi, così non potrà effettuare altri acquisti con te. Il blocco annulla gli abbonamenti attivi del cliente e rende il suo Customer Portal di sola lettura. La pagina di un cliente bloccato mostra un badge Blocked, un pulsante Unblock Customer e un Activity Log con note che spiegano il blocco. Gestisci tutti i blocchi da Settings → Blocklist.

Customer Blocklist

Cosa comporta un blocco, come vengono confrontate le email e come bloccare un cliente dalla dashboard o tramite API.

​
Customer Portal

Il Customer Portal è un sito self-service ospitato in cui i tuoi clienti gestiscono gli abbonamenti, visualizzano la cronologia di fatturazione e recuperano le chiavi di licenza senza contattare il supporto.

​
Funzionalità del portale

Nel portale, i clienti possono:
  • View Billing History: visualizzare i pagamenti passati e scaricare le fatture.
  • Manage Subscriptions: visualizzare i dettagli, cambiare piano, mettere in pausa o annullare l’abbonamento, in base alle impostazioni.
  • Retrieve License Keys: visualizzare le chiavi di licenza associate agli acquisti.
  • Update Billing Details: modificare il nome, l’indirizzo di fatturazione e il metodo di pagamento di un abbonamento. L’indirizzo email e il numero di telefono vengono mostrati, ma non possono essere modificati nel portale.

Learn More About Customer Portal

Funzionalità del portale, metodi di accesso ed esempi di integrazione.

​
Wallet dei clienti

I wallet dei clienti contengono denaro prepagato per un cliente, con un saldo per valuta. Dodo Payments applica il saldo del wallet agli addebiti dell’abbonamento del cliente prima di addebitare il relativo metodo di pagamento. Puoi aggiungere o detrarre fondi con una voce del ledger, ad esempio per emettere un rimborso come saldo del wallet o un bonus promozionale.

​
Funzionalità principali

  • Multi-Currency Support: ogni valuta ha il proprio saldo.
  • Prepaid Balances: i fondi vengono applicati ai rinnovi futuri degli abbonamenti e agli addebiti dovuti ai cambi di piano.
  • Transaction History: il ledger registra ogni aggiunta e detrazione di fondi.
  • API-First Design: controlla i saldi e aggiungi o detrai fondi tramite API oppure dalla scheda Wallets.

Learn More About Customer Wallets

Valute supportate, esempi di codice e best practice per i saldi dei wallet dei clienti.

​
Gestione tramite API

Customers API consente di creare, recuperare e aggiornare i clienti, elencarli con filtri e gestire i metodi di pagamento salvati.

​
Endpoint API disponibili

Create Customer

Crea un cliente. name e email sono obbligatori. phone_number e metadata sono facoltativi.

List Customers

Elenca i clienti pagina per pagina. Filtra per email, per name (corrispondenza parziale) oppure per data di creazione.

Get Customer Details

Recupera un cliente tramite il relativo ID.

Update Customer

Aggiorna name, email, phone_number o metadata di un cliente.

Delete Payment Method

Rimuovi un metodo di pagamento salvato. La richiesta fallisce con 409 se un abbonamento attivo lo utilizza.

Create Portal Session

Crea un link al Customer Portal per un cliente, valido 24 ore.
Ogni endpoint richiede la tua API key. Chiama l’API dal tuo server e non esporre mai la chiave nel codice lato client.
Ultima modifica il 26 settembre 2026