# Tap to Pay Come accettare pagamenti contactless su un dispositivo iPhone o Android compatibile Cerchi una soluzione no-code? [Accetta pagamenti dall’app per dispositivi mobili Dashboard Stripe](https://docs.stripe.com/no-code/in-person.md). # iPhone > This is a iPhone for when platform is ios. View the full page at https://docs.stripe.com/terminal/payments/setup-reader/tap-to-pay?platform=ios. Utilizza Tap to Pay su iPhone per accettare pagamenti contactless di persona con [dispositivi iPhone compatibili](https://docs.stripe.com/terminal/payments/setup-reader/tap-to-pay.md?platform=ios#supported-devices). Tap to Pay su iPhone include il supporto per carte contactless Visa, Mastercard, American Express, wallet mobili basati su NFC (Apple Pay, Google Pay e Samsung Pay) e [metodi di pagamento basati su QR](https://docs.stripe.com/terminal/payments/additional-payment-methods.md). È supportato l’inserimento del PIN. Inoltre, Discover è supportato negli Stati Uniti, Interac è supportato in Canada ed eftpos è supportato in Australia. Stripe include Tap to Pay su iPhone nell’SDK iOS Terminal e nell’SDK React Native Terminal e consente di effettuare pagamenti direttamente nella tua app mobile iOS. > Per le piattaforme, l’utilizzo di Tap to Pay su iPhone è soggetto ai [Termini e condizioni per l’utente della piattaforma di accettazione Apple](https://stripe.com/legal/apple-acceptance-platform). ### Disponibilità - AT - AU - BE - CA - CH - CZ - DE - DK - ES - FR - GB - IE - IT - NL - NZ - PL - PT - SE - SG - US > Tap to Pay su iPhone non è disponibile a Portorico. ### Disponibilità in (Anteprima pubblica) - BG - CY - EE - FI - HR - HU - JP - LI - LT - LU - LV - MT - NO - RO - SI - SK ## Inizia #### iOS Tap to Pay su iPhone presenta un’opzione di rilevamento [SCPDiscoveryMethodTapToPay](https://stripe.dev/stripe-terminal-ios/docs/Enums/SCPDiscoveryMethod.html#/c:@E@SCPDiscoveryMethod@SCPDiscoveryMethodTapToPay) e un metodo [connectReader](https://stripe.dev/stripe-terminal-ios/docs/Classes/SCPTerminal.html#/c:objc\(cs\)SCPTerminal\(im\)connectReader:delegate:connectionConfig:completion:). Integra l’ultima versione dell’[SDK Terminal iOS](https://docs.stripe.com/terminal/payments/setup-integration.md?terminal-sdk-platform=ios) per includere le correzioni dei bug e le funzioni più recenti. Puoi visualizzare gli aggiornamenti specifici della versione e le correzioni dei bug nel [log delle modifiche dell’SDK](https://github.com/stripe/stripe-terminal-ios/blob/master/CHANGELOG.md). I requisiti relativi al dispositivo e alla versione minima dell’SDK possono cambiare a seconda dei requisiti di conformità aggiornati o delle vulnerabilità di sicurezza. Per assicurarti che la tua soluzione sia aggiornata con i requisiti Tap to Pay, iscriviti a [terminal-announce@lists.stripe.com](https://groups.google.com/a/lists.stripe.com/g/terminal-announce). Per abilitare Tap to Pay nella tua applicazione iOS: 1. [Richiedi](https://developer.apple.com/documentation/proximityreader/setting-up-the-entitlement-for-tap-to-pay-on-iphone?language=objc) un diritto. 1. [Imposta](https://docs.stripe.com/terminal/payments/setup-integration.md?terminal-sdk-platform=iOS) l’SDK Terminal iOS. 1. [Collegati](https://docs.stripe.com/terminal/payments/connect-reader.md?terminal-sdk-platform=ios&reader-type=tap-to-pay) al lettore Tap to Pay. 1. [Riscuoti](https://docs.stripe.com/terminal/payments/collect-card-payment.md?terminal-sdk-platform=ios) il pagamento con il lettore Tap to Pay. ### Diritti e file di compilazione Per utilizzare Tap to Pay su iPhone per accettare pagamenti nella tua richiesta di registrazione, devi prima [richiedere e configurare il diritto di sviluppo Tap to Pay su iPhone dal tuo account sviluppatore Apple](https://developer.apple.com/documentation/proximityreader/setting-up-the-entitlement-for-tap-to-pay-on-iphone?language=objc). Una volta completati i test interni, devi richiedere un diritto di distribuzione. Dopo aver aggiunto il file di autorizzazione allo sviluppo al target di compilazione dell’app, aggiungi quanto segue: | | | | | Chiave | `com.apple.developer.proximity-reader.payment.acceptance` | | Tipo di valore | `boolean` | | Valore | `true` o `1` | L’implementazione di Tap to Pay su iPhone è un processo complesso che richiede l’invio della tua app ad Apple per l’approvazione. Per istruzioni dettagliate, puoi scaricare la nostra guida: [ Guida a Tap to Pay (PDF)](https://docs.stripecdn.com/fd6123a72c0ea6d22019c125f9a35d855fe859b4e327faeb89a2934091830744.pdf) #### React Native Tap to Pay su iPhone presenta un’opzione di rilevamento [tapToPay](https://stripe.dev/stripe-terminal-react-native/api-reference/modules/Reader.IOS.html#DiscoveryMethod) e un metodo [connectReader](https://stripe.dev/stripe-terminal-react-native/api-reference/interfaces/StripeTerminalSdkType.html#connectreader-1). Integra l’ultima versione dell’[SDK Terminal React Native](https://docs.stripe.com/terminal/payments/setup-integration.md?terminal-sdk-platform=react-native) per includere le correzioni dei bug e le funzioni più recenti. Puoi visualizzare gli aggiornamenti specifici della versione e le correzioni dei bug nel [log delle modifiche dell’SDK](https://github.com/stripe/stripe-terminal-android/blob/master/CHANGELOG.md)… I requisiti relativi al dispositivo e alla versione minima dell’SDK possono cambiare a seconda dei requisiti di conformità aggiornati o delle vulnerabilità di sicurezza. Per assicurarti che la tua soluzione sia aggiornata con i requisiti Tap to Pay, iscriviti a [terminal-announce@lists.stripe.com](https://groups.google.com/a/lists.stripe.com/g/terminal-announce). Per abilitare Tap to Pay nella tua applicazione: 1. [Richiedi](https://developer.apple.com/documentation/proximityreader/setting-up-the-entitlement-for-tap-to-pay-on-iphone?language=objc) un diritto. 1. [Imposta](https://docs.stripe.com/terminal/payments/setup-integration.md?terminal-sdk-platform=react-native) l’SDK Terminal iOS. 1. [Collegati](https://docs.stripe.com/terminal/payments/connect-reader.md?terminal-sdk-platform=react-native&reader-type=tap-to-pay) al lettore Tap to Pay. 1. [Riscuoti](https://docs.stripe.com/terminal/payments/collect-card-payment.md?terminal-sdk-platform=react-native) il pagamento con il lettore Tap to Pay. ### Diritti e file di compilazione Per utilizzare Tap to Pay su iPhone per accettare pagamenti nella tua richiesta di registrazione, devi prima [richiedere e configurare il diritto di sviluppo Tap to Pay su iPhone dal tuo account sviluppatore Apple](https://developer.apple.com/documentation/proximityreader/setting-up-the-entitlement-for-tap-to-pay-on-iphone?language=objc). Una volta completati i test interni, devi richiedere un diritto di distribuzione. Dopo aver aggiunto il file di autorizzazione allo sviluppo al target di compilazione dell’app, aggiungi quanto segue: | | | | | Chiave | `com.apple.developer.proximity-reader.payment.acceptance` | | Tipo di valore | `boolean` | | Valore | `true` o `1` | L’implementazione di Tap to Pay su iPhone è un processo complesso che richiede l’invio della tua app ad Apple per l’approvazione. Per istruzioni dettagliate, puoi scaricare la nostra guida: [ Guida a Tap to Pay (PDF)](https://docs.stripecdn.com/fd6123a72c0ea6d22019c125f9a35d855fe859b4e327faeb89a2934091830744.pdf) ## Dispositivi supportati Tap to Pay richiede un iPhone XS o modelli successivi con una versione di iOS rilasciata al massimo da un anno. Nella [documentazione di Apple Business Manager](https://register-docs.apple.com/tap-to-pay-on-iphone/docs/sdk-and-api-guide#ios-versions-and-deprecation-management) sono elencate le versioni di iOS supportate. Per ottimizzare le prestazioni, consiglia agli utenti di eseguire l’aggiornamento all’ultima versione di iOS. > Tap to Pay non funziona sulle versioni beta di iOS. ## Limiti di verifica del titolare della carta e soluzione di ripiego Alcune transazioni con carta contactless superiori a [determinati importi](https://support.stripe.com/questions/what-are-the-regional-contactless-limits-for-stripe-terminal-transactions) potrebbero richiedere ulteriori metodi di verifica del titolare della carta (CVM) come l’inserimento di un PIN. Tap to Pay su iPhone supporta l’inserimento del PIN per i dispositivi con iOS 16.4 o versioni successive. Per i pagamenti con wallet NFC (Apple Pay, Google Pay e Samsung Pay) in genere non è richiesto il PIN. Tuttavia, nel Regno Unito, in Canada e in Finlandia, i requisiti locali e le politiche delle società emittenti delle carte possono influire sui pagamenti contactless. Nel Regno Unito, a seconda della società emittente, l’autenticazione forte del cliente potrebbe richiedere l’inserimento di alcune carte in un dispositivo. In questi casi, se la carta non è inserita, il pagamento viene rifiutato prima che venga visualizzata la schermata del PIN, con il motivo `offline_pin_required`. In Canada e Finlandia, molte carte emesse sono solo PIN offline, il che significa che l’inserimento del PIN richiede il contatto fisico, ad esempio l’inserimento in un dispositivo, che non è supportato da Tap to Pay. In questi scenari consigliamo di chiedere al cliente di provare un’altra carta o di riscuotere il pagamento in un altro modo. Ad esempio, puoi utilizzare un lettore di carte Terminal o inviare un [link di pagamento](https://docs.stripe.com/payment-links.md). Quando riscuoti il pagamento con il tuo dispositivo mobile, avvicina la carta al lettore finché non legge le informazioni del chip. Potrebbe essere necessario attendere alcuni secondi dopo la vibrazione iniziale al contatto della carta. In caso di rifiuto, utilizza un’altra modalità per riscuotere il pagamento, ad esempio un lettore di carte Terminal. Puoi avere una sola connessione attiva a un lettore alla volta. Per testare l’inserimento del PIN nei mercati in cui il PIN è accettato, utilizza [carte di test fisiche](https://docs.stripe.com/terminal/references/testing.md#physical-test-cards) con importi che terminano con 0,03. Nei mercati in cui il PIN non è accettato, una transazione che termina con 0,03 restituisce un codice di errore `online_or_offline_pin_required` dopo il tocco della carta, senza consentire all’utente di testare l’inserimento del PIN. ## Pratiche ottimali e linee guida per la promozione Segui le [linee guida di Apple per l’interfaccia utente](https://developer.apple.com/design/human-interface-guidelines/technologies/tap-to-pay-on-iphone/) di Tap to Pay su iPhone per garantire un’esperienza utente ottimale e superare il processo di revisione di Apple. Considera quanto segue: - Connettiti al lettore in background all’avvio dell’app per ridurre i tempi di attesa quando riscuoti un pagamento. - Utilizza la [riconnessione automatica](https://docs.stripe.com/terminal/payments/connect-reader.md?terminal-sdk-platform=ios&reader-type=tap-to-pay#automatically-attempt-reconnection) per riconnetterti al lettore quando l’app è in primo piano per ridurre i tempi di attesa. - Fornisci formazione agli esercenti per guidare i tuoi utenti su come accettare pagamenti contactless su un iPhone compatibile, incluse promozioni all’interno del prodotto e avvisi tramite SMS o email. Consulta la [guida di marketing per sviluppatori](https://developer.apple.com/tap-to-pay/marketing-guidelines/) di Apple. Con iOS 18, puoi utilizzare l’[API ProximityReaderDiscovery](https://developer.apple.com/documentation/proximityreader/proximityreaderdiscovery) di Apple per fornire formazione agli esercenti su Tap to Pay su iPhone con poche righe di codice. Apple garantisce che i contenuti siano aggiornati e localizzati per l’area geografica in cui opera la tua attività. - Avvia e promuovi le tue campagne di marketing Tap to Pay su iPhone utilizzando i nostri modelli di messaggistica e le risorse di design, nel rispetto delle [linee guida del brand Apple](https://developer.apple.com/tap-to-pay/marketing-guidelines/#editorial-guidelines). Diventa un [partner Stripe](https://stripe.com/partners/become-a-partner) per accedere a queste risorse nel [Portale Partner](https://portal.stripe.partners/s). # Android > This is a Android for when platform is android. View the full page at https://docs.stripe.com/terminal/payments/setup-reader/tap-to-pay?platform=android. Utilizza Tap to Pay su Android per accettare pagamenti contactless di persona con [dispositivi Android compatibili dotati di NFC](https://docs.stripe.com/terminal/payments/setup-reader/tap-to-pay.md?platform=android#supported-devices). Tap to Pay su Android include il supporto per le carte contactless Visa, Mastercard, American Express e Discover, i wallet mobili basati su NFC (Apple Pay, Google Pay e Samsung Pay) e i [metodi di pagamento basati su codice QR](https://docs.stripe.com/terminal/payments/additional-payment-methods.md). È supportato l’inserimento del PIN. Inoltre, eftpos è supportato in Australia e Interac è in anteprima pubblica in Canada. Stripe include Tap to Pay su Android nell’SDK Android Terminal e nell’SDK React Native Terminal e consente di effettuare pagamenti direttamente nella tua applicazione mobile Android. ### Disponibilità - AT - AU - BE - CH - DE - DK - FI - FR - GB - IE - IT - MY - NL - NZ - PL - SE - SG - US ### Disponibilità in (Anteprima pubblica) - BG - CA - CY - CZ - EE - ES - GI - HR - HU - LI - LT - LU - LV - MT - NO - PT - RO - SI - SK ## Inizia #### Android Integra la versione più recente dell’[SDK Android Terminal](https://docs.stripe.com/terminal/payments/setup-integration.md?terminal-sdk-platform=android) per includere le correzioni e le funzioni più recenti. Puoi visualizzare gli aggiornamenti e le correzioni di bug specifici della versione nel [log delle modifiche dell’SDK](https://github.com/stripe/stripe-terminal-android/blob/master/CHANGELOG.md). I requisiti relativi al dispositivo e alla versione minima dell’SDK possono cambiare a seconda dei requisiti di conformità aggiornati o delle vulnerabilità di sicurezza. Per assicurarti che la tua soluzione sia aggiornata con i requisiti Tap to Pay, iscriviti a [terminal-announce@lists.stripe.com](https://groups.google.com/a/lists.stripe.com/g/terminal-announce). Per abilitare Tap to Pay nell’applicazione Android: 1. [Configura](https://docs.stripe.com/terminal/payments/setup-integration.md?terminal-sdk-platform=android) l’SDK di Terminal per Android. 1. Sostituisci le dipendenze `stripeterminal` esistenti con le seguenti dipendenze: #### Kotlin ```kotlin dependencies { implementation("com.stripe:stripeterminal-taptopay:5.4.0") implementation("com.stripe:stripeterminal-core:5.4.0") // ... } ``` 1. [Collegati](https://docs.stripe.com/terminal/payments/connect-reader.md?terminal-sdk-platform=android&reader-type=tap-to-pay) al lettore Tap to Pay. 1. [Riscuoti](https://docs.stripe.com/terminal/payments/collect-card-payment.md?terminal-sdk-platform=android) il pagamento con il lettore Tap to Pay. #### React Native Integra l’ultima versione dell’[SDK React Native di Terminal](https://docs.stripe.com/terminal/payments/setup-integration.md?terminal-sdk-platform=react-native) per includere le correzioni dei bug e le funzioni più recenti. I requisiti relativi al dispositivo e alla versione minima dell’SDK possono variare in seguito ad aggiornamenti dei requisiti di conformità o vulnerabilità della sicurezza. Per assicurarti che la tua soluzione sia aggiornata con i requisiti Tap to Pay, registrati a [terminal-announce@lists.stripe.com](https://groups.google.com/a/lists.stripe.com/g/terminal-announce). Per abilitare Tap to Pay nella tua applicazione: 1. [Configura](https://docs.stripe.com/terminal/payments/setup-integration.md?terminal-sdk-platform=react-native) l’SDK React Native di Terminal. 1. [Collegati](https://docs.stripe.com/terminal/payments/connect-reader.md?terminal-sdk-platform=react-native&reader-type=tap-to-pay) al lettore Tap to Pay. 1. [Riscuoti](https://docs.stripe.com/terminal/payments/collect-card-payment.md?terminal-sdk-platform=react-native) il pagamento con il lettore Tap to Pay. ## Dispositivi supportati Tap to Pay su Android funziona con una serie di dispositivi Android come telefoni cellulari, chioschi, tablet, palmari e così via. Puoi individuare e connettere solo i dispositivi che soddisfano tutti i criteri indicati di seguito: - Ha un sensore NFC integrato funzionante e un processore basato su ARM - Non ha accesso root e il bootloader del dispositivo è bloccato e invariato - Funziona con Android 13 o versioni successive - Ha installato un aggiornamento di sicurezza negli ultimi 12 mesi - Utilizza Google Mobile Services e ha installato l’app Google Play Store - Dispone di un keystore con supporto hardware per ECDH ( la versione di [`FEATURE_HARDWARE_KEYSTORE`](https://developer.android.com/reference/android/content/pm/PackageManager#FEATURE_HARDWARE_KEYSTORE) deve essere 100 o successiva) - Una connessione stabile a Internet - Esegue il sistema operativo fornito dal produttore non modificato - Le opzioni sviluppatore sono disabilitate > Tap to Pay non funziona sulle versioni beta di Android. Gli emulatori di dispositivi Android non sono supportati da Tap to Pay. Gli stessi requisiti dei dispositivi vengono applicati nel lettore simulato e in produzione per offrire agli sviluppatori l’esperienza più realistica durante il test. ### Tipi di dispositivi I tipi di dispositivi supportati includono, a titolo esemplificativo: | Tipo di dispositivo | Produttore | Modelli | | --------------------------------------------------------------------------------- | --------------------------------------------------------------------------------- | ------------------------------ | | Piano di lavoro | [Sunmi](https://partner.posportal.com/stripe/stripe/catalog/category/view/id/11/) | D3 MINI, V3 MIX | | Handheld | Honeywell | CT32, CT37 | | iMin | Lark 1 | | [Sunmi](https://partner.posportal.com/stripe/stripe/catalog/category/view/id/11/) | L3, V3 | | Zebra | TC53E | | Kiosk | [Sunmi](https://partner.posportal.com/stripe/stripe/catalog/category/view/id/11/) | Flex 3 with Qualcomm 6225 chip | | Registrati | iMin | Falcon 2 | | [Sunmi](https://partner.posportal.com/stripe/stripe/catalog/category/view/id/11/) | T3, T3 PRO | | Tablet | HMD Global | HMD T21 | | Samsung Galaxy | Scheda Active5 | | [Sunmi](https://partner.posportal.com/stripe/stripe/catalog/category/view/id/11/) | CPad | | Oukitel | RT3 Plus | | Ulefone | Armor Pad 4 Ultra | Alcuni produttori producono dispositivi certificati GMS e non GMS. Se utilizzi un dispositivo non certificato GMS, visualizzerai un messaggio di errore con la dicitura `ATTESTATION_FAILURE: Device is not Google Mobile Services (GMS) certified` quando si tenta di connettere il dispositivo. In tal caso, contatta il produttore per risolvere il problema. ### Cellulari I telefoni cellulari supportati includono, a titolo esemplificativo: | Produttore | Modelli | | -------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Asus | ROG Phone serie 7, ROG Phone serie 8, ROG Phone 9, Zenfone 10, Zenfone 11 Ultra, Zenfone 12 Ultra, Zenfone 9 | | Google | Pixel 10, Pixel 10 Pro, Pixel 10 Pro Fold, Pixel 10 Pro XL, Pixel 6, Pixel 6 Pro, Pixel 6a, Pixel 7, Pixel 7 Pro, Pixel 7a, Pixel 8, Pixel 8 Pro, Pixel 8a, Pixel 9, Pixel 9 Pro, Pixel 9 Pro Fold, Pixel 9 Pro XL, Pixel 9a, Pixel Fold | | Honor | 100, 200, 200 Lite, 200 Pro, 200 Smart, 400, 400 Lite, 400 Pro, 400 Smart, 90, 90 Lite, 90 Smart, Magic V2, Magic V3, Magic V5, Magic Vs, Magic4 Pro, Magic5 Pro, Magic6, Magic6 Lite 5G, Magic6 Pro, Magic7 Lite, Magic7 Pro, Magic8 Lite, Magic8 pro, X5c Plus, X6, X6a, X6b, X6c, X7b, X7b 5G, X7c 5G, X7d, X8a, X8b, X9b 5G, X9c, X9c Smart, X9d | | Infinix | GT 20 Pro, GT 30, GT 30 Pro, HOT 40 Pro, HOT 40i, HOT 50 5G, HOT 50 Pro, HOT 50 Pro+, HOT 60 5G, HOT 60 Pro, HOT 60 Pro+, HOT 60i, NOTE 30, NOTE 30 Pro, NOTE 40, NOTE 40 5G, NOTE 40 Pro, NOTE 40 Pro 5G, NOTE 40 Pro+ 5G, NOTE 50, NOTE 50 Pro, NOTE 50 Pro+ 5G, NOTE 50S 5G, SMART 10 PLUS, ZERO 30, ZERO 40 | | Motorola | ThinkPhone 25 di Motorola, ThinkPhone di Motorola, edge (2022), edge 2023, edge 2024, edge 2025, edge 30 ultra, edge 40, edge 40 neo, edge 40 pro, edge 50, edge 50 fusion, edge 50 neo, edge 50 pro, edge 50 ultra, edge 60, edge 60 fusion, edge 60 neo, edge 60 pro, edge 60 stylus, edge 70, edge plus (2022), edge plus 2023, edge plus 5G UW (2022), moto g - 2025, moto g play - 2024, moto g power - 2025, moto g power 5G - 2024, moto g stylus 5G - 2023, moto g stylus 5G - 2024, moto g stylus 5G - 2025, moto g04, moto g04s, moto g05, moto g06, moto g06 power, moto g14, moto g15, moto g35 5G, moto g54 5G, moto g55 5G, moto g56 5G, moto g57 power, moto g64 5G, moto g64y 5G, moto g66j 5G, moto g67 power 5G, moto g72, moto g73 5G, moto g75 5G, moto g85 5G, moto g86 5G, moto g86 power 5G, moto g96 5G, razr 2022, razr 2023, razr 2024, razr 2025, razr 40, razr 40 ultra, razr 50, razr 50 ultra, razr 60, razr 60 ultra, razr plus 2023, razr plus 2024, razr plus 2025, razr ultra 2025 | | OnePlus | 10 Pro, 10 Pro 5G, 10R 5G, 10T 5G, 11 5G, 11R 5G, 12, 12R, 13, 13R, 13T, 13s, 15, Ace 5, Ace 6, Nord 3 5G, Nord 4, Nord 5, Nord CE4 Lite 5G, Nord CE5, Nord N30 SE 5G, Oneplus Ace 2 Pro, Open | | Oppo | A3, A3 Pro 5G/A3 5G/A80 5G, A38, A40/A3/A40m, A40/A40m, A5 5G, A5 Pro, A5 Pro 5G, A5/A5m, A58, A5x, A60, A60 5G, A78, A78 5G, A79 5G, A80 5G, F25 Pro 5G, Find N2 Flip, Find N3, Find N3 Flip, Find N5, Find X5 Pro, Find X6, Find X6 Pro, Find X7 Ultra, Find X8, Find X8 Pro, Find X9, Find X9 Pro, OPPO A38, OPPO A6 Pro 5G, OPPO A60 5G/ A3 5G, OPPO F31 5G, OPPO Reno8 Pro 5G, OPPO Reno8 T, Reno 11, Reno 11 Pro, Reno10 5G, Reno10 Pro+ 5G, Reno11 F 5G, Reno11 F 5G/Reno11 A, Reno12 5G, Reno12 F, Reno12 F 5G, Reno12 F/FS 5G, Reno12 Pro, Reno12 Pro 5G, Reno13 5G, Reno13 F 5G, Reno13 F 5G / Reno13 A, Reno13 Pro 5G, Reno14 5G, Reno14 F 5G, Reno14 F 5G/Reno14 FS 5G, Reno14 Pro 5G, realme C51 | | Redmi | 12 5G, 13C 5G, 15, 15 5G, 15C 5G, K50, K60 Pro, K60 Ultra, K70, Note 12, Note 12 Turbo, Note 13, Note 13 5G, Note 13 Pro, Note 13 Pro 5G, Note 13 Pro+ 5G, Note 14, Note 14 5G, Note 14 Pro, Note 14 Pro 5G, Note 14 Pro+, Note 14 Pro+ 5G, Turbo 3 | | Samsung Galaxy | A04s, A05s, A13, A14, A14 5G, A15, A15 5G, A16, A16 5G, A17, A17 5G, A23 5G, A24, A25 5G, A26 5G, A33 5G, A34 5G, A35 5G, A36 5G, A53 5G, A53 5G UW, A54 5G, A55 5G, A56 5G, F34 5G, F54 5G, Flip7 FE, M13, M14 5G, M15 5G, M33 5G, M34 5G, M35 5G, M36 5G, M53 5G, M56 5G, S22, S22 Ultra, S22+, S23, S23 FE, S23 Ultra, S23+, S24, S24 FE, S24 Ultra, S24+, S25, S25 Edge, S25 FE, S25 Ultra, S25+, Tab Active5, Tab Active5 5G, Tab Active5 Pro, Tab Active5 Pro 5G, Wide8, XCover7, XCover7 Pro, Z Flip4, Z Flip5, Z Flip6, Z Flip7, Z Fold4, Z Fold5, Z Fold6, Z Fold7 | | Xiaomi | 12, 12 Pro, 12T, 12T Pro, 13, 13 Lite, 13 Pro, 13 Ultra, 13T, 13T Pro, 14, 14 Pro, 14 Ultra, 14T, 14T Pro, 15, 15 Ultra, 17 Pro Max, MIX Fold 3, MIX Fold 4 | ## Interfaccia utente Tap to Pay su Android include le schermate di riscossione dei pagamenti. Quando l’applicazione è pronta per riscuotere un pagamento, l’SDK Stripe Terminal subentra nella visualizzazione per gestire il processo di riscossione. Dopo aver chiamato la modalità di [elaborazione del pagamento](https://docs.stripe.com/terminal/payments/collect-card-payment.md#process-payment), l’applicazione rimane in esecuzione, ma Tap to Pay visualizza una richiesta a schermo intero che chiede al titolare della carta di appoggiare la propria carta o il wallet mobile basato su NFC. Se si verifica un errore durante la lettura della carta, viene visualizzata una richiesta per riprovare. Se l’operazione va a buon fine, ne viene data indicazione e l’applicazione riprende il controllo. ### Zona touch NFC specifica per dispositivo Quando possibile, l’SDK Tap to Pay su Android sposta automaticamente l’indicatore della zona touch per aiutare il cliente finale a capire dove si trova la zona touch sul dispositivo: ![](https://d37ugbyn3rpeym.cloudfront.net/videos/terminal/ttpa-onscreen-demo-1.mp4)![](https://d37ugbyn3rpeym.cloudfront.net/videos/terminal/ttpa-onscreen-demo-2.mp4) Se l’SDK non è in grado di determinare automaticamente la posizione dell’area touch (ad esempio quando l’area touch si trova fuori dallo schermo), viene utilizzata una variante predefinita: ![](https://d37ugbyn3rpeym.cloudfront.net/videos/terminal/ttpa-default-demo.mp4) ### Configurazione dell’esperienza d’uso - [TapToPayUxConfiguration (Android)](https://stripe.dev/stripe-terminal-android/external/com.stripe.stripeterminal.external.models/-tap-to-pay-ux-configuration/index.html) - [TapToPayUxConfiguration (React Native)](https://stripe.dev/stripe-terminal-react-native/api-reference/types/TapToPayUxConfiguration.html) Puoie personalizzare la schermata di inserimento predefinita utilizzando l’SDK di Terminal, compresi i colori dell’interfaccia utente di inserimento, dell’interfaccia utente di errore e dell’interfaccia utente di conferma, nonché la posizione dell’indicatore dell’area di inserimento. Puoi richiamare questo metodo durante il processo di inizializzazione o di connessione del lettore. Puoi richiamare questa funzione più volte se occorre modificare l’aspetto della schermata di inserimento durante il ciclo di vita dell’applicazione. Questo metodo influisce solo sull’aspetto della schermata di inserimento, senza incidere sulla schermata di immissione del PIN o sulla richiesta di pagamento simulata. #### Android #### Kotlin ```kotlin val config = TapToPayUxConfiguration.Builder() .tapZone( TapToPayUxConfiguration.TapZone.Front(0.5f, 0.3f) ) .colors( TapToPayUxConfiguration.ColorScheme.Builder() .primary(TapToPayUxConfiguration.Color.Value(Color.parseColor("#FF008686"))) .success(TapToPayUxConfiguration.Color.Default) .error(TapToPayUxConfiguration.Color.Resource(android.R.color.holo_red_dark)) .build() ) .darkMode( TapToPayUxConfiguration.DarkMode.DARK ) .build() Terminal.getInstance().setTapToPayUxConfiguration(config) ``` #### React Native ```js import { useStripeTerminal, DarkMode, } from '@stripe/stripe-terminal-react-native'; const { setTapToPayUxConfiguration } = useStripeTerminal(); const callSetTapToPayUxConfiguration = async () => { let tapZone = { indicator: 'front', xBias: 0.5, yBias: 0.3, }; let darkMode = DarkMode.DARK; let colors = { primary: '#FF008686', error: '#FFCC0000', }; let config = { tapZone: tapZone, darkMode: darkMode, colors: colors, }; const { error } = await setTapToPayUxConfiguration(config); if (error) { console.log('setTapToPayUxConfiguration error', error); return; } console.log('setTapToPayUxConfiguration success'); }; ``` ![](https://d37ugbyn3rpeym.cloudfront.net/videos/terminal/ttpa-configuration-demo.mp4) ## Limiti di verifica del titolare della carta e soluzione di ripiego Alcune transazioni con carte contactless [superiori a determinati importi](https://support.stripe.com/questions/what-are-the-regional-contactless-limits-for-stripe-terminal-transactions) potrebbero richiedere ulteriori metodi di verifica del titolare della carta (CVM) come l’inserimento di un PIN. Tap to Pay su Android supporta l’inserimento del PIN nell’SDK di Terminal per Android [4.3.0](https://github.com/stripe/stripe-terminal-android/releases/tag/v4.3.0) o in versioni successive. Il PIN viene raccolto in due scenari: - L’importo della transazione supera il [limite del metodo di verifica del titolare della carta (CVM)](https://support.stripe.com/questions/what-are-the-regional-contactless-limits-for-stripe-terminal-transactions). In questo caso, il PIN viene acquisito prima che [collectPaymentMethod](https://stripe.dev/stripe-terminal-android/core/com.stripe.stripeterminal/-terminal/collect-payment-method.html) restituisca il risultato. Il focus torna alla tua applicazione dopo che il PIN è stato inserito o l’acquisizione del PIN è stata annullata. ![Flusso PIN locale di Tap to Pay su Android](https://b.stripecdn.com/docs-statics-srv/assets/ttpa-local-pin-flow.0f134662b73c0dfa4eaf1e57f09fd17a.png) - La società emittente richiede un’[autenticazione SCA](https://stripe.com/guides/strong-customer-authentication). In questo caso, il PIN viene acquisito durante [confirmPaymentIntent](https://stripe.dev/stripe-terminal-android/core/com.stripe.stripeterminal/-terminal/confirm-payment-intent.html). Il focus torna alla tua applicazione dopo `confirmPaymentIntent`, a meno che la società emittente non richieda il PIN. In tal caso, l’acquisizione del PIN riprende il focus fino a quando il PIN non viene inserito o l’acquisizione del PIN non viene annullata. ![Flusso PIN SCA di Tap to Pay su Android](https://b.stripecdn.com/docs-statics-srv/assets/ttpa-sca-pin-flow.4144d0670052a3544bfe573182bb9487.png) ### Gestione degli errori del PIN Puoi ottenere un PIN solo se si verificano le seguenti condizioni: - Le [ppzioni per sviluppatori](https://developer.android.com/studio/debug/dev-options) sono disabilitate. - I [servizi per l’accessibilità](https://developer.android.com/guide/topics/ui/accessibility/service) non sono registrati né in esecuzione. - La [registrazione dello schermo](https://support.google.com/android/answer/9075928) non è attiva. - Non sono presenti [finestre di sovrapposizione dello schermo](https://developer.android.com/privacy-and-security/risks/tapjacking) - Hai una connessione Internet attiva. Anche la raccolta del PIN ha esito negativo se una delle parti tenta di acquisire uno screenshot. Se la raccolta del PIN non va a buon fine a causa di uno di questi fattori, viene visualizzato un messaggio di errore `TAP_TO_PAY_INSECURE_ENVIRONMENT` con informazioni aggiuntive sulla causa dell’errore. Per poter richiedere un PIN, ti suggeriamo di riprovare a effettuare il pagamento seguendo questi passaggi. ### Considerazioni sul PIN regionale Per i pagamenti con wallet NFC (Apple Pay, Google Pay e Samsung Pay) in genere non è richiesto il PIN. Tuttavia, nel Regno Unito, in Canada e in Finlandia, i requisiti locali e le politiche delle società emittenti delle carte possono influire sui pagamenti contactless. Nel Regno Unito, a seconda della società emittente, l’autenticazione forte del cliente potrebbe richiedere l’inserimento di alcune carte in un dispositivo. In questi casi, se la carta non è inserita, il pagamento viene rifiutato prima che venga visualizzata la schermata del PIN, con il motivo `offline_pin_required`. In Canada e Finlandia, molte carte emesse sono solo PIN offline, il che significa che l’inserimento del PIN richiede il contatto fisico, ad esempio l’inserimento in un dispositivo, che non è supportato da Tap to Pay. In questi scenari consigliamo di chiedere al cliente di provare un’altra carta o di riscuotere il pagamento in un altro modo. Ad esempio, puoi utilizzare un lettore di carte Terminal o inviare un [link di pagamento](https://docs.stripe.com/payment-links.md). Quando riscuoti il pagamento con il tuo dispositivo mobile, avvicina la carta al lettore finché non legge le informazioni del chip. Potrebbe essere necessario attendere alcuni secondi dopo la vibrazione iniziale al contatto della carta. In caso di rifiuto, utilizza un’altra modalità per riscuotere il pagamento, ad esempio un lettore di carte Terminal. Puoi avere una sola connessione attiva a un lettore alla volta. ### Esperienza d’uso del PIN Per motivi di sicurezza, il PIN pad non appare sempre al centro dello schermo, ma in una posizione determinata casualmente. ![Schermata di raccolta del PIN di Tap to Pay su Android](https://b.stripecdn.com/docs-statics-srv/assets/ttpa-pin-screen.ceb66e1d9695de8ca517e39265a2be10.png) La mancata centratura del PIN pad è un comportamento previsto ## Pratiche ottimali e linee guida per la promozione Per garantire un’esperienza utente ottimale, considera quanto segue: - Connettiti al lettore in background all’avvio dell’app per ridurre i tempi di attesa quando riscuoti un pagamento. - Utilizza la [riconnessione automatica](https://docs.stripe.com/terminal/payments/connect-reader.md?terminal-sdk-platform=android&reader-type=tap-to-pay#automatically-attempt-reconnection) per riconnetterti al lettore quando l’app è in primo piano per ridurre i tempi di attesa. - Spiega agli esercenti come accettare i pagamenti contactless su un dispositivo Android compatibile, tra cui la gestione delle promozioni integrate nel prodotto e gli avvisi via SMS o email. - Avvia e promuovi le tue campagne di marketing Tap to Pay su Android utilizzando i nostri modelli di messaggistica e le risorse di design. Diventa un [partner Stripe](https://stripe.com/partners/become-a-partner) per accedere a queste risorse nel [Portale Partner](https://portal.stripe.partners/s/login/?language=en_US&ec=302&startURL=%2Fs%2F). ## Passaggi successivi - [Configura l’integrazione](https://docs.stripe.com/terminal/payments/setup-integration.md)