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

L'intégration d'un périphérique de paiement dans une application de point de vente (ou toute autre application de paiement) peut s'avérer complexe, même dans les meilleures conditions. Une documentation de qualité facilite les choses. Des outils performants font encore plus la différence.

ID TECH propose plusieurs outils gratuits pour simplifier le processus d'intégration. L'un de nos outils les plus populaires, Parsomatic, est hébergé sur ce site (accéder ici). Un autre outil très utilisé, non seulement par nos clients mais également par l'équipe de support interne d'ID TECH, est notre outil de chiffrement/déchiffrement (accéder ici). Nous disposons également d'un utilitaire Windows (.NET), compatible avec tous les ID TECH Products en production actuelle (ainsi que certains modèles plus anciens), que nous appelons UDemo (ou Universal SDK Demo). Il est disponible, avec de nombreuses autres démonstrations et utilitaires, sur notre page de téléchargements.

Si vous débutez une intégration ou si vous êtes novice en matière d'EMV et avez besoin d'un utilitaire de recherche rapide de balises capable d'analyser des blocs arbitraires de données TLV, Parsomatic est l'outil qu'il vous faut.

Parsomatic est l'un des outils les plus populaires d'ID TECH. Il s'agit d'une page HTML autonome (sans dépendances externes ni logique serveur) utilisable dans n'importe quel navigateur web, sur toute plateforme, en ligne ou hors ligne. Son utilisation s'inscrit généralement dans l'un des trois scénarios suivants.

1. Si vous souhaitez connaître la fonction d'une balise EMV particulière, utilisez le petit champ de recherche en haut de la page pour effectuer une recherche rapide. Dans la capture d'écran ci-dessus, nous avons saisi « 5F20 », qui correspond au nom du titulaire de carte (Cardholder Name). Il s'agit d'une balise standard définie par EMVCo. Parsomatic permet également de rechercher les balises propriétaires d'ID TECH, dont il en existe plus de 100.
2. Si vous disposez d'un bloc de données hexadécimales contenant des données TLV (tag-longueur-valeur), vous pouvez les coller dans la zone de texte principale, cocher la case « TLVs only » (comme illustré ci-dessus ; regardez attentivement), puis cliquer sur le bouton Analyser. Parsomatic intègre un analyseur à descente récursive capable de traiter l'ensemble des TLV, y compris les TLV imbriqués, et de restituer les résultats sous deux formes différentes (voir ci-dessous).
3. Lorsque vous exécutez une transaction sur un appareil ID TECH (que ce soit par MagStripe, EMV contact ou sans contact), l'appareil génère un bloc de données conséquent encapsulé dans une enveloppe protocolaire. Parsomatic peut analyser ces données et les afficher de manière graphique, vous permettant ainsi de visualiser précisément la signification de chaque octet.

Après avoir analysé les données, Parsomatic les affiche de deux manières. La première section de l'affichage présente plusieurs lignes de données hexadécimales en texte coloré : les balises TLV apparaissent en bleu, les valeurs de longueur en orange, les données en noir, et tout ce qui n'a pas pu être analysé en rouge. En survolant l'un des éléments colorés, une info-bulle stylisée en CSS s'affiche pour expliquer l'élément concerné. Dans la capture d'écran ci-dessus, le curseur survole une balise TLV, 5F2A. L'info-bulle indique qu'il s'agit du code de devise de la transaction (Transaction Currency Code). (Dans les données affichées ci-dessus, le code est 0840, qui correspond au dollar américain.)

La deuxième façon dont Parsomatic affiche les données est sous forme d'un grand tableau :

Le texte est (de nouveau) coloré, avec les noms de balises en bleu, les longueurs en orange, etc.

Si vous avez collé des données de transaction dans la fenêtre, que ces données sont de type EMV (balises), et qu'elles contiennent la balise Tag 95, tous les indicateurs binaires de Tag 95 seront affichés en bas de la page :

Notez que Tag 95 contient cinq octets de données ; seuls les trois premiers sont illustrés dans l'exemple ci-dessus.

Dans les transactions par carte à puce, Tag 95 joue un rôle déterminant pour savoir si une transaction sera acceptée ou refusée. Quelques-unes des raisons possibles de refus sont illustrées dans la capture d'écran. Dans cet exemple, le bit de poids fort de l'octet 3 est activé, indiquant « La vérification du titulaire de la carte a échoué », et le bit 5 est également activé, indiquant « Saisie du code PIN requise, mais le lecteur de PIN est absent ou défaillant. » Parsomatic met automatiquement en surbrillance jaune tous les bits activés, ce qui vous permet de visualiser en un coup d'œil l'état de la transaction.

La logique de Parsomatic est entièrement en JavaScript, et tout le code est contenu dans le fichier HTML, ce qui vous permet d'en parcourir facilement le code source avec n'importe quel éditeur. Notez que l'analyseur est conçu pour être tolérant aux pannes (failsoft) : tout octet ne pouvant pas être interprété sera simplement ignoré (mais affiché en rouge à l'écran), plutôt que de provoquer l'arrêt de l'analyse par une exception. L'analyseur tentera d'ignorer les octets inconnus et de poursuivre l'analyse, partant du principe que vous souhaitez probablement connaître la signification du reste de vos données, même si une partie n'a pas pu être analysée correctement.

Parsomatic est un excellent outil d'apprentissage si vous débutez avec les ID TECH Products ou si vous développez des applications de paiement EMV. C'est également un outil de diagnostic très utile. (Et il est gratuit ! Que demander de plus ?)

Vous avez des questions sur la technologie de paiement ? Contactez nos experts : appelez le 1-800-984-1010 à tout moment.