Skip to main content
Pagina di checkout
Il checkout di Dodo Payments è una pagina di pagamento ospitata progettata per prodotti digitali e SaaS. Gestisce la conversione valutaria, il calcolo delle imposte, i codici sconto, la raccolta dell’indirizzo e la selezione del metodo di pagamento. Crei una sessione di checkout tramite API o dashboard e i clienti completano il pagamento su una pagina sicura e personalizzata con il tuo brand.

Checkout Sessions API

Crea sessioni di checkout a livello programmatico.

Preview Checkout

Calcola prezzi e tasse prima di creare una sessione.

Payment Methods

Metodi di pagamento e configurazione supportati.

Integration Guide

Guida passo passo all’integrazione del checkout.
I link di checkout generati tramite Checkout Sessions API non sono riutilizzabili. Scadono dopo 24 ore o dopo 15 minuti se confirm: true è impostato. Genera una nuova sessione per ogni cliente e per ogni tentativo di pagamento.

Adaptive Currency

Adaptive Currency consente ai clienti di pagare nella valuta locale preferita, migliorando la fiducia e i tassi di conversione. Quando è abilitata, i clienti visualizzano un selettore della valuta nel checkout. Il prezzo viene convertito nella valuta scelta utilizzando i tassi FX correnti. Se per il prodotto è abilitata la Purchasing Power Parity, viene convertito il prezzo adeguato in base alla PPP invece del prezzo base. Se è abilitata la Charm Pricing, l’importo convertito viene arrotondato a una cifra finale ordinata, come 49.99.
Selettore della valuta nel checkout
Per abilitare Adaptive Currency, vai a Settings → Business e attivala.

Adaptive Currency

Valute supportate, commissioni di conversione e gestione dei rimborsi.

Checkout multilingue

Il checkout supporta 22 lingue. I clienti possono cambiare lingua direttamente nella pagina e il testo dell’interfaccia, le etichette e i messaggi di sistema sono localizzati. In arabo ed ebraico, il checkout viene visualizzato da destra a sinistra e l’intero layout si rispecchia. Gli indirizzi email, i codici e i numeri di telefono mantengono il loro naturale ordine di lettura.
Language selector on checkout

Lingue supportate

Per forzare una lingua specifica, imposta customization.force_language durante la creazione di una sessione di checkout. Per ulteriori informazioni, consulta le Checkout Sessions API.

Calcolo automatico delle imposte

Le imposte vengono calcolate automaticamente in base alla sede di fatturazione del cliente, garantendo la conformità ai requisiti relativi a GST, VAT e sales tax. Le regole fiscali vengono applicate in base al paese e alla regione del cliente, ove applicabile. L’importo delle imposte si aggiorna automaticamente quando il cliente cambia paese o aggiorna il proprio indirizzo. Il riepilogo finale delle imposte viene mostrato chiaramente prima del pagamento.
Il calcolo delle imposte è completamente automatizzato. Non è necessaria alcuna configurazione manuale per i prodotti digitali e i prodotti SaaS standard.

Supporto per il Business Tax ID

Per le transazioni B2B, il checkout consente ai clienti di inserire il proprio Business Tax ID (ad esempio, il numero VAT o GST). Quando viene inserito, il tax ID viene convalidato in tempo reale e le esenzioni fiscali applicabili o le regole di reverse charge vengono applicate automaticamente.
Business Tax ID entry on checkout

Codici sconto

I clienti possono applicare i codici sconto o promozionali creati nella dashboard. Lo sconto viene convalidato istantaneamente e il prezzo aggiornato viene mostrato. Quando Purchasing Power Parity è abilitato su un prodotto, lo sconto viene applicato al prezzo adeguato in base al PPP, non al prezzo base.
Discount code entry on checkout
Puoi applicare in anticipo i codici sconto o abilitare il campo di inserimento dello sconto tramite l’API:
discount_codes accetta un array di massimo 20 codici, applicati in sequenza. Il campo singolare discount_code è deprecato, ma funziona ancora per garantire la compatibilità con le versioni precedenti.

Discount Codes

Crea e gestisci i codici sconto.

Validate Discount by Code

Cerca e convalida gli sconti utilizzando i nomi dei codici.

Raccolta intelligente degli indirizzi

Il checkout supporta l’inserimento flessibile degli indirizzi per bilanciare velocità, accuratezza e copertura globale.

Opzioni

Modalità indirizzo minimo

