Digital Wallets

I portafogli digitali consentono ai clienti di pagare con una carta o un account già salvato sul dispositivo, senza dover inserire i dati della carta. Il portafoglio invia un token anziché il numero della carta e il cliente conferma il pagamento con un tocco o una verifica biometrica.

Supported Wallets

Dodo Payments mostra ogni portafoglio solo quando il checkout corrisponde al relativo paese, alla valuta e al tipo di pagamento:

Wallet	Disponibilità	Valute	Abbonamenti	Configurazione richiesta
Apple Pay	Globale, inclusa l’India	Tutte, incluso INR	Sì	Verifica del dominio per il checkout inline
Google Pay	Globale (eccetto l’India)	Tutte	Sì	Nessuna
Amazon Pay	Globale (eccetto l’India)	USD, EUR, GBP, AUD, CHF, DKK, HKD, JPY, NOK, NZD, SEK, ZAR	No	Nessuna
Cash App Pay	Solo Stati Uniti	USD	Sì	Nessuna
RevolutPay	Globale	GBP	No	Nessuna

PayPal non è temporaneamente disponibile per le nuove transazioni.

Apple Pay

Apple Pay consente ai clienti di pagare con le carte salvate in Apple Wallet e di confermare con Face ID o Touch ID.

Apple Pay viene mostrato per gli abbonamenti anche quando il primo addebito è di $0, ad esempio durante una prova gratuita, così il mandato di pagamento viene configurato al momento della registrazione. Per i pagamenti una tantum, Apple Pay viene mostrato solo quando l’importo è maggiore di $0.

Requisiti

Dispositivi: iOS 17 o versioni successive, iPadOS 17 o versioni successive oppure Safari 17 o versioni successive su macOS. In India, Apple richiede iPhone XR o versioni successive con iOS 18 o versioni successive.
Protocollo: la pagina deve essere caricata tramite HTTPS.
Dominio: per il checkout inline, il dominio deve essere verificato con Apple.

Apple Pay in India

I clienti in India possono pagare con Apple Pay nei checkout addebitati in INR. Apple Pay in India funziona alle seguenti condizioni:

Valuta: il checkout viene addebitato in INR. Un pagamento addebitato in INR deve rispettare il minimo per INR.
Carte: il cliente dispone in Apple Wallet di una carta emessa da una banca indiana che supporta Apple Pay. Apple stabilisce quali banche e carte sono idonee.
Desktop: in un browser desktop, i clienti possono scansionare un codice con il proprio iPhone e confermare il pagamento sul telefono.
Abbonamenti: gli abbonamenti Apple Pay in INR utilizzano i mandati RBI. Ogni addebito di rinnovo viene completato circa 48 ore dopo la data di rinnovo, come per le altre carte emesse in India.

Per addebitare un cliente in India in INR, segui i requisiti di Metodi di pagamento in India relativi al paese di fatturazione e ad Adaptive Currency.

Verifica del dominio

La verifica del dominio è richiesta solo per il checkout inline (incorporato). Il checkout ospitato e i payment link mostrano Apple Pay anche senza verifica.

Apple Pay non è disponibile nel checkout overlay. Per offrire Apple Pay, usa il checkout inline, il checkout ospitato o un payment link.

Per verificare un dominio per il checkout inline, segui questi passaggi nella dashboard:

Open Apple Pay Domains

Vai a Settings → Payment Methods. Nella riga Apple Pay, fai clic su Manage domains.

Pulsante Manage domains nella riga Apple Pay delle impostazioni Payment Methods — Open Apple Pay domains from the Apple Pay row

Download the Domain Association File

Nel pannello Apple Pay domains, fai clic su Download file.

Pannello Apple Pay domains con il pulsante Download file — Download the Apple Pay domain association file

Fai clic su Register domain, inserisci il dominio in cui incorpori il checkout (ad esempio, shop.example.com) e fai clic su Continue.

Modulo per registrare un dominio con un dominio inserito — Register the domain where you embed checkout

Host the File on Your Domain

