Vai al contenuto principale
Pagina di pagamento
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.

Valuta Adattiva

La Valuta Adattiva consente ai clienti di pagare nella loro valuta locale preferita, migliorando la fiducia e i tassi di conversione.

Come Funziona

  1. Abilita: Abilita la Valuta Adattiva dalle Impostazioni Aziendali
  2. Seleziona: I clienti possono cambiare valuta direttamente al checkout
  3. Converti: I prezzi vengono convertiti dinamicamente utilizzando tassi di cambio in tempo reale
  4. Visualizza: 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, le commissioni di conversione e la gestione dei rimborsi.

Checkout Multilingue

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

Punti Chiave

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

Lingue Supportate

La pagina di checkout supporta 21 lingue:
LinguaCodice
Araboar
Catalanoca
Cinesezh
Olandesenl
Ingleseen
Francesefr
Tedescode
Ebraicohe
Indonesianoid
Italianoit
Giapponeseja
Coreanoko
Malesems
Polaccopl
Portoghesept
Rumenoro
Russoru
Spagnoloes
Svedesesv
Tailandeseth
Turcotr
Puoi forzare una lingua specifica nel checkout impostando il parametro force_language durante la creazione di una sessione di checkout. Consulta l’API Checkout Sessions per maggiori dettagli.

Calcolo automatico delle tasse

Le tasse vengono calcolate automaticamente in base alla località di fatturazione del cliente, garantendo la conformità a GST, IVA e imposte sulle vendite senza configurazioni manuali.

Come funziona il calcolo delle tasse

1

Location Detection

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

Dynamic Updates

L’importo delle tasse si aggiorna automaticamente quando:
  • Cambia il paese
  • Viene aggiornato l’indirizzo
3

Transparent Display

La ripartizione finale delle tasse viene mostrata chiaramente prima del pagamento.
Il calcolo delle tasse è completamente automatico. Non è necessaria alcuna configurazione manuale per beni digitali standard e prodotti SaaS.

Supporto per l’ID fiscale aziendale

Per le aziende registrate, il checkout consente ai clienti di inserire il proprio ID fiscale aziendale (ad esempio, numero IVA/GST).

Cosa succede quando viene inserito un ID fiscale

  • L’idoneità fiscale viene convalidata in tempo reale
  • Vengono applicate eventuali esenzioni fiscali o regole di inversione contabile
  • L’importo delle tasse si aggiorna istantaneamente durante il checkout
Inserimento dell'ID fiscale aziendale nel checkout
Questo è particolarmente utile per SaaS B2B e servizi digitali in cui i clienti business possono essere idonei a esenzioni fiscali.

Codici sconto

I clienti possono applicare codici sconto o promozionali creati nella dashboard direttamente nella pagina di checkout.

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

Pre-applica un codice sconto o abilita il campo di inserimento dello sconto:
const session = await client.checkoutSessions.create({
  product_cart: [
    { product_id: 'prod_abc', quantity: 1 }
  ],
  discount_code: 'WELCOME20', // Pre-apply a code
  feature_flags: {
    allow_discount_code: true // Show discount input field
  },
  return_url: 'https://yoursite.com/return'
});

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 un inserimento flessibile degli indirizzi per completare più rapidamente il processo.

Opzioni disponibili

OpzioneDescrizione
Google Address AutofillSelezione rapida con completamento automatico
Inserimento manualeControllo completo per indirizzi dettagliati
Selezione del paeseGuida la logica fiscale e di conformità
La raccolta degli indirizzi bilancia velocità, precisione e copertura globale per massimizzare la conversione assicurando la conformità.

Campi personalizzati

Raccogli informazioni aggiuntive dai clienti durante il checkout definendo campi modulo personalizzati. Questo è utile per ottenere dati come nome dell’azienda, dimensioni del team, fonte di riferimento o qualsiasi altra informazione aziendale specifica.

Tipi di campo disponibili

TipoDescrizione
textCampo di testo a riga singola
numberCampo numerico
emailIndirizzo email con convalida
urlURL con convalida
dateSelettore di date
dropdownSeleziona tra opzioni predefinite
booleanInterruttore Sì/No

Esempio

const session = await client.checkoutSessions.create({
  product_cart: [
    { product_id: 'prod_abc', quantity: 1 }
  ],
  custom_fields: [
    {
      key: 'company_name',
      label: 'Company Name',
      field_type: 'text',
      required: true
    },
    {
      key: 'team_size',
      label: 'Team Size',
      field_type: 'dropdown',
      required: true,
      options: ['1-10', '11-50', '51-200', '200+']
    }
  ],
  return_url: 'https://yoursite.com/return'
});
Le risposte dei clienti sono 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 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 di conformità:
  • I link a Privacy Policy e a Buyer Terms sono chiaramente visualizzati nel checkout
  • I clienti li riconoscono esplicitamente prima di completare il pagamento
Questo aiuta a soddisfare i requisiti globali di protezione dei consumatori e privacy dei dati, inclusa la conformità GDPR.

