Liste de contrôle pour le déploiement
Cette liste de contrôle vous aidera à facilement déployer Stripe Terminal.
Stripe Terminal nécessite d’intégrer des éléments matériels et logiciels pour amener Stripe dans le monde physique. Lorsque vous développez votre intégration, consultez cette liste de contrôle pour ne pas oublier certaines étapes essentielles.
Si l’ordre de la liste ne doit pas être nécessairement respecté, vous devez toutefois comprendre comment fonctionne une intégration Terminal pour pouvoir faire le lien entre toutes ses étapes.
Après avoir suivi les guides d’intégration de Stripe Terminal, vérifiez que votre application est correctement configurée.
Pour gérer le cycle de vie du ConnectionToken, configurez un endpoint sur votre back-end qui crée un ConnectionToken pour votre application cliente. Authentifiez cet endpoint pour contrôler qui peut accéder à vos lecteurs. Ne codez pas en dur le ConnectionToken dans votre application, cela vous empêcherait de vous reconnecter à un lecteur. Pour mieux contrôler l’accès aux lecteurs connectés à Internet comme le Verifone P400 et le BBPOS WisePOS E, utilisez des emplacements.
Lorsque le paramètre capture_method du PaymentIntent est défini sur
manual, le paiement est autorisé, mais pas capturé lorsque le SDK renvoie un PaymentIntent traité à votre application. Pour finaliser l’encaissement des fonds, vous devez capturer le PaymentIntent.Lorsque votre application reçoit un PaymentIntent traité provenant du SDK, vérifiez qu’elle demande à votre back-end de capturer le PaymentIntent.
Offrez à votre clientèle la possibilité de recevoir un reçu imprimé ou électronique. Vous pouvez vous servir des reçus préconfigurés par Stripe ou utiliser les données provenant de l’API Stripe pour créer des reçus personnalisés qui reflètent l’image de marque de votre entreprise. Vérifiez que vous recevez bien un reçu lorsque vous créez un paiement en mode production à l’aide de votre application.
Si vous remettez à vos clients des reçus personnalisés, enregistrez une copie de chaque reçu comme élément de preuve en cas de litige. Si vous utilisez les reçus préconfigurés de Stripe, une copie, enregistrée automatiquement, est accessible dans le Dashboard.
Rapprochez les paiements des données du système de commande interne de votre serveur après chaque journée d’activité pour éviter les erreurs d’autorisation ou les fonds non capturés :
- Si un utilisateur abandonne prématurément le tunnel de paiement de votre plateforme, il peut en résulter un PaymentIntent non capturé, qui peut passer pour une autorisation involontaire auprès du titulaire de la carte.
- Il se peut également que la requête de votre application demandant à votre back-end de capturer le PaymentIntent échoue, ce qui entraîne un encaissement incomplet des fonds.
Le BBPOS Chipper 2X BT ne se met pas à jour automatiquement, il est donc important que votre application prenne en charge les mises à jour. Bien que rares, les mises à jour contiennent généralement des fonctionnalités importantes ou des corrections indispensables. Assurez-vous que l’application prend en charge les opérations suivantes :
- Pour commencer, vérifiez si une mise à jour est disponible.
- Si c’est le cas, affichez dans l’interface utilisateur le temps estimé pour effectuer la mise à jour, ainsi que des options permettant de continuer ou d’annuler.
- Pendant que la mise à jour est en cours, faites en sorte que l’interface utilisateur indique à l’utilisateur de laisser le lecteur sous tension et à proximité. Empêchez l’utilisateur de quitter la page.
- Afficher un témoin visuel indiquant la progression de la mise à jour (par ex., un pourcentage ou une barre de progression).
Reportez-vous à nos exemples d’applications (iOS et Android) pour consulter une interface utilisateur de référence.
Pour les lecteurs intelligents comme le Verifone P400 et le BBPOS WisePOS E, vous devez enregistrer le lecteur sur votre compte avant de pouvoir y connecter votre application.
La façon de gérer l’enregistrement des lecteurs dépend de votre cas d’usage :
Taille du déploiement : pour des déploiements à petite échelle, enregistrez chaque lecteur dans le Dashboard Stripe. Pour des déploiements plus larges, dans le cadre desquels des lecteurs doivent être expédiés vers plusieurs localisations, assurez-vous que les responsables sur site peuvent ajouter de nouveaux lecteurs au compte Stripe de votre entreprise. Développez un processus dans votre application pour autoriser d’autres personnes à enregistrer des lecteurs sur votre compte Stripe. L’endpoint pour enregistrer un lecteur doit être appelé côté serveur. Si vous prenez en charge l’enregistrement de lecteurs depuis l’application de votre client, l’application doit pouvoir communiquer avec votre back-end pour enregistrer le lecteur.
Utilisation de Connect : si vous vous servez des paiements directs de Connect, utilisez l’en-tête
Stripe-Accountpour enregistrer le lecteur auprès du compte connecté. Avec les paiements indirects, enregistrez les nouveaux lecteurs sur le compte de la plateforme.
Créer un objet Location dans Terminal pour chaque site d’exploitation physique où votre entreprise accepte des paiements par TPE. Vous devez associer chaque lecteur à un emplacement pour vous assurer qu’il télécharge la configuration régionale adéquate.
Pour les lecteurs intelligents, prenez en charge la spécification d’un emplacement pendant l’enregistrement du lecteur. Pour les lecteurs Bluetooth, prenez en charge la spécification d’un emplacement pendant la connexion au lecteur.
Vérifiez que votre application peut afficher une liste actualisée des lecteurs découverts, avec l’étiquette et/ou le numéro de série de chacun. Reportez-vous à nos exemples d’applications pour consulter un modèle d’interface utilisateur.
Si votre application mobile doit être utilisée avec plusieurs lecteurs Bluetooth, utilisez la méthode de détection de proximité Bluetooth. Joignez à l’application des instructions invitant à tenir le lecteur à proximité de l’appareil sur lequel l’application est installée et à attendre qu’il commence à clignoter en plusieurs couleurs. Vérifiez que l’interface utilisateur de votre application permet d’annuler le processus de détection des lecteurs.
Si vous utilisez le Verifone P400 ou le BBPOS WisePOS E, vérifiez que le lecteur et l’appareil exécutant votre application se trouvent tous deux sur le réseau local approprié. Joignez à votre application des instructions permettant de vérifier que le réseau local est correct.
Stripe publie régulièrement des mises à jour qui peuvent inclure de nouvelles fonctionnalités, des corrections de bugs et des mises à jour de sécurité. Mettez à jour votre SDK dès qu’une nouvelle version est disponible. Les SDK actuellement disponibles sont les suivants :
Les nom et logo BBPOS et Chipper™ sont des marques ou marques déposées de BBPOS Limited aux États-Unis et/ou dans d’autres pays. Les nom et logo Verifone® sont des marques ou marques déposées de Verifone aux États-Unis et/ou dans d’autres pays. L’utilisation de ces marques n’implique aucune approbation de la part de BBPOS ou Verifone.