Tools zur Integration von Zahlungsgeräten: Parsomatic

Die Integration eines Zahlungsperipheriegeräts in eine POS-App (oder eine andere Zahlungsanwendung) kann selbst unter optimalen Bedingungen eine anspruchsvolle Aufgabe sein. Eine gute Dokumentation ist dabei hilfreich – noch wertvoller sind jedoch die richtigen Werkzeuge.

ID TECH bietet eine Reihe kostenloser Tools, die den Integrationsprozess erleichtern. Eines unserer beliebtesten Tools, Parsomatic, wird auf dieser Website gehostet (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 (weiter hier). Darüber hinaus bieten wir ein Windows-basiertes (.NET) Hilfsprogramm an, das mit allen aktuell produzierten (und einigen älteren) ID TECH Products kompatibel ist und das wir UDemo (bzw. Universal SDK Demo) nennen. Es steht zusammen mit zahlreichen weiteren Demos und Hilfsprogrammen auf unserer Download-Seite zur Verfügung.

Wenn Sie gerade mit einer Integration beginnen oder neu im Bereich EMV sind und ein praktisches Tag-Lookup-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 eigenständige HTML-Seite (ohne externe Abhängigkeiten und ohne Server-Logik), die in jedem Webbrowser auf jeder Plattform verwendet werden kann – online wie offline. In der Regel 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-Lookup-Textfeld am oberen Seitenrand für eine schnelle Abfrage. Im obigen Screenshot haben wir „5F20" eingegeben, was dem Karteninhaber-Namen entspricht. Dabei handelt es sich um einen standardmäßig von EMVCo definierten Branchen-Tag. Sie können Parsomatic jedoch auch verwenden, um proprietäre ID TECH-Tags nachzuschlagen – davon gibt es über 100.
2. Wenn Sie über einen Hex-Datenblock mit TLV-Daten (Tag-Length-Value) verfügen, können Sie diesen in das Haupt-Texteingabefeld einfügen, anschließend das Kontrollkästchen „TLVs only" aktivieren (wie oben dargestellt; bitte genau hinsehen) und dann auf die Schaltfläche „Parse" klicken. Parsomatic verfügt über einen rekursiven Abstiegs-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 ausgeführt haben – ob per MagStripe, 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 aufbereitet darstellen, sodass Sie genau erkennen können, was jedes einzelne Byte bedeutet.

Nach der Analyse der Daten stellt Parsomatic diese auf zwei Arten dar. Der erste Bereich zeigt mehrere Zeilen Hex-Daten in farbig hervorgehobenem Text: TLV-Tags werden in Blau angezeigt, Längenwerte in Orange, Daten in Schwarz und alles, was nicht geparst werden konnte, in Rot. Wenn Sie mit der Maus über eines der farbig markierten Elemente fahren, erscheint ein CSS-formatierter Tooltip mit einer Erläuterung des jeweiligen Elements. Im obigen Screenshot befindet sich der Cursor über dem TLV-Tag 5F2A. Der Tooltip zeigt, 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 große Tabelle:

Der Text ist (erneut) farblich kodiert: Tag-Namen in Blau, Längenwerte in Orange usw.

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

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

Bei Chip-Karten-Transaktionen spielt Tag 95 eine wichtige Rolle bei der Entscheidung, ob eine Transaktion genehmigt oder abgelehnt wird. Einige mögliche Ablehnungsgründe sind im Screenshot zu sehen. In diesem Beispiel ist das oberste Bit von Byte 3 gesetzt und zeigt an: „Karteninhaberverifizierung war nicht erfolgreich." Zusätzlich ist Bit 5 gesetzt, was bedeutet: „PIN-Eingabe erforderlich, aber PIN-Pad nicht vorhanden oder nicht funktionsfähig." Parsomatic hebt alle gesetzten Bits automatisch gelb hervor, sodass Sie auf einen Blick erkennen können, was vor sich geht.

Die Logik von Parsomatic ist in reinem JavaScript geschrieben, und der gesamte Code befindet sich in der HTML-Datei – Sie können den Quellcode daher ganz einfach mit einem beliebigen Editor einsehen. Der Parser ist bewusst fehlertolerant ausgelegt: Bytes, die nicht interpretiert werden können, werden schlicht ignoriert (jedoch rot auf dem Bildschirm dargestellt), anstatt einen Abbruch mit einer Ausnahme auszulösen. Der Parser versucht, unbekannte Bytes zu überspringen und die Verarbeitung fortzusetzen – in der Annahme, dass Sie möglicherweise wissen möchten, was der Rest Ihrer Daten bedeutet, auch wenn ein Teil davon nicht korrekt geparst werden konnte.

Parsomatic ist ein hervorragendes Lernwerkzeug für alle, die gerade erst mit ID TECH Products oder der Entwicklung von EMV-Zahlungsanwendungen beginnen. Es ist darüber hinaus ein nützliches Tool zur Fehleranalyse. (Und es ist kostenlos! Was will man mehr?)

Haben Sie Fragen zur Zahlungstechnologie? Sprechen Sie mit unseren Experten: Rufen Sie jederzeit unter 1-800-984-1010 an.