Tools für die Payment-Device-Integration: Parsomatic

Die Integration eines Zahlungsperipherals in eine POS-App (oder eine andere Zahlungsanwendung) kann selbst unter günstigen Bedingungen eine Herausforderung sein. Eine gute Dokumentation ist dabei hilfreich – noch wichtiger sind jedoch geeignete Tools.

ID TECH bietet eine Reihe kostenloser Tools, die den Integrationsprozess erleichtern. Eines unserer beliebtesten Tools, Parsomatic, wird auf dieser Website gehostet (hier geht's weiter hier). Ein weiteres Tool, das nicht nur von Kunden, sondern auch von ID TECHs internem Support-Team intensiv genutzt wird, ist unser Encrypt/Decrypt Tool (hier geht's weiter hier). Darüber hinaus steht ein Windows-basiertes (.NET) Hilfsprogramm zur Verfügung, das mit allen aktuell produzierten (sowie einigen älteren) ID TECH Products kompatibel ist – wir nennen es UDemo (bzw. Universal SDK Demo). Es ist zusammen mit zahlreichen weiteren Demos und Hilfsprogrammen auf unserer Download-Seite verfügbar.

Wenn Sie gerade eine Integration beginnen oder neu im Bereich EMV sind und ein schnelles Tag-Nachschlage-Tool benötigen, das auch beliebige TLV-Datenblöcke analysieren kann, sollten Sie sich Parsomatic genauer ansehen.

Parsomatic ist eines der beliebtesten Tools von ID TECH. Es handelt sich um eine in sich geschlossene HTML-Seite (ohne externe Abhängigkeiten, ohne Server-Logik), die in jedem Webbrowser auf jeder Plattform – online wie offline – verwendet werden kann. Typischerweise kommt es in einem von drei Szenarien zum Einsatz.

1. Wenn Sie wissen möchten, was ein bestimmter EMV-Tag bedeutet, nutzen Sie das kleine Tag-Nachschlage-Eingabefeld oben auf der Seite für eine schnelle Suche. Im obigen Screenshot haben wir „5F20" eingegeben – dabei handelt es sich um den Karteninhabernamen. Dies ist ein von EMVCo definierter Branchen-Standard-Tag. Mit Parsomatic lassen sich jedoch auch proprietäre ID TECH-Tags nachschlagen, von denen es über 100 gibt.
2. Wenn Sie einen Hex-Datenblock mit TLV-Daten (Tag-Length-Value) vorliegen haben, können Sie die Daten in das Haupteingabefeld einfügen, anschließend das Kontrollkästchen „TLVs only" aktivieren (wie oben gezeigt; bitte genau hinsehen) und dann auf die Schaltfläche „Parse" klicken. Parsomatic verfügt über einen rekursiven Parser, der alle TLVs – einschließlich verschachtelter TLVs – analysiert und die Ergebnisse auf zwei verschiedene Arten darstellt (siehe unten).
3. Wenn Sie eine Transaktion auf einem ID TECH-Gerät durchgeführt haben (ob per Magnetstreifen, Kontakt-EMV oder kontaktlos), gibt das Gerät einen umfangreichen Datenblock aus, der in einem Protokoll-Wrapper eingebettet ist. Parsomatic kann diese Daten analysieren und grafisch darstellen, sodass Sie genau erkennen, was jedes einzelne Byte bedeutet.

Nach der Analyse stellt Parsomatic die Daten auf zwei Arten dar. Der erste Abschnitt der Anzeige zeigt mehrere Zeilen von Hex-Daten in farblich hervorgehobenem Text: TLV-Tags in Blau, Längenwerte in Orange, Nutzdaten in Schwarz und nicht interpretierbare Daten in Rot. Wenn Sie den Mauszeiger über einen der farbcodierten Einträge bewegen, erscheint ein CSS-formatierter Tooltip, der den jeweiligen Inhalt erläutert. Im obigen Screenshot befindet sich der Cursor über dem TLV-Tag 5F2A. Der Tooltip zeigt an, dass es sich dabei um den Transaction Currency Code handelt. (In den oben dargestellten Daten lautet der Code 0840, was dem Code für US-Dollar entspricht.)

Die zweite Darstellungsform von Parsomatic ist eine übersichtliche Tabelle:

Der Text ist (wie zuvor) farblich kodiert – Tag-Namen in Blau, Längenangaben in Orange usw.

Wenn Sie Transaktionsdaten in das Eingabefeld eingefügt haben, es sich um EMV-Daten (Tag-Daten) handelt und diese Daten Tag 95 enthalten, werden alle Bit-Flags von Tag 95 am Ende der Seite angezeigt:

Hinweis: Tag 95 enthält fünf Datenbytes; im obigen Beispiel werden nur die ersten drei angezeigt.

Bei Chipkartentransaktionen spielt Tag 95 eine entscheidende Rolle bei der Frage, ob eine Transaktion genehmigt oder abgelehnt wird. Einige mögliche Ablehnungsgründe sind im Screenshot zu sehen. In diesem Beispiel ist das höchste Bit von Byte 3 gesetzt, was auf „Karteninhaberverifizierung nicht erfolgreich" hinweist; außerdem ist Bit 5 gesetzt, was bedeutet: „PIN-Eingabe erforderlich, aber PIN-Pad nicht vorhanden oder nicht funktionsfähig." Parsomatic hebt alle aktiven Bits automatisch gelb hervor, sodass Sie auf einen Blick erkennen, was vorliegt.

Die Logik von Parsomatic basiert auf reinem JavaScript, und der gesamte Code befindet sich in der HTML-Datei, sodass Sie den Quellcode problemlos mit einem beliebigen Editor einsehen können. Der Parser ist bewusst fehlertolerant ausgelegt: Bytes, die nicht interpretiert werden können, werden schlicht ignoriert (aber auf dem Bildschirm in Rot dargestellt) und führen nicht zu einem Abbruch mit einer Ausnahme. Der Parser versucht, unbekannte Bytes zu übergehen und die Analyse fortzusetzen – nach dem Grundsatz, dass Sie möglicherweise trotzdem wissen möchten, was der Rest Ihrer Daten bedeutet, auch wenn ein Teil davon nicht korrekt analysiert werden konnte.

Parsomatic ist ein hervorragendes Lernwerkzeug für alle, die gerade erst mit ID TECH Products oder der Entwicklung von EMV-Zahlungsapplikationen beginnen. Es eignet sich aber auch hervorragend zur Fehlerdiagnose. (Und es ist kostenlos – was gibt es da auszusetzen?)

Haben Sie Fragen zur Zahlungstechnologie? Unsere Experten helfen Ihnen gerne weiter: Rufen Sie uns jederzeit unter 1-800-984-1010 an.