Outils pour l'intégration de terminaux 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é est un atout précieux. Des outils performants le sont encore davantage.

ID TECH propose plusieurs outils gratuits pour faciliter 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 aussi par l'équipe d'assistance interne d'ID TECH, est notre outil de chiffrement/déchiffrement (accéder ici). Nous proposons également 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 que vous êtes novice en matière d'EMV et avez besoin d'un utilitaire de consultation rapide des tags capable d'analyser des blocs de données TLV arbitraires, nous vous recommandons de découvrir Parsomatic.

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) que vous pouvez utiliser dans n'importe quel navigateur web, sur toute plateforme, en ligne comme 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'un tag EMV particulier, utilisez le petit champ de saisie de recherche de tags situé en haut de la page pour effectuer une consultation rapide. Dans la capture d'écran ci-dessus, nous avons saisi « 5F20 », qui correspond au nom du titulaire de la carte. Il s'agit d'un tag standard défini par EMVCo. Parsomatic permet également de rechercher les tags 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 coller ces données dans la zone de texte principale, puis cocher la case « TLVs only » (comme indiqué ci-dessus ; regardez attentivement), puis cliquer sur le bouton Analyser. Parsomatic intègre un analyseur à descente récursive capable de traiter tous les TLV, y compris les TLV imbriqués, et d'en restituer les résultats de deux manières différentes (voir ci-dessous).
3. Si vous avez exécuté une transaction sur un appareil ID TECH (que ce soit par lecture de piste magnétique, par contact EMV ou sans contact), l'appareil génère un bloc de données conséquent, encapsulé dans une enveloppe de protocole. Parsomatic peut analyser ces données et les afficher graphiquement, de manière à vous permettre de comprendre la signification exacte de chaque octet.

Après l'analyse des données, Parsomatic les affiche de deux façons. La première section de l'affichage présente plusieurs lignes de données hexadécimales en texte coloré : les tags TLV apparaissent en bleu, les valeurs de longueur en orange, les données en noir, et tout ce qui n'a pas pu être interprété en rouge. En survolant l'un des éléments colorés, une info-bulle stylisée en CSS s'affiche pour vous expliquer ce que vous observez. Dans la capture d'écran ci-dessus, le curseur survole un tag 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, le code est 0840, qui correspond au dollar américain.)

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

Le texte est (là encore) coloré, avec les noms de tags 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 (données de tags), et qu'elles contiennent le Tag 95, tous les indicateurs binaires du Tag 95 seront affichés en bas de la page :

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

Dans les transactions par carte à puce, le Tag 95 joue un rôle déterminant pour savoir si une transaction sera approuvée ou refusée. Certaines des raisons possibles d'un refus sont illustrées dans la capture d'écran. Dans cet exemple, le bit de poids fort de l'octet 3 est activé, indiquant que « La vérification du porteur de carte n'a pas abouti », et le bit 5 est également activé, signalant qu'une « Saisie du PIN est requise mais le lecteur de PIN est absent ou hors service ». Parsomatic met automatiquement en surbrillance jaune tous les bits activés, afin que vous puissiez identifier en un coup d'œil ce qui se passe.

La logique de Parsomatic est en JavaScript pur, et tout le code est contenu dans le fichier HTML, ce qui vous permet d'en parcourir aisément le code source avec n'importe quel éditeur. À noter que l'analyseur du code est conçu pour fonctionner en mode dégradé (failsoft) : tout octet ne pouvant être interprété sera simplement ignoré (mais affiché en rouge à l'écran), plutôt que de provoquer l'arrêt de l'analyse avec 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 d'entre elles n'a pas été correctement interprétée.

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 dépannage très utile. (Et en plus, c'est gratuit ! Que demander de plus ?)

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