Carica il file sul tuo server in questo percorso:

https://shop.example.com/.well-known/apple-developer-merchantid-domain-association

Servi il file tramite HTTPS, senza reindirizzamenti, con Content-Type: application/octet-stream o text/plain.

Verify the Domain

Fai clic su Verify domain. Dodo Payments controlla il file ospitato e invia il dominio ad Apple.

Schermata Verify your domain con il percorso del file di associazione ospitato e il pulsante Verify domain — Verify the hosted association file

Confirm It's Active

Quando lo stato mostra Active, Apple Pay è attivo su quel dominio. Per attivare o disattivare Apple Pay per un dominio, usa il relativo interruttore Enabled.

Elenco dei domini Apple Pay con domini aventi stato Active e interruttori Enabled — Verified domains show an Active status

Test the Integration

Apri il checkout su un dispositivo Apple.
Verifica che venga visualizzato il pulsante Apple Pay.
Completa una transazione di prova.

Configurazione

Per limitare una sessione di checkout ad Apple Pay e alle carte, passa allowed_payment_method_types:

// `client` is an initialized DodoPayments client.
const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'pdt_123', quantity: 1 }],
  allowed_payment_method_types: ['apple_pay', 'credit', 'debit'],
  return_url: 'https://example.com/success'
});

Google Pay

Google Pay consente ai clienti di pagare con le carte salvate nel proprio account Google.

Requisiti

Browser: Chrome su desktop e Android e Firefox su desktop. Il checkout non mostra Google Pay in Safari né in alcun browser su iOS. In questi browser, i clienti possono pagare con Apple Pay o con una carta.
Dispositivi: dispositivi Android con l’app Google Pay.
Impostazioni: in Chrome, Allow sites to check if you have payment methods saved deve essere attivato.

Configurazione

Per limitare una sessione di checkout a Google Pay e alle carte, passa allowed_payment_method_types:

// `client` is an initialized DodoPayments client.
const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'pdt_123', quantity: 1 }],
  allowed_payment_method_types: ['google_pay', 'credit', 'debit'],
  return_url: 'https://example.com/success'
});

Google Pay non richiede la verifica del dominio.

Amazon Pay

Amazon Pay consente ai clienti di completare il checkout con i metodi di pagamento salvati nel proprio account Amazon.

Disponibilità

Regione: globale, eccetto l’India.
Valute: USD, EUR, GBP, AUD, CHF, DKK, HKD, JPY, NOK, NZD, SEK, ZAR. Le valute offerte da un checkout dipendono dal processor che lo gestisce.
Abbonamenti: non supportati.

Configurazione

Per limitare una sessione di checkout ad Amazon Pay e alle carte, passa allowed_payment_method_types:

// `client` is an initialized DodoPayments client.
const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'pdt_123', quantity: 1 }],
  allowed_payment_method_types: ['amazon_pay', 'credit', 'debit'],
  return_url: 'https://example.com/success'
});

Cash App Pay

Cash App Pay consente ai clienti negli Stati Uniti di pagare dal proprio account Cash App.

Disponibilità

Regione: solo Stati Uniti. Il paese di fatturazione deve essere gli Stati Uniti.
Valuta: solo USD.
Abbonamenti: supportati.

Configurazione

Per limitare una sessione di checkout a Cash App Pay e alle carte, passa allowed_payment_method_types:

// `client` is an initialized DodoPayments client.
const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'pdt_123', quantity: 1 }],
  allowed_payment_method_types: ['cashapp', 'credit', 'debit'],
  return_url: 'https://example.com/success'
});

RevolutPay

RevolutPay consente agli utenti Revolut di pagare dal saldo del proprio account Revolut o con le carte collegate.

Disponibilità

Regione: globale.
Valuta: solo GBP.
Abbonamenti: non supportati.

Configurazione

Per limitare una sessione di checkout a RevolutPay e alle carte, passa allowed_payment_method_types:

