技術記事

決済デバイス統合のためのツール：Parsomatic

2018年1月29日

決済周辺機器をPOSアプリ（またはその他の決済アプリ）に統合する作業は、最良の状況下であっても困難を伴うことがあります。優れたドキュメントがあれば助けになりますし、優れたツールがあればさらに役立ちます。

ID TECHでは、統合プロセスをより容易にするための無料ツールを多数提供しています。最も人気の高いツールの一つであるParsomaticは、当サイトでホストされています（こちらへこちら）。お客様だけでなくID TECHの社内サポートスタッフにも頻繁に利用されているもう一つのツールが、Encrypt/Decrypt Toolです（こちらへこちら）。また、現行生産中（および一部の旧型）のすべてのID TECH製品に対応するWindowsベース（.NET）のユーティリティもあり、UDemo（またはUniversal SDK Demo）と呼んでいます。他の多くのデモやユーティリティと併せて、ダウンロードページから入手できます。

統合作業を始めようとしている方、またはEMVに不慣れで、任意のTLVデータブロックも解析できるクイックなタグ検索ユーティリティを必要としている方は、Parsomaticをぜひご覧ください。

Parsomatic は、ID TECHで最も人気のあるツールの一つです。自己完結型のHTMLページ（外部依存なし、サーバーロジックなし）で、任意のWebブラウザ、任意のプラットフォーム、オンラインでもオフラインでも使用できます。通常、次の3つのシナリオのいずれかで使用します。

特定のEMVタグの機能を知りたい場合は、ページ上部の小さなタグ検索用テキスト入力フィールドを使って素早く検索できます。上のスクリーンショットでは「5F20」を入力していますが、これはCardholder Name（カード保有者名）です。これはEMVCoが定義した標準的な業界タグです。ただし、Parsomaticでは100以上あるID TECHの独自タグの検索にも使用できます。
TLV（タグ-長さ-値）データを含む16進データブロックがある場合、そのデータをメインのデータテキストエリアに貼り付け、「TLVs only」チェックボックスをチェックして（上図参照、よくご覧ください）、Parseボタンをクリックします。Parsomaticには再帰下降パーサーが搭載されており、ネストされたTLVを含むすべてのTLVを解析し、2つの異なる方法で結果を表示します（下記参照）。
ID TECHデバイス上で取引（磁気ストライプ、接触EMV、非接触のいずれであっても）を実行した場合、デバイスはプロトコルラッパーで包まれたかなりの量のデータを出力します。Parsomaticはそのデータを解析し、各バイトが何を意味するかを正確に確認できる形でグラフィカルに表示します。

データを解析した後、Parsomaticは2つの方法でそれを表示します。表示の最初のセクションでは、複数行の16進データが色分けされたテキストで表示され、TLVタグは青、長さの値はオレンジ、データは黒、解析できなかったものは赤で表示されます。色分けされた項目のいずれかにマウスオーバーすると、CSSでスタイル付けされたツールチップが表示され、何を見ているかが説明されます。上のスクリーンショットでは、カーソルがTLVタグ5F2Aの上に置かれています。ツールチップは、これがTransaction Currency Code（取引通貨コード）であることを示しています。（上のデータでは、コードは0840で、米ドルのコードです。）

Parsomaticがデータを表示する2つ目の方法は、大きなテーブル形式です：

テキストは（再び）色分けされ、タグ名は青、長さはオレンジなどで表示されます。

取引データをウィンドウに貼り付け、そのデータがEMV（タグ）データで、Tag 95が含まれている場合、Tag 95内のすべてのビットフラグがページ下部に表示されます：

Tag 95には5バイトのデータが含まれていますが、上記の例では最初の3バイトのみが表示されている点にご注意ください。

チップカード取引において、Tag 95は取引が承認されるか拒否されるかを決定する上で重要です。拒否となり得る理由のいくつかは、スクリーンキャプチャに示されています。この例では、バイト3の最上位ビットがオンになっており、「Cardholder verification was not successful（カード保有者認証が成功しなかった）」を示し、またビット5もオンになっており、「PIN entry required and PIN pad not present or not working（PIN入力が必要だがPINパッドが存在しないか動作していない）」を示しています。Parsomaticはオンになっているビットを自動的に黄色でハイライトするため、何が起きているかを一目で確認できます。

Parsomaticのロジックは純粋なJavaScriptで、すべてのコードはHTMLファイル内に含まれているため、任意のエディタで簡単にソースコードを参照できます。なお、コードのパーサーはフェイルソフト設計になっており、解釈できないバイトは単に無視され（ただし画面上では赤で表示されます）、例外で解析が中断されることはありません。パーサーは未知のバイトを無視して解析を続行しようとします。これは、データの一部が正しく解析されなかった場合でも、 残りの データが何を意味するか知りたい場合が十分にあり得るという考えに基づいています。

Parsomaticは、ID TECH製品の使用やEMV決済アプリの開発を始めたばかりの方にとって、優れた学習ツールです。また、便利なトラブルシューティングツールでもあります。（しかも無料です！気に入らない理由がありません。）

決済技術に関するご質問はございませんか？当社の専門家にお電話ください：1-800-984-1010までいつでもお気軽にどうぞ。