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:

Portafoglio	Disponibilità	Valute	Abbonamenti	Configurazione richiesta
Apple Pay	Globale (eccetto l’India)	Tutte	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.
Protocollo: la pagina deve essere caricata tramite HTTPS.
Dominio: per il checkout inline, il dominio deve essere verificato con Apple.

Verifica del dominio

La verifica del dominio è necessaria solo per il checkout inline (incorporato). Il checkout ospitato e i link di pagamento mostrano Apple Pay senza questa verifica.

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

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 nelle 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

Rendi il file disponibile 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 che mostrano lo stato Active e gli 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 test.

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. Checkout non mostra Google Pay in Safari o in qualsiasi 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, Consenti ai siti di verificare se hai metodi di pagamento salvati deve essere attivata.

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 processore 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 dalle 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à test, i pagamenti tramite portafoglio 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à test.

Add a Card to Apple Wallet

Aggiungi una carta reale ad Apple Wallet. In modalità 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 sia pubblicata tramite HTTPS.

Test di Google Pay

Join the Test Card Group

Partecipa al gruppo di test delle carte Google Pay per aggiungere carte di test al tuo portafoglio.

Enable Test Mode

Usa le chiavi API create in modalità 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à 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 portafogli dipende dal modo in cui presenti il checkout.

SDK Web

I portafogli digitali funzionano in:

Checkout overlay, eccetto Apple Pay.
Checkout inline. Apple Pay richiede la verifica del dominio.
Integrazione diretta con API e 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 portafoglio digitale. Includi credit e debit in allowed_payment_method_types.

Test on real devices

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

Handle wallet unavailability

Un portafoglio 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

Verifica:

Per il checkout inline, il dominio è verificato in Manage domains?
La pagina viene caricata tramite HTTPS?
Il dispositivo usa 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 pubblica 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 Pending di solito presenta un file che Dodo Payments non riesce a recuperare come previsto.Verifica:

Il file è raggiungibile all’indirizzo https://<your-domain>/.well-known/apple-developer-merchantid-domain-association.
Viene pubblicato 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 pubblicato 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 confermare che il file sia raggiungibile pubblicamente, richiedi l’URL dall’esterno della tua rete, ad esempio in una finestra di navigazione privata. Le password di staging, i blocchi di autenticazione e le regole del firewall spesso consentono alla richiesta di avere esito positivo per te, ma non 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

Verifica:

Il cliente sta utilizzando un browser supportato? Google Pay non viene visualizzato in Safari o in qualsiasi browser su iOS.
Il cliente ha delle carte in Google Pay?
L’impostazione di Chrome Consenti ai siti di verificare se hai metodi di pagamento salvati è attivata?
google_pay è incluso in allowed_payment_method_types?

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

Wallet payment failed

Cause comuni:

La carta nel portafoglio è 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 portafoglio o di usare un metodo di pagamento diverso.

Wrong device type

I portafogli 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

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

​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

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