Outils pour l'intégration de dispositifs de paiement : UDemo

Les développeurs d'applications de paiement qui souhaitent accélérer l'intégration des lecteurs de cartes ID TECH dans leurs systèmes de point de vente (ou autres) peuvent progresser rapidement en tirant parti du Universal SDK d'ID TECH. Le SDK fournit des bibliothèques (ainsi qu'une API commune) permettant de piloter l'ensemble des lecteurs de cartes en production actuelle chez ID TECH, notamment les lecteurs à puce (EMV), à piste magnétique (MSR) et sans contact, dans plusieurs langages (tels que C# pour Windows, Java pour Android, Swift pour iOS et C pour Linux).

Il n'est toutefois pas nécessaire d'installer le SDK pour exécuter le programme de démonstration associé, une application autonome que nous appelons la Universal Demo, ou UDemo (en abrégé). Vous pouvez obtenir l'UDemo (version autonome pour Windows) en vous rendant ici.

Nous recommandons à tous nos clients développeurs de se familiariser avec l'application UDemo, car elle illustre en détail la structure des requêtes et des réponses brutes échangées avec l'appareil, permet de configurer un appareil avec des paramètres spécifiques, et offre un environnement de test dans lequel les développeurs peuvent facilement essayer différentes commandes avec diverses valeurs d'arguments, en temps réel. L'UDemo constitue également un excellent moyen d'approfondir ses connaissances sur EMV.

Après avoir exécuté le programme d'installation de l'UDemo, lancez l'application. Une fenêtre semblable à la suivante s'affichera :

Notez que vous pouvez brancher n'importe quel lecteur de cartes ID TECH compatible sur le port USB de votre ordinateur à tout moment ; il sera automatiquement détecté par l'UDemo. Une fois l'appareil reconnu, l'arborescence des commandes (voir « COMMANDS » ci-dessus) se remplira avec les commandes propres à l'appareil concerné (affichant, par exemple, un groupe « CTLS » si l'appareil prend en charge les interactions sans contact, « EMV » s'il prend en charge les transactions par carte à puce EMV avec contact, etc.).

La procédure d'utilisation de base est la suivante :

1. Branchez un appareil.
2. Parcourez l'arborescence des commandes jusqu'à trouver la commande souhaitée.
3. Double-cliquez sur la commande dans l'arborescence, OU cliquez une fois sur le bouton vert Execute Command situé en bas de la fenêtre.
4. Consultez le volet Journal pour visualiser les requêtes et les réponses. (Les valeurs envoyées à l'appareil sont indiquées par « OUT », tandis que celles reçues de l'appareil sont indiquées par « IN ».)
5. Consultez le volet Résultats (à droite) pour afficher l'explication en langage clair de ce qui s'est passé.

Dans la capture d'écran ci-dessus, la commande Démarrer une transaction EMV a été exécutée (sur un lecteur de carte ID TECH VP3300) avec le montant de transaction par défaut de 1,00 $. La commande effectivement exécutée est affichée en haut du Journal. Quatre réponses « IN » ont été reçues de l'appareil. La première réponse était un ACK, et les deux suivantes contiennent des informations de statut représentant des messages LCD (tels que « Traitement en cours… ») susceptibles d'être affichés sur un terminal point de vente pendant le déroulement de la transaction. La quatrième et dernière réponse IN contient un bloc de données TLV (tag-longueur-valeur) retourné par le lecteur. Certaines des analyses TLV sont affichées dans le volet Résultats.

Conseils pour UDemo

UDemo est un outil hautement interactif qui s'apprend avant tout par la pratique. Pour gravir la courbe d'apprentissage un peu plus rapidement, il peut être utile de prendre connaissance des points suivants :

