Vai al contenuto principale
I portafogli digitali consentono ai clienti di pagare con un solo tap utilizzando i metodi di pagamento salvati sui loro dispositivi. Offrono tassi di conversione più elevati, maggiore sicurezza tramite tokenizzazione e un’esperienza di checkout semplificata.

​
Portafogli Supportati

PortafoglioDisponibilitàValuteAbbonamentiConfigurazione Necessaria
Apple PayGlobale (escl. India)TutteSìVerifica del dominio
Google PayGlobale (escl. India)TutteSìNessuna
Amazon PayGlobale (escl. India)USDNoNessuna
Cash App PaySolo negli Stati UnitiUSDNoNessuna
RevolutPayGlobaleGBPNoNessuna
Supporto PayPal Pausato: PayPal è temporaneamente non disponibile per nuove transazioni.

​
Apple Pay

Apple Pay consente ai clienti di pagare utilizzando le carte salvate nel loro Apple Wallet, con autenticazione Face ID o Touch ID.

​
Requisiti

  • Dispositivi: iOS 17+, iPadOS 17+, Safari 17+ su macOS
  • **Protocollo:**HTTPS richiesto
  • Dominio: Deve essere verificato con Apple

​
Verifica del Dominio

1

Scarica il file di associazione del dominio

Scarica il file di associazione del dominio Apple Pay.
2

Hosta il file sul tuo dominio

Carica sul tuo server a:
https://yourdomain.com/.well-known/apple-developer-merchantid-domain-association
Il file deve essere accessibile senza reindirizzamenti e servito con Content-Type: application/octet-stream o text/plain.
3

Richiesta di attivazione

Invia un’email a support@dodopayments.com con:
  • Il tuo dominio in produzione (es. https://yourdomain.com)
  • Conferma che il file è ospitato
Verificheremo e abiliteremo Apple Pay entro 1-2 giorni lavorativi.
4

Testa l'integrazione

Dopo la conferma:
  1. Apri il checkout su un dispositivo Apple
  2. Verifica che il pulsante Apple Pay appaia
  3. Completa una transazione di test
Apple Pay non apparirà nel checkout fino a quando la verifica del dominio non sarà completata. Pianifica questo al momento del lancio.

​
Configurazione

const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'prod_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 utilizzando le carte salvate nel loro account Google, con protezione antifrode integrata.

​
Requisiti

  • Browser: Chrome (desktop/mobile), Safari, Firefox
  • Dispositivi: Dispositivi Android con l’app Google Pay
  • Impostazioni: “Consenti ai siti di controllare se hai metodi di pagamento” attivato in Chrome

​
Configurazione

const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'prod_123', quantity: 1 }],
  allowed_payment_method_types: ['google_pay', 'credit', 'debit'],
  return_url: 'https://example.com/success'
});
Nessuna verifica del dominio necessaria per Google Pay: funziona automaticamente una volta che il tuo account è attivo.

​
Amazon Pay

Amazon Pay consente ai clienti di utilizzare le credenziali del loro account Amazon e i metodi di pagamento salvati per un’esperienza di checkout familiare.

​
Limitazioni

  • Valuta: Solo USD
  • Abbonamenti: Non supportati
  • Regione: Non disponibile in India

​
Configurazione

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

​
Cash App Pay

Cash App Pay consente pagamenti tramite Cash App, popolare tra i consumatori statunitensi per pagamenti tra pari.

​
Limitazioni

  • Regione: Solo Stati Uniti
  • Valuta: Solo USD
  • Abbonamenti: Non supportati

​
Configurazione

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

​
RevolutPay

RevolutPay consente pagamenti rapidi e senza soluzione di continuità per gli utenti Revolut a livello globale, sfruttando il loro saldo esistente del conto Revolut o le carte collegate.

​
Limitazioni

  • Valuta: Solo GBP
  • Abbonamenti: Non supportati

​
Configurazione

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

​
Test

​
Test di Apple Pay

1

