> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dodopayments.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Portafogli Digitali

> Accetta Apple Pay, Google Pay, Amazon Pay, Cash App Pay e RevolutPay per un pagamento rapido e sicuro con un solo tap. Scopri come configurare, verificare il dominio e testare.

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

| Portafoglio      | Disponibilità          | Valute | Abbonamenti | Configurazione Necessaria |
| :--------------- | :--------------------- | :----- | :---------: | :------------------------ |
| **Apple Pay**    | Globale (escl. India)  | Tutte  |      Sì     | Verifica del dominio      |
| **Google Pay**   | Globale (escl. India)  | Tutte  |      Sì     | Nessuna                   |
| **Amazon Pay**   | Globale (escl. India)  | USD    |      No     | Nessuna                   |
| **Cash App Pay** | Solo negli Stati Uniti | USD    |      No     | Nessuna                   |
| **RevolutPay**   | Globale                | GBP    |      No     | Nessuna                   |

<Warning>
  **Supporto PayPal sospeso:** PayPal è temporaneamente indisponibile per nuove transazioni.
</Warning>

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

<Steps>
  <Step title="Download the domain association file">
    Scarica il [file di associazione del dominio Apple Pay](https://checkout.dodopayments.com/.well-known/apple-developer-merchantid-domain-association).
  </Step>

  <Step title="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`.
  </Step>

  <Step title="Request activation">
    Invia un'email a **[support@dodopayments.com](mailto: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.
  </Step>

  <Step title="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
  </Step>
</Steps>

<Warning>
  Apple Pay non apparirà nel checkout finché la verifica del dominio non sarà completa. Pianifica questo aspetto quando effettui il lancio.
</Warning>

### Configurazione

```javascript theme={null}
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

```javascript theme={null}
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'
});
```

<Info>
  Non è necessaria la verifica del dominio per Google Pay: funziona automaticamente una volta che il tuo account è attivo.
</Info>

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

```javascript theme={null}
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

```javascript theme={null}
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

```javascript theme={null}
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

<Steps>
  <Step title="Use test mode">
    Abilita la modalità di test nella dashboard di Dodo Payments.
  </Step>

  <Step title="Add a card to Apple Wallet">
    Aggiungi una carta reale al tuo Apple Wallet. In modalità di test, la carta non verrà addebitata.
  </Step>

  <Step title="Complete test purchase">
    Apri il checkout su un dispositivo Apple e completa il flusso Apple Pay.
  </Step>
</Steps>

<Warning>
  Apple Pay richiede HTTPS. Non apparirà su `localhost` senza una configurazione SSL adeguata.
</Warning>

### Test di Google Pay

<Steps>
  <Step title="Join the test card group">
    [Iscriviti al gruppo di test delle carte Google Pay](https://groups.google.com/g/googlepay-test-mode-stub-data) per aggiungere automaticamente le carte di prova al tuo wallet.
  </Step>

  <Step title="Enable test mode">
    Usa le tue chiavi API di test di Dodo Payments.
  </Step>

  <Step title="Complete test purchase">
    Seleziona una delle carte di test in Google Pay per completare la transazione.
  </Step>
</Steps>

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

<Warning>
  **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.
</Warning>

Per il supporto mobile nativo, considera:

* Aprire il checkout in una WebView
* Usare il [Overlay Checkout](/developer-resources/overlay-checkout) in un contesto web
* Implementare separatamente gli SDK di Apple Pay / Google Pay nativi per la piattaforma

## Migliori Pratiche

<AccordionGroup>
  <Accordion title="Prioritize wallets on mobile">
    Gli utenti mobili si aspettano Apple Pay e Google Pay. Mostra queste opzioni in primo piano nei checkout mobili.
  </Accordion>

  <Accordion title="Complete domain verification early">
    Apple Pay richiede la verifica del dominio. Non aspettare il giorno del lancio: avvia il processo durante lo sviluppo.
  </Accordion>

  <Accordion title="Always include card fallbacks">
    Non tutti i clienti hanno wallet digitali. Includi sempre `credit` e `debit` nei metodi consentiti.
  </Accordion>

  <Accordion title="Test on real devices">
    I simulatori non riproducono completamente il comportamento del wallet. Testa su dispositivi iOS e Android reali prima del lancio.
  </Accordion>

  <Accordion title="Handle wallet unavailability gracefully">
    Se un wallet non è disponibile (dispositivo errato, carte non salvate), assicurati che altre opzioni di pagamento siano visibili.
  </Accordion>
</AccordionGroup>

## Risoluzione dei Problemi

<AccordionGroup>
  <Accordion title="Apple Pay button not appearing">
    **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.
  </Accordion>

  <Accordion title="Google Pay button not appearing">
    **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.
  </Accordion>

  <Accordion title="Wallet payment failed">
    **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.
  </Accordion>

  <Accordion title="Wrong device type">
    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.
  </Accordion>
</AccordionGroup>

## Pagine Correlate

<CardGroup cols={2}>
  <Card title="Payment Methods Overview" icon="credit-card" href="/features/payment-methods">
    Consulta tutti i metodi di pagamento supportati.
  </Card>

  <Card title="Overlay Checkout" icon="window-restore" href="/developer-resources/overlay-checkout">
    Implementa il checkout con supporto ai wallet digitali.
  </Card>

  <Card title="Testing Process" icon="flask" href="/miscellaneous/testing-process">
    Guida completa ai test per tutti i metodi di pagamento.
  </Card>

  <Card title="React Native Integration" icon="mobile" href="/developer-resources/react-native-integration">
    Documentazione e limitazioni dell’SDK mobile.
  </Card>
</CardGroup>