1. De nombreuses commandes acceptent des valeurs d'argument ou peuvent être configurées avant leur exécution. Il suffit de cliquer une fois sur une commande dans la liste des commandes. Si la commande concernée peut recevoir des valeurs supplémentaires, les champs de formulaire appropriés apparaîtront automatiquement juste au-dessus du volet Journal. Saisissez les valeurs éventuellement requises, puis double-cliquez sur la commande pour l'exécuter avec ces valeurs.
2. Le pavé numérique virtuel situé en haut à droite devient actif lorsque la carte insérée dans le lecteur requiert la saisie d'un code PIN comme méthode de vérification du titulaire de la carte.
3. Juste au-dessus de la liste des commandes se trouve un bouton intitulé Décryptage. Cliquez sur ce bouton pour ouvrir une boîte de dialogue vous permettant de décrypter les données de transaction.
4. Sous le volet Journal, vous trouverez un bouton Start Capture to Disk (ainsi qu'un bouton Clear Logs et un bouton Email Logs to Support). Le bouton Start Capture est utile lorsque vous souhaitez enregistrer les données d'une session pour une analyse ultérieure. Vous pouvez même nous envoyer vos résultats par e-mail (via le bouton Email Logs) si vous décidez d'ouvrir un dossier auprès du support technique.

Avant d'exécuter une transaction EMV

Bien entendu, UDemo n'est qu'un outil de test et ne permet pas de débiter réellement une carte de crédit lors d'une transaction en conditions réelles. Cependant, il simule les trois phases (Démarrage, Authentification et Finalisation) d'une session EMV par contact. Avant de pouvoir exécuter des commandes de transaction, le lecteur de carte doit faire l'objet d'au moins quelques configurations. (Sans cela, la simulation échouera.)

Vous pouvez configurer un appareil rapidement (avec des valeurs par défaut raisonnables) en exécutant trois commandes :

1. Tout d'abord, sous le nœud AID de l'arborescence de commandes, recherchez Load Default AID et exécutez-le. Il s'agit en réalité d'une opération par lot qui chargera une demi-douzaine d'AID courants dans l'appareil. Prévoyez une dizaine de secondes environ.
2. Ensuite, sous le nœud CAPK de l'arborescence de commandes, recherchez la commande Load Default CAPK et exécutez-la. Il s'agit également d'une commande par lot qui prendra quelques secondes. Elle charge les clés publiques de différentes marques de cartes, utilisées pour valider les éléments cryptographiques produits par une carte à puce au moment de la transaction. (ATTENTION : ces clés sont destinées aux tests uniquement et ne doivent pas être utilisées en production. Procurez-vous les clés de production auprès de votre passerelle de paiement ou de votre processeur de paiement.)
3. Enfin, sous le nœud Terminal Config de l'arborescence de commandes, recherchez et exécutez Save Terminal Data. Cette opération chargera des TLV par défaut appropriés dans le lecteur afin de prendre en charge diverses fonctionnalités du terminal.

Une fois ces commandes exécutées, le lecteur de carte contiendra les données par défaut appropriées, et des commandes telles que Start Transaction devraient fonctionner sans erreur.

Pour en savoir plus

Il va sans dire que l'application UDemo offre de nombreuses fonctionnalités, bien trop nombreuses pour être toutes décrites ici. La meilleure façon d'obtenir plus d'informations ? Regardez dans le coin inférieur gauche de l'écran UDemo (voir l'illustration ci-dessus) et repérez le bouton rose Documentation . En cliquant sur ce bouton, un PDF s'ouvrira dans Acrobat Reader (à condition que ce logiciel soit installé sur votre ordinateur), affichant le Guide de démarrage rapide d'UDemo.

Pour comprendre la signification de tous les octets hexadécimaux affichés dans UDemo, vous souhaiterez probablement consulter le guide API de bas niveau (firmware) correspondant à votre lecteur. Vous pouvez généralement l'obtenir directement depuis la section Téléchargements de notre base de connaissances publique (sans inscription requise), mais certains documents ne sont disponibles que sur demande. Dans ce cas, vous pouvez contacter votre représentant ID TECH, et le ou les documents concernés vous seront fournis gratuitement.

Vous avez des questions sur le SDK universel ou sur l'un des produits ID TECH ? Contactez nos experts à l'adresse 1-800-984-1010!