Tap to Pay

Utilizza Tap to Pay su Android per accettare pagamenti contactless di persona con dispositivi Android compatibili dotati di NFC.

Tap to Pay su Android include il supporto per carte contactless Visa, Mastercard e American Express e per wallet mobili basati su NFC (Apple Pay, Google Pay e Samsung Pay). L’inserimento del PIN è supportato. Inoltre, eftpos è supportato in Australia. Stripe include Tap to Pay su Android nell’SDK di Terminal per Android e nell’SDK di Terminal per React Native e abilita i pagamenti direttamente nell’app mobile Android.

Disponibilità

Disponibilità in Anteprima pubblica

Inizia

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
• Esegue una versione corrente di Android (Android 11 o superiore)
• Utilizza Google Mobile Services e ha installato l’app Google Play Store
• Dispone di un keystore supportato da hardware
• Supporta la generazione di coppie di chiavi utilizzando una varietà di algoritmi chiave, tra cui RSA e AES dell’archivio chiavi di Android
• Una connessione stabile a Internet
• Esegue il sistema operativo fornito dal produttore non modificato

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:

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:

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. Al momento della chiamata della modalità di riscossione del pagamento, l’applicazione rimane in esecuzione, ma Tap to Pay visualizza una richiesta a schermo intero al titolare della carta, che gli chiede 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 per confermare il pagamento.

Interfaccia utente zona di tocco NFC specifica per dispositivo

L’SDK Tap to Pay su Android supporta l’esperienza d’uso specifica del dispositivo che indica dinamicamente all’utente finale dove si trova la zona di tocco sul dispositivo. Visualizza alcuni esempi di come potrebbe essere in pratica l’esperienza d’uso:

Configurazione dell’esperienza d’uso

L’SDK di Terminal per Android ti permette di personalizzare l’esperienza d’uso predefinita, ad esempio modificando i colori dell’area di tocco, i messaggi di errore, l’animazione di successo e la posizione dell’indicatore all’interno dell’area di tocco. Ricorda di eseguire questo metodo durante l’inizializzazione o la connessione del lettore. Questa funzione può essere eseguita più volte qualora sia necessario modificare l’aspetto della schermata Tap to Pay nel corso del ciclo di vita dell’applicazione. Questo metodo ha effetto unicamente sull’aspetto della richiesta di pagamento Tap to Pay nell’ambiente di produzione. Non incide sulla schermata di raccolta del PIN né sulla richiesta di pagamento simulata. Guarda un esempio di personalizzazione dell’esperienza d’uso:

val config = TapToPayUxConfiguration.Builder()
    .tapZone(
        TapToPayUxConfiguration.TapZone.Manual.Builder()
            .indicator(TapToPayUxConfiguration.TapZoneIndicator.FRONT)
            .position(TapToPayUxConfiguration.TapZonePosition.Manual(0.5f, 0.3f))
            .build()
    )
    .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)

Limiti di verifica del titolare della carta e soluzione di ripiego

Alcune transazioni con carte contactless superiori a determinati importi 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 o in versioni successive.

Il PIN viene raccolto in due scenari:

1. L’importo della transazione è superiore al limite del metodo di verifica del titolare della carta (CVM).

In questo caso, il PIN viene raccolto prima che collectPaymentMethod venga restituito. Lo stato attivo torna all’applicazione dopo l’immissione del PIN o l’annullamento della raccolta del PIN.

1. La società emittente invia una richiesta di autenticazione forte del cliente (SCA).

In questo caso, il PIN viene acquisito durante il confirmPaymentIntent. Lo stato attivo torna all’applicazione dopo confirmPaymentIntent, a meno che la società emittente non effettui una richiesta di PIN. In tal caso, la raccolta del PIN è nuovamente attiva fino a quando il PIN non viene immesso o la raccolta del PIN non viene annullata.

Gestione degli errori del PIN

Puoi ottenere un PIN solo se si verificano le seguenti condizioni:

• Le ppzioni per sviluppatori sono disabilitate.
• I servizi per l’accessibilità non sono registrati né in esecuzione.
• La registrazione dello schermo non è attiva.
• Non sono presenti finestre di sovrapposizione dello schermo
• 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.

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 tastierino numerico non viene sempre visualizzato al centro dello schermo. Appare in una posizione che viene determinata in modo casuale.

Si prevede un comportamento specifico per il PIN pad decentrato.

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 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.
• Lancia e promuovi le tue campagne di marketing Tap to Pay su Android utilizzando i modelli di messaggi e le risorse di progettazione. Diventa partner Stripe qui per accedere a queste risorse nel portale per partner.