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 sospeso: PayPal è temporaneamente indisponibile 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

Download the domain association file

Scarica il file di associazione del dominio Apple Pay.
2

Host the file on your domain

Carica sul tuo server in:
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

Request activation

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

Test the integration

Dopo la conferma:
  1. Apri il checkout su un dispositivo Apple
  2. Verifica che venga visualizzato il pulsante Apple Pay
  3. Completa una transazione di prova
Apple Pay non apparirà nel checkout finché la verifica del dominio non sarà completa. Pianifica questo aspetto quando effettui il 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'
});
Non è necessaria la verifica del dominio 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

Use test mode

Abilita la modalità di test nella dashboard di Dodo Payments.
2

Add a card to Apple Wallet

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

Complete test purchase

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

​
Test di Google Pay

1

Join the test card group

Iscriviti al gruppo di test delle carte Google Pay per aggiungere automaticamente le carte di prova al tuo wallet.
2

Enable test mode

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

Complete test purchase

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. Utilizza la sovrapposizione di checkout 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 primo piano nei checkout mobili.
Apple Pay richiede la verifica del dominio. Non aspettare il giorno del lancio: avvia il processo durante lo sviluppo.
Non tutti i clienti hanno wallet digitali. Includi sempre credit e debit nei metodi consentiti.
I simulatori non riproducono completamente il comportamento del wallet. Testa su dispositivi iOS e Android reali prima del lancio.
Se un wallet non è disponibile (dispositivo errato, carte non salvate), assicurati che altre opzioni di pagamento siano visibili.

​
Risoluzione dei Problemi

Verifica:
  1. Dominio verificato con Dodo Payments?
  2. Stai usando 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 usare HTTPS. Testa su un dispositivo Apple reale.
Verifica:
  1. Stai usando Chrome o un browser compatibile?
  2. Il cliente ha carte in Google Pay?
  3. L’impostazione di Chrome “Consenti ai siti di controllare i metodi di pagamento” è abilitata?
  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:
  • La carta nel wallet è scaduta o non valida
  • La banca ha rifiutato la transazione
  • Problema di connettività di rete
Soluzione: Il cliente dovrebbe verificare la carta nel wallet o provare un metodo di pagamento diverso.
I wallet digitali appaiono solo su dispositivi compatibili:
  • Apple Pay: solo dispositivi Apple
  • Google Pay: browser Chrome o dispositivi Android
Soluzione: Questo comportamento è previsto. Assicurati di avere alternative di carta disponibili.

​
Pagine Correlate

Payment Methods Overview

Consulta tutti i metodi di pagamento supportati.

Overlay Checkout

Implementa il checkout con supporto ai wallet digitali.

Testing Process

Guida completa ai test per tutti i metodi di pagamento.

React Native Integration

Documentazione e limitazioni dell’SDK mobile.