Per massimizzare la conversione, abilita la raccolta minima dell’indirizzo per ridurre gli ostacoli nel checkout. Quando minimal_address è impostato su true, il checkout raccoglie solo:
  • Paese — sempre obbligatorio per determinare le imposte
  • Codice ZIP/postale — solo nelle regioni in cui è necessario per il calcolo di sales tax, VAT o GST
Tutti gli altri campi dell’indirizzo vengono ignorati.
Minimal address mode showing only country and ZIP/postal code fields on checkout
La raccolta completa dell’indirizzo è l’impostazione predefinita. Abilita minimal_address per i prodotti digitali e i flussi SaaS in cui non sono richiesti tutti i dati di fatturazione.

Raccolta del numero di telefono

Controlla se il campo del numero di telefono viene visualizzato nel checkout e se è obbligatorio.
require_phone_number: true richiede allow_phone_number_collection: true. L’API rifiuta le sessioni in cui la raccolta del numero di telefono è disabilitata mentre il numero di telefono è obbligatorio.

Campi personalizzati

Raccogli informazioni aggiuntive dai clienti durante il checkout definendo campi modulo personalizzati. È utile per raccogliere il nome dell’azienda, le dimensioni del team, la fonte di riferimento o qualsiasi altro dato specifico dell’attività.

Tipi di campo disponibili

Esempio

Le risposte dei clienti vengono incluse automaticamente nei payload dei webhook (payment.succeeded, subscription.active) e nelle risposte API tramite l’array custom_field_responses. Puoi definire fino a 5 campi personalizzati per ogni sessione di checkout.

Custom Fields Guide

Configurazione dei campi personalizzati e accesso alle risposte.

Accettazione dell’informativa sulla privacy e dei termini

Per garantire trasparenza legale e di conformità:
  • I link a Privacy Policy e Buyer Terms vengono mostrati chiaramente nel checkout
  • I clienti li accettano esplicitamente prima di completare il pagamento
Questo aiuta a soddisfare i requisiti globali in materia di tutela dei consumatori e privacy dei dati, inclusa la conformità al GDPR.

Raccolte di prodotti

Le raccolte di prodotti consentono un’esperienza di checkout unificata in cui i clienti visualizzano e selezionano più prodotti correlati (ad esempio, i piani Starter, Pro ed Enterprise) in un unico checkout. Quando utilizzi una raccolta, vengono visualizzati tutti i prodotti attivi al suo interno. Il primo prodotto viene preselezionato e i clienti possono confrontare le opzioni prima di effettuare la scelta.
Quando utilizzi product_collection_id, trasmetti un array product_cart vuoto. I codici sconto non possono essere applicati in anticipo durante la creazione della sessione.

Product Collections

Crea e gestisci le raccolte di prodotti.

Configurazione della Checkout Session

Controlla il comportamento del checkout utilizzando la Checkout Sessions API:
Dopo il pagamento, i clienti vengono reindirizzati al tuo return_url con i parametri di query aggiunti automaticamente, inclusi payment_id o subscription_id, status, email e license_key (se applicabile). Consulta la guida alle Checkout Sessions per l’elenco completo.

Checkout Sessions API

Riferimento API completo per le sessioni di checkout.

Checkout Integration Guide

Guida passo passo all’integrazione del checkout.

Personalizzazione del tema

Personalizza l’aspetto della pagina di checkout in modo che corrisponda al tuo brand utilizzando il parametro customization.theme_config. Configura colori, caratteri, raggio dei bordi e testo del pulsante per le modalità chiara e scura. Questa sezione tratta l’API lato server, che utilizza nomi di proprietà come bg_primary. Un tema impostato sulla sessione si applica al checkout hosted, overlay e inline. L’opzione lato client themeConfig del Checkout SDK, che utilizza nomi di proprietà come bgPrimary, è deprecata. Consulta Overlay Checkout.
Custom themed checkout page

Design & Theme Customization

Configura visivamente i temi dalla dashboard con temi predefiniti, tipografia, colori e anteprima in tempo reale.

Opzioni di configurazione del tema

Configurazione dei colori (modalità chiara/scura)

Ogni modalità supporta queste proprietà dei colori:
Tutti i campi colore accettano i formati di colore CSS standard:
  • Hex: #fff, #ffffff, #ffffffff
  • RGB/RGBA: rgb(255, 255, 255), rgba(255, 255, 255, 0.5)
  • HSL/HSLA: hsl(120, 100%, 50%), hsla(120, 100%, 50%, 0.5)
  • Colori denominati: red, blue, transparent

Esempio

Non è necessario specificare tutte le proprietà dei colori. Le proprietà non specificate utilizzano i valori del tema predefinito.
Ultima modifica il 26 settembre 2026