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 le carte contactless Visa, Mastercard, American Express e Discover, nonché per i wallet mobili basati su NFC (Apple Pay, Google Pay e Samsung Pay). È 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à

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
• Funziona con Android 13 o versioni successive
• 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 deve essere 100 o successiva)
• 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. Dopo aver chiamato la modalità di elaborazione del pagamento, 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

L’SDK Tap to Pay su Android sposta automaticamente l’indicatore della zona touch per aiutare l’utente finale a capire dove si trova la zona touch sul dispositivo. Guarda alcuni esempi pratici dell’esperienza d’uso:

Schermo touch generico

Schermo touch specifico per dispositivo

Configurazione dell’esperienza d’uso

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)

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 PIN pad non appare sempre al centro dello schermo, ma in una posizione determinata casualmente.

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