Usa la modalità di test

Abilita la modalità di test nel tuo dashboard Dodo Payments.
2

Aggiungi una carta all'Apple Wallet

Aggiungi una carta reale al tuo Apple Wallet. In modalità di test, la carta non verrà addebitata.
3

Completa l'acquisto di test

Apri il checkout su un dispositivo Apple e completa il flusso di Apple Pay.
Apple Pay richiede HTTPS. Non apparirà su localhost senza una corretta configurazione SSL.

​
Test di Google Pay

1

Unisciti al gruppo di test delle carte

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

Abilita la modalità di test

Usa le tue chiavi API di test di Dodo Payments.
3

Completa l'acquisto di test

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

​
Amazon Pay e Cash App Pay

Usa le tue chiavi API di test e segui il flusso di checkout standard. Le transazioni di test saranno simulate senza addebiti effettivi.

​
Supporto SDK

​
SDK Web

Tutti i portafogli digitali sono completamente supportati in:
  • Overlay Checkout
  • Inline Checkout
  • Integrazione diretta API

​
SDK Mobile

Limitazione di React Native: Apple Pay, Google Pay, Cash App Pay e UPI non sono attualmente supportati nell’SDK React Native. Usa l’overlay di checkout basato sul web per le app mobili che necessitano di questi metodi.
Per il supporto mobile nativo, considera:
  • Aprire il checkout in una WebView
  • Usare il Overlay Checkout in un contesto web
  • Implementare separatamente gli SDK di Apple Pay / Google Pay nativi per la piattaforma

​
Migliori Pratiche

Gli utenti mobili si aspettano Apple Pay e Google Pay. Mostra queste opzioni in modo prominente nei checkout mobili.
Apple Pay richiede la verifica del dominio. Non aspettare il giorno del lancio: inizia il processo durante lo sviluppo.
Non tutti i clienti hanno portafogli digitali. Includi sempre credit e debit nei tuoi metodi consentiti.
I simulatori non replicano completamente il comportamento del portafoglio. Testa su veri dispositivi iOS e Android prima del lancio.
Se un portafoglio non è disponibile (dispositivo errato, nessuna carta salvata), assicurati che altre opzioni di pagamento siano visibili.

​
Risoluzione dei Problemi

Controlla:
  1. Dominio verificato con Dodo Payments?
  2. Uso di HTTPS?
  3. Il dispositivo è iOS 17+ / Safari 17+ / iPadOS 17+?
  4. Il cliente ha carte in Apple Wallet?
  5. apple_pay incluso in allowed_payment_method_types?
Soluzione: Completa la verifica del dominio e assicurati di utilizzare HTTPS. Testa su un vero dispositivo Apple.
Controlla:
  1. Uso di Chrome o browser compatibile?
  2. Il cliente ha carte in Google Pay?
  3. Impostazione di Chrome “Consenti ai siti di controllare i metodi di pagamento” attivata?
  4. google_pay incluso in allowed_payment_method_types?
Soluzione: Verifica la compatibilità del browser e la configurazione di Google Pay del cliente.
Cause comuni:
  • Carta nel portafoglio scaduta o non valida
  • La banca ha rifiutato la transazione
  • Problema di connettività di rete
Soluzione: Il cliente deve verificare la carta nel proprio portafoglio o provare un metodo di pagamento diverso.
I portafogli digitali appaiono solo su dispositivi compatibili:
  • Apple Pay: solo dispositivi Apple
  • Google Pay: browser Chrome o dispositivi Android
Soluzione: Questo è un comportamento atteso. Assicurati che i fallback per le carte siano disponibili.

​
Pagine Correlate

Panoramica dei Metodi di Pagamento

Vedi tutti i metodi di pagamento supportati.

Overlay Checkout

Implementa il checkout con supporto per i portafogli digitali.

Processo di Test

Guida completa ai test per tutti i metodi di pagamento.

Integrazione React Native

Documentazione SDK mobile e limitazioni.