Skip to main content
Pagina di checkout
Il checkout di Dodo Payments è ottimizzato per la conversione e conforme a livello globale, progettato per prodotti digitali e aziende SaaS. Supporta più valute, lingue, tasse, sconti, componenti aggiuntivi e flussi di conformità orientati al business.

Checkout Sessions API

Crea sessioni di checkout ospitate in modo programmatico.

Preview Checkout

Calcola prezzi e tasse prima di creare una sessione.

Payment Methods

Metodi di pagamento supportati e opzioni di configurazione.
I link di checkout generati tramite la Checkout Sessions API non sono riutilizzabili e scadono entro 24 ore. Genera una nuova sessione per ogni cliente e 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.

Come funziona

  1. Abilita: abilita Adaptive Currency da Impostazioni → Attività
  2. Seleziona: i clienti possono cambiare valuta direttamente nel checkout
  3. Converti: i prezzi vengono convertiti dinamicamente utilizzando tassi FX in tempo reale
  4. Mostra: l’importo finale da pagare viene mostrato in modo trasparente prima del pagamento
Selettore della valuta nel checkout

Adaptive Currency

Scopri di più sulle valute supportate, sulle commissioni di conversione e sulla gestione dei rimborsi.

Checkout multilingua

Dodo Payments supporta più lingue nella pagina di checkout, consentendo ai clienti di completare i pagamenti nella lingua con cui si sentono più a loro agio.
Selettore della lingua nel checkout

Punti salienti

  • Selettore della lingua disponibile direttamente nel checkout
  • Testo dell’interfaccia, etichette e messaggi di sistema localizzati
  • Migliora l’accessibilità e la conversione internazionale

Lingue supportate

La pagina di checkout supporta 21 lingue:
Puoi imporre una lingua specifica nel checkout impostando il parametro force_language durante la creazione di una sessione di checkout. Consulta la Checkout Sessions API per maggiori dettagli.

Calcolo automatico delle imposte

Le imposte vengono calcolate automaticamente in base alla località di fatturazione del cliente, garantendo la conformità ai requisiti GST, VAT e alle imposte sulle vendite senza configurazione manuale.

Come funziona il calcolo delle imposte

1

Location Detection

Le regole fiscali vengono applicate in base al paese del cliente (e alla regione, ove applicabile).
2

Dynamic Updates

L’importo delle imposte si aggiorna automaticamente quando:
  • Cambia il paese
  • L’indirizzo viene aggiornato
3

Transparent Display

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 aziende registrate, il checkout consente ai clienti di inserire il proprio Business Tax ID (ad es. numero VAT/GST).

Cosa succede quando viene inserito un Tax ID

  • L’idoneità fiscale viene convalidata in tempo reale
  • Vengono applicate le esenzioni fiscali o le regole di reverse charge pertinenti
  • L’importo delle imposte si aggiorna istantaneamente nel checkout
Inserimento del Business Tax ID nel checkout
Questo è particolarmente utile per SaaS B2B e servizi digitali in cui i clienti aziendali possono avere diritto a esenzioni fiscali.

Codici sconto

I clienti possono applicare direttamente nella pagina di checkout i codici sconto o promozionali che hai creato nella dashboard.

Esperienza di checkout

  1. Il cliente inserisce il codice sconto
  2. Lo sconto viene convalidato istantaneamente
  3. Il prezzo aggiornato e il risparmio vengono mostrati chiaramente
Inserimento del codice sconto nel checkout

Integrazione API

Applica in anticipo uno o più codici sconto cumulativi oppure abilita il campo di inserimento dello sconto:
discount_codes accetta un array contenente fino a 20 codici, applicati cumulativamente nell’ordine. Il campo singolare discount_code è deprecato, ma continua a funzionare: le integrazioni esistenti non devono essere modificate immediatamente. Esegui la migrazione a discount_codes quando preferisci, per utilizzare il concatenamento e una struttura della risposta più completa.

Discount Codes

Scopri come creare e gestire 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 completare più rapidamente la procedura.

Opzioni disponibili

La raccolta degli indirizzi bilancia velocità, accuratezza e copertura globale per massimizzare la conversione garantendo al contempo la conformità.

Modalità indirizzo minimo

Per massimizzare la conversione, abilita la raccolta dell’indirizzo minimo per ridurre gli ostacoli nel checkout. Quando minimal_address è impostato su true, il checkout raccoglie solo:
  • Paese — sempre richiesto per determinare le imposte
  • CAP/Codice postale — solo nelle regioni in cui è necessario per il calcolo delle imposte sulle vendite, VAT o GST
Tutti gli altri campi dell’indirizzo (via, città, stato) vengono ignorati, velocizzando notevolmente il completamento del checkout.
Modalità indirizzo minimo che mostra solo i campi del paese e del CAP/codice postale nel checkout
La raccolta dell’indirizzo completo rimane l’impostazione predefinita. Abilita minimal_address per prodotti digitali e flussi SaaS in cui non sono richiesti dati di fatturazione completi.

Minimal Address Reference

Consulta il riferimento completo al parametro minimal_address nella guida Checkout Sessions API.

Raccolta del numero di telefono

Controlla se il campo del numero di telefono viene visualizzato nel checkout e se è obbligatorio utilizzando i flag delle funzionalità della sessione di checkout.
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.
Utilizza require_phone_number per SaaS B2B, settori regolamentati o qualsiasi flusso in cui sia necessario un canale di contatto verificato per l’assistenza, la revisione delle frodi o la conformità.

Campi personalizzati

Raccogli ulteriori informazioni dai clienti durante il checkout definendo campi modulo personalizzati. Questa funzione è utile per raccogliere dati come il nome dell’azienda, le dimensioni del team, la fonte di referral o qualsiasi altra informazione specifica dell’attività.

Tipi di campo disponibili

Esempio

Le risposte dei clienti vengono incluse automaticamente nei payload 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

Scopri di più sulla configurazione dei campi personalizzati e sull’accesso alle risposte.

Accettazione dell’Informativa sulla privacy e dei Termini

Per garantire trasparenza legale e in materia di conformità:
Questo contribuisce a soddisfare i requisiti globali in materia di tutela dei consumatori e privacy dei dati, inclusa la conformità al GDPR.

Checkout delle raccolte

Le raccolte di prodotti consentono un’esperienza di checkout unificata, in cui i clienti possono visualizzare e selezionare più prodotti correlati (ad es. piani Starter, Pro ed Enterprise) in un unico checkout.

Come funziona

  1. Tutti i prodotti visualizzati: i clienti vedono ogni prodotto attivo nella raccolta
  2. Primo prodotto preselezionato: il primo prodotto della raccolta viene selezionato automaticamente
  3. Confronto delle opzioni: i clienti possono confrontare prezzi e funzionalità prima di scegliere
  4. Selezione singola: dopo aver selezionato un prodotto, il checkout prosegue con il normale flusso di pagamento

Creazione di un checkout per una raccolta

Quando utilizzi product_collection_id, passa un array product_cart vuoto. I codici sconto non possono essere applicati in anticipo durante la creazione della sessione.

Product Collections

Scopri come creare e gestire le raccolte di prodotti per esperienze di checkout unificate.

Configurazione della sessione di checkout

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

Checkout Sessions API

Riferimento API completo per le sessioni di checkout.

Checkout Integration Guide

Guida dettagliata all’integrazione del checkout.

Personalizzazione del tema del checkout

Personalizza l’aspetto della pagina di checkout in modo che corrisponda al tuo brand utilizzando il parametro customization.theme_config durante la creazione di una sessione di checkout tramite API. Configura colori, font, raggio dei bordi e testo del pulsante per le modalità chiara e scura.
Pagina di checkout con tema personalizzato

Design & Theme Customization

Configura visivamente i temi dalla dashboard con temi predefiniti, tipografia, colori e anteprima in tempo reale.
Questa sezione tratta la configurazione del tema tramite server-side API utilizzando customization.theme_config. Se utilizzi il Checkout SDK (checkout overlay o inline), consulta la sezione sulla personalizzazione del tema in Overlay Checkout, che utilizza proprietà camelCase (ad es. bgPrimary invece di bg_primary).

Opzioni di configurazione del tema

Configurazione dei colori (modalità chiara/scura)

Ogni modalità (light e dark) supporta le seguenti proprietà dei colori:
Tutti i campi dei colori 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 con nome: red, blue, transparent

Esempio

Non è necessario specificare tutte le proprietà dei colori. Le proprietà non specificate utilizzeranno i valori del tema predefinito.
Ultima modifica il 31 luglio 2026