Checkout per collezioni

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

Come funziona

  1. Tutti i prodotti visualizzati: i clienti vedono tutti i prodotti attivi nella collezione
  2. Primo prodotto pre-selezionato: il primo prodotto nella collezione viene selezionato automaticamente
  3. Confronta le opzioni: i clienti possono confrontare prezzi e funzionalità prima di scegliere
  4. Selezione singola: dopo aver selezionato un prodotto, il checkout procede con il flusso di pagamento standard

Creazione di un checkout per collezioni

const session = await client.checkoutSessions.create({
  product_collection_id: 'pdc_abc123',
  product_cart: [], // Required: pass an empty array for collection checkout
  return_url: 'https://yoursite.com/return'
});
Quando usi product_collection_id, passa un array product_cart vuoto. I codici sconto non possono essere pre-applicati alla creazione della sessione.

Product Collections

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

Configurazione della sessione di checkout

Controlla il comportamento del checkout utilizzando l’API Checkout Sessions:
const session = await client.checkoutSessions.create({
  product_cart: [
    { product_id: 'prod_abc', quantity: 1 }
  ],
  customer: {
    email: 'customer@example.com',
    name: 'Jane Doe'
  },
  billing_currency: 'EUR', // Set specific currency
  discount_code: 'PROMO10',
  feature_flags: {
    allow_discount_code: true
  },
  return_url: 'https://yoursite.com/return',
  metadata: {
    order_ref: 'ORD-12345'
  }
});
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 Checkout Sessions per l’elenco completo.

Personalizzazione del tema del checkout

Personalizza l’aspetto della pagina di checkout per allinearla 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 dei pulsanti per modalità chiare e scure.
Pagina di checkout con tema personalizzato

Design & Theme Customization

Configura i temi visivamente dalla dashboard con temi predefiniti, tipografia, colori e anteprima live.
Questa sezione copre la configurazione del tema tramite API lato server usando customization.theme_config. Se stai utilizzando il Checkout SDK (checkout overlay o inline), consulta le sezioni di personalizzazione del tema in Overlay Checkout o Inline Checkout che utilizzano proprietà camelCase (ad esempio bgPrimary invece di bg_primary).

Opzioni di configurazione del tema

PropertyDescription
lightConfigurazione dei colori per la modalità chiara
darkConfigurazione dei colori per la modalità scura
font_primary_urlURL per il font primario
font_secondary_urlURL per il font secondario
font_sizeDimensione del font: xs, sm, md, lg, xl, 2xl
font_weightPeso del font: normal, medium, bold, extraBold
radiusRaggio del bordo per gli elementi dell’interfaccia (es. 4px, 0.5rem, 8px)
pay_button_textTesto personalizzato per il pulsante di pagamento (es. “Complete Purchase”, “Subscribe Now”)

Configurazione del colore (modalità chiara/scura)

Ogni modalità (light e dark) supporta le seguenti proprietà colore:
PropertyDescription
bg_primaryColore di sfondo primario
bg_secondaryColore di sfondo secondario
text_primaryColore testo primario
text_secondaryColore testo secondario
text_placeholderColore segnaposto del testo
text_errorColore errore del testo
text_successColore successo del testo
border_primaryColore bordo primario
border_secondaryColore bordo secondario
button_primaryColore sfondo del pulsante primario
button_primary_hoverColore hover del pulsante primario
button_secondaryColore sfondo del pulsante secondario
button_secondary_hoverColore hover del pulsante secondario
button_text_primaryColore testo del pulsante primario
button_text_secondaryColore testo del pulsante secondario
input_focus_borderColore del bordo del focus dell’input
Tutti i campi colore accettano formati 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 nominati: red, blue, transparent

Esempio

const session = await client.checkoutSessions.create({
  product_cart: [
    { product_id: 'prod_abc', quantity: 1 }
  ],
  customization: {
    theme_config: {
      // Custom fonts
      font_primary_url: 'https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600&display=swap',
      font_size: 'md',
      font_weight: 'medium',
      radius: '8px',
      pay_button_text: 'Complete Purchase',
      
      // Light mode colors
      light: {
        bg_primary: '#ffffff',
        bg_secondary: '#f5f5f5',
        text_primary: '#1a1a1a',
        text_secondary: '#666666',
        button_primary: '#0066ff',
        button_primary_hover: '#0052cc',
        button_text_primary: '#ffffff',
        border_primary: '#e0e0e0'
      },
      
      // Dark mode colors
      dark: {
        bg_primary: '#1a1a1a',
        bg_secondary: '#2d2d2d',
        text_primary: '#ffffff',
        text_secondary: '#a0a0a0',
        button_primary: '#3385ff',
        button_primary_hover: '#4d99ff',
        button_text_primary: '#ffffff',
        border_primary: '#404040'
      }
    }
  },
  return_url: 'https://yoursite.com/return'
});
Non è necessario specificare tutte le proprietà colore. Le proprietà non specificate utilizzeranno i valori predefiniti del tema.