// `client` is an initialized DodoPayments client.
const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'pdt_123', quantity: 1 }],
  allowed_payment_method_types: ['revolut_pay', 'credit', 'debit'],
  return_url: 'https://example.com/success'
});

Test

In modalità di test, i pagamenti tramite wallet seguono lo stesso flusso di checkout senza trasferire denaro reale.

Test di Apple Pay

Use Test Mode

Disattiva l’interruttore Live Mode nella barra laterale della dashboard e usa le chiavi API create in modalità di test.

Add a Card to Apple Wallet

Aggiungi una carta reale ad Apple Wallet. In modalità di test, la carta non viene addebitata.

Complete a Test Purchase

Apri il checkout su un dispositivo Apple e completa il flusso Apple Pay.

Apple Pay richiede HTTPS. Non viene visualizzato su localhost a meno che la pagina non venga servita tramite HTTPS.

Test di Google Pay

Join the Test Card Group

Unisciti al gruppo di carte di test di Google Pay per aggiungere carte di test al tuo wallet.

Enable Test Mode

Usa le chiavi API create in modalità di test.

Complete a Test Purchase

Seleziona una delle carte di test in Google Pay per completare la transazione.

Amazon Pay e Cash App Pay

Usa le chiavi API della modalità di test e segui il flusso di checkout standard. Le transazioni di test sono simulate e non viene effettuato alcun addebito reale.

Supporto SDK

La disponibilità dei wallet dipende dal modo in cui presenti il checkout.

SDK Web

I wallet digitali funzionano in:

Overlay Checkout, eccetto Apple Pay.
Inline Checkout. Apple Pay richiede la verifica del dominio.
Integrazione diretta tramite API con checkout ospitato.

SDK Mobile (Checkout)

Gli SDK di checkout Android, iOS, React Native e Flutter aprono il checkout ospitato di Dodo Payments nel browser di sistema della piattaforma (SFSafariViewController su iOS, Chrome Custom Tabs su Android), non in una WebView. Apple Pay e Google Pay funzionano allo stesso modo del web. Consulta la Guida all’integrazione mobile per la configurazione.

Best practice

Prioritize wallets on mobile

I clienti mobile si aspettano Apple Pay e Google Pay. Mostra queste opzioni in modo evidente nei checkout mobile.

Complete domain verification early

Se usi il checkout inline, verifica il dominio per Apple Pay durante lo sviluppo, non il giorno del lancio.

Always include card fallbacks

Non tutti i clienti hanno un wallet digitale. Includi credit e debit in allowed_payment_method_types.

Test on real devices

I simulatori non riproducono completamente il comportamento dei wallet. Esegui i test su dispositivi iOS e Android reali prima del lancio.

Handle wallet unavailability

Un wallet non viene visualizzato su un dispositivo non supportato o quando il cliente non ha carte salvate. Mantieni visibili gli altri metodi di pagamento per questi clienti.

Risoluzione dei problemi

Apple Pay button not appearing

Controlla:

Per il checkout inline, il dominio è verificato in Manage domains?
La pagina viene caricata tramite HTTPS?
Il dispositivo utilizza iOS 17, iPadOS 17 o Safari 17 o versioni successive?
Il cliente ha carte in Apple Wallet?
apple_pay è incluso in allowed_payment_method_types?
Il checkout è un overlay? Apple Pay non è disponibile nel checkout overlay.

Soluzione: completa la verifica del dominio e servi la pagina tramite HTTPS. Esegui il test su un dispositivo Apple reale.

Apple Pay domain stuck on Pending

Dopo aver fatto clic su Verify domain, Dodo Payments recupera il file di associazione dal tuo dominio e invia il dominio ad Apple. Un dominio che rimane su Pending solitamente presenta un file che Dodo Payments non riesce a recuperare come previsto.Controlla:

Il file è raggiungibile all’indirizzo https://<your-domain>/.well-known/apple-developer-merchantid-domain-association.
Viene servito tramite HTTPS con un certificato valido.
Viene risolto senza reindirizzamenti. Un reindirizzamento a www, a un altro host o a una pagina di errore non supera il controllo.
Viene servito come Content-Type: application/octet-stream o text/plain, non come text/html.
È il file scaricato da Manage domains per questa attività, non uno riutilizzato da un altro account o provider.

Per verificare che il file sia raggiungibile pubblicamente, richiedi l’URL al di fuori della tua rete, ad esempio in una finestra di navigazione privata. Le password di staging, i sistemi di autenticazione e le regole del firewall spesso consentono alla richiesta di riuscire per te, ma di fallire per Dodo Payments.Soluzione: risolvi il problema di hosting, quindi fai nuovamente clic su Verify domain. Se il dominio non diventa Active dopo un controllo completato correttamente, contatta support@dodopayments.com indicando il nome del dominio.

Google Pay button not appearing

Controlla:

Il cliente sta utilizzando un browser supportato? Google Pay non viene visualizzato in Safari né in alcun browser su iOS.
Il cliente ha carte in Google Pay?
L’impostazione di Chrome Allow sites to check if you have payment methods saved è attiva?
google_pay è incluso in allowed_payment_method_types?

Soluzione: controlla il browser e la configurazione di Google Pay del cliente.

Wallet payment failed

Cause comuni:

La carta nel wallet è scaduta o non valida.
La banca ha rifiutato la transazione.
Un problema di connessione di rete ha interrotto il pagamento.

Soluzione: chiedi al cliente di controllare la carta nel wallet o di utilizzare un metodo di pagamento diverso.

Wrong device type

I wallet digitali vengono visualizzati solo sui dispositivi compatibili:

Apple Pay: solo dispositivi Apple.
Google Pay: dispositivi Chrome o Android.

Soluzione: è un comportamento previsto. Mantieni disponibili i pagamenti con carta come alternativa.

Pagine correlate

Payment Methods Overview

Tutti i metodi di pagamento supportati.

Overlay Checkout

Apri il checkout come overlay sulla tua pagina.

Testing Process

Dati di test per ogni metodo di pagamento.

Mobile Integration Guide

Apri il checkout ospitato nel browser di sistema, dove Apple Pay e Google Pay funzionano come sul web.

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

Supported Wallets

Apple Pay

Requisiti

Apple Pay in India

Verifica del dominio

Configurazione

Google Pay

Requisiti

Configurazione

Amazon Pay

Disponibilità

Configurazione

Cash App Pay

Disponibilità

Configurazione

RevolutPay

Disponibilità

Configurazione

Test

Test di Apple Pay

Test di Google Pay

Amazon Pay e Cash App Pay

Supporto SDK

SDK Web

SDK Mobile (Checkout)

Best practice

Risoluzione dei problemi

Pagine correlate

Payment Methods Overview

Overlay Checkout

Testing Process

Mobile Integration Guide

​Supported Wallets

​Apple Pay

​Requisiti

​Apple Pay in India

​Verifica del dominio

​Configurazione

​Google Pay

​Requisiti

​Configurazione

​Amazon Pay

​Disponibilità

​Configurazione

​Cash App Pay

​Disponibilità

​Configurazione

​RevolutPay

​Disponibilità

​Configurazione

​Test

​Test di Apple Pay

​Test di Google Pay

​Amazon Pay e Cash App Pay

​Supporto SDK

​SDK Web

​SDK Mobile (Checkout)

​Best practice

​Risoluzione dei problemi

​Pagine correlate

Payment Methods Overview

Overlay Checkout

Testing Process

Mobile Integration Guide

Supported Wallets

Apple Pay

Requisiti

Apple Pay in India

Verifica del dominio

Configurazione

Google Pay

Requisiti

Configurazione

Amazon Pay

Disponibilità

Configurazione

Cash App Pay

Disponibilità

Configurazione

RevolutPay

Disponibilità

Configurazione

Test

Test di Apple Pay

Test di Google Pay

Amazon Pay e Cash App Pay

Supporto SDK

SDK Web

SDK Mobile (Checkout)

Best practice

Risoluzione dei problemi

Pagine correlate