Tap to Pay

Utilisez Tap to Pay sur Android pour accepter des paiements sans contact en personne avec des appareils Android compatibles NFC.

Tap to Pay on Android prend en charge les cartes sans contact Visa, Mastercard et American Express, ainsi que les portefeuilles mobiles équipés de la technologie NFC (Apple Pay, Google Pay et Samsung Pay). La saisie du code PIN est prise en charge. Stripe inclut Tap to Pay sur Android dans le SDK Terminal Android et le SDK Terminal React Native, et permet les paiements directement dans votre application mobile Android.

Disponibilité

Disponibilité en version bêta publique

Démarrer

Appareils pris en charge

Tap to Pay on Android works with a variety of Android devices such as mobile phones, kiosks, tablets, handheld devices, and so on. You can only discover and connect to devices that meet all of the following criteria:

• Has a functioning, integrated NFC sensor and ARM-based processor
• N’est pas rooté et le bootloader de l’appareil est verrouillé et n’a pas été modifié
• Fonctionne sous une version actuelle d’Android (Android 11 ou une version ultérieure)
• Utilise les services Google Mobile et dispose de l’application Google Play Store
• Dispose d’un keystore intégré au matériel
• Prend en charge la génération de paires clés à l’aide de divers algorithmes de clés, notamment RSA et AES à partir du keystore Android
• Une connexion Internet stable
• Exécute le système d’exploitation non modifié fourni par le fabricant

Les émulateurs Android ne sont pas pris en charge par Tap to Pay. Le lecteur de simulation et le lecteur réel appliquent les mêmes exigences concernant les appareils, afin d’offrir aux développeurs l’expérience la plus réaliste possible pendant les tests.

Types d’appareils

Les types d’appareils pris en charge incluent, sans s’y limiter :

Certains fabricants produisent à la fois des appareils certifiés GMS et non certifiés GMS. Si vous utilisez un appareil non certifié GMS, vous recevrez un message d’erreur indiquant « ATTESTATION_FAILURE : l’appareil n’est pas certifié Google Mobile Services (GMS) » lorsque vous tenterez de connecter l’appareil. Si cela se produit, contactez le fabricant pour résoudre le problème.

Téléphones portables

Les téléphones mobiles pris en charge incluent, sans s’y limiter :

Interface utilisateur

Tap to Pay sur Android inclut des écrans pour l’encaissement des paiements. Lorsque votre application est prête à encaisser un paiement, le SDK Stripe Terminal prend le relais pour gérer le processus d’encaissement. Une fois que vous avez appelé la méthode collect payment, votre application continue de s’exécuter, tandis que Tap to Pay affiche une invite en plein écran qui demande au titulaire de la carte de présenter sa carte ou son portefeuille mobile NFC. En cas d’erreur lors de la lecture de la carte, une invite pour renouveler la tentative s’affiche. Si l’opération aboutit, un message de confirmation s’affiche et votre application reprend le contrôle pour confirmer le paiement.

Interface utilisateur personnalisée pour la zone cliquable compatible NFC de l’appareil

Le SDK Tap to Pay sur Android prend en charge des expériences utilisateur personnalisées pour l’appareil qui indiquent dynamiquement au client final où se trouve la zone cliquable sur l’appareil. Consultez des exemples de ce à quoi ressemble l’expérience utilisateur en pratique :

Configuration de l’expérience utilisateur

Vous pouvez remplacer l’expérience utilisateur par défaut à l’aide du SDK Android Terminal, y compris les couleurs de la zone de contact, le message d’erreur, l’animation de réussite et la position de l’indicateur de zone de contact. Appelez cette méthode pendant le processus d’initialisation ou de connexion au lecteur. Vous pouvez appeler cette fonction plusieurs fois si vous avez besoin de modifier l’apparence de l’écran Tap to Pay pendant la durée de vie de votre application. Cette méthode n’affecte que l’apparence de l’invite de paiement Tap to Pay du mode production. Elle n’a aucun impact sur l’écran de collecte du code PIN ni sur la simulation d’invite de paiement. Voici un exemple de personnalisation de l’expérience utilisateur :

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)

Limites de la vérification du titulaire de la carte et solution de repli

Certaines transactions par carte sans contact au-delà d’un certain montant peuvent nécessiter des méthodes de vérification supplémentaires du titulaire de la carte (CVM), comme la saisie d’un code PIN. Tap to Pay sur Android prend en charge la saisie du code PIN sur le SDK Terminal Android 4.3.0, ou une version supérieure.

Le code PIN est collecté dans deux scénarios :

1. Le montant de la transaction est supérieur à la limite associée à la méthode de vérification du titulaire de carte.

Dans ce cas, le code PIN est collecté avant le renvoi de collectPaymentMethod. Le flux revient à votre application après la saisie du code PIN ou l’annulation de cette collecte.

1. L’émetteur fait une demande d’authentification forte du client (SCA).

Dans ce cas, le code PIN est collecté pendant confirmPaymentIntent. Le flux revient à votre application après confirmPaymentIntent, sauf si l’émetteur demande un code PIN. Dans ce cas, la collecte du code PIN revient au premier plan jusqu’à ce que le code PIN soit saisi ou que sa collecte soit annulée.

Gestion des erreurs de code PIN

Vous ne pouvez collecter un code PIN que dans les conditions suivantes :

• Les options pour les développeurs sont désactivées.
• Il n’y a pas de services d’accessibilité inscrits ou en cours d’exécution.
• Il n’y a pas d’enregistrement d’écran en cours.
• Il n’y a pas de fenêtres de superposition à l’écran
• Vous disposez d’une connexion internet active.

La collecte du code PIN échoue également si une partie tente de faire une capture d’écran.

Si la collecte du code PIN échoue en raison de l’un de ces facteurs, vous recevez un message d’erreur TAP_TO_PAY_INSECURE_ENVIRONMENT contenant des informations supplémentaires sur la cause de l’erreur. Nous vous recommandons de fournir des indications concrètes aux utilisateurs afin qu’ils puissent relancer le paiement et saisir le code PIN.

Spécificités régionales concernant les codes PIN

Les paiements par portefeuille NFC (Apple Pay, Google Pay et Samsung Pay) ne nécessitent généralement pas de code PIN. Toutefois, au Royaume-Uni, au Canada et en Finlande, les exigences régionales et les politiques des émetteurs de cartes peuvent avoir une incidence sur les paiements sans contact.

Au Royaume-Uni, l’authentification forte du client peut nécessiter l’insertion de certaines cartes dans un appareil, en fonction de l’émetteur. Dans ce cas, si la carte bancaire n’est pas insérée, le paiement est refusé avant l’apparition de l’écran de code PIN, avec le motif offline_pin_required.

Au Canada et en Finlande, de nombreuses cartes utilisent uniquement un code PIN hors ligne, ce qui signifie que la saisie du PIN nécessite un contact physique, comme l’insertion dans un appareil, ce qui n’est pas pris en charge par Tap to Pay.

Dans ce cas, nous vous recommandons de proposer au client d’essayer avec une autre carte ou d’encaisser son paiement d’une autre manière, par exemple, à l’aide d’un lecteur de carte Terminal ou en envoyant un lien de paiement.

Lorsque vous collectez un paiement avec votre appareil mobile, tenez la carte devant le lecteur jusqu’à ce qu’il lise les informations de la puce. Vous devrez peut-être attendre quelques secondes après la vibration qui se produit lorsque la carte entre en contact. En cas de refus de paiement, utilisez une autre méthode, comme un lecteur de cartes Terminal. Il n’est possible d’activer qu’une connexion à un lecteur à la fois.

Expérience utilisateur - PIN

Pour des raisons de sécurité, le clavier n’apparaît pas toujours au centre de l’écran. Il apparaît dans une position déterminée de manière aléatoire.

Un clavier décentré est un comportement attendu.

Bonnes pratiques pour vos actions de promotion et votre branding

Pour offrir une expérience utilisateur optimale, tenez compte des points suivants :

• Connectez-vous au lecteur en arrière-plan au démarrage de l’application pour réduire les temps d’attente lors de l’encaissement d’un paiement.
• Utilisez la reconnexion automatique pour vous reconnecter au lecteur lorsque l’application passe au premier plan afin de réduire les temps d’attente.
• Expliquez à vos marchands comment accepter les paiements sans contact sur un appareil Android compatible, notamment concernant la gestion des promotions intégrées au produit et des alertes par SMS ou par e-mail.
• Lancez et faites la promotion de vos campagnes marketing Tap to Pay sur Android à l’aide de nos modèles de message et de nos ressources de conception. Devenez un partenaire Stripe ici pour accéder à ces ressources sur le portail des partenaires.