Strumenti per l'integrazione di dispositivi di pagamento: Parsomatic

Integrare un dispositivo di pagamento periferico in un'app POS (o in un'altra applicazione di pagamento) può essere un processo complesso, anche nelle condizioni più favorevoli. Una buona documentazione è di grande aiuto. Strumenti adeguati lo sono ancora di più.

ID TECH offre una serie di strumenti gratuiti per semplificare il processo di integrazione. Uno dei più utilizzati, Parsomatic, è disponibile direttamente su questo sito (vai qui). Un altro strumento molto usato non solo dai clienti, ma anche dal personale di supporto interno di ID TECH, è il nostro strumento di cifratura/decifratura (Encrypt/Decrypt Tool) (vai qui). Disponiamo inoltre di un'utility basata su Windows (.NET), compatibile con tutti gli ID TECH Products attualmente in produzione (e con alcuni modelli precedenti), denominata UDemo (o Universal SDK Demo). È disponibile, insieme a numerose altre demo e utility, nella nostra pagina dei download.

Se stai iniziando un'integrazione, o sei alle prime armi con EMV e hai bisogno di un'utility rapida per la ricerca dei tag in grado di analizzare anche blocchi arbitrari di dati TLV, Parsomatic è lo strumento che fa per te.

Parsomatic è uno degli strumenti più apprezzati di ID TECH. Si tratta di una pagina HTML autonoma (senza dipendenze esterne né logica server) utilizzabile in qualsiasi browser web, su qualsiasi piattaforma, sia online che offline. In genere viene impiegata in uno dei tre scenari seguenti.

1. Se desideri scoprire la funzione di un determinato tag EMV, utilizza il piccolo campo di ricerca testuale nella parte superiore della pagina per eseguire una ricerca rapida. Nello screenshot qui sopra, abbiamo inserito '5F20', che corrisponde al nome del titolare della carta (Cardholder Name). Si tratta di un tag standard definito da EMVCo. Con Parsomatic è però possibile ricercare anche i tag proprietari di ID TECH, che sono oltre 100.
2. Se disponi di un blocco di dati esadecimali contenente dati TLV (tag-length-value), puoi incollarlo nell'area di testo principale, selezionare la casella "TLVs only" (come mostrato sopra; osserva attentamente), quindi fare clic sul pulsante Parse. Parsomatic è dotato di un parser a discesa ricorsiva in grado di analizzare tutti i TLV, inclusi quelli annidati, e di presentare i risultati in due modalità diverse (vedi sotto).
3. Se hai eseguito una transazione su un dispositivo ID TECH (sia tramite MagStripe, EMV a contatto o contactless), il dispositivo restituirà un blocco di dati di dimensioni considerevoli, racchiuso in un wrapper di protocollo. Parsomatic è in grado di analizzare tali dati e visualizzarli graficamente, consentendo di identificare con precisione il significato di ogni singolo byte.

Dopo aver elaborato i dati, Parsomatic li visualizza in due modi. La prima sezione mostra più righe di dati esadecimali in testo colorato: i tag TLV sono in blu, i valori di lunghezza in arancione, i dati in nero e tutto ciò che non è stato possibile analizzare in rosso. Passando il cursore su uno qualsiasi degli elementi colorati, viene visualizzato un tooltip in stile CSS che spiega l'elemento selezionato. Nello screenshot precedente, il cursore è posizionato su un tag TLV, 5F2A. Il tooltip indica che si tratta del Codice Valuta della Transazione. (Nei dati mostrati sopra, il codice è 0840, che corrisponde al dollaro statunitense.)

Il secondo modo in cui Parsomatic visualizza i dati è attraverso una tabella estesa:

Il testo è (anche in questo caso) colorato, con i nomi dei tag in blu, le lunghezze in arancione e così via.

Se si incollano dati di transazione nella finestra, e tali dati sono in formato EMV (tag), e contengono il Tag 95, tutti i flag di bit del Tag 95 verranno visualizzati in fondo alla pagina:

Si noti che il Tag 95 contiene cinque byte di dati; nell'esempio precedente ne sono mostrati solo i primi tre.

Nelle transazioni con carta a chip, il Tag 95 è determinante per stabilire se una transazione verrà approvata o rifiutata. Alcune delle possibili cause di rifiuto sono mostrate nello screenshot. In questo esempio, il bit più significativo del byte 3 è attivo, il che indica "Verifica del titolare della carta non riuscita"; anche il bit 5 è attivo, indicando "PIN richiesto ma tastierino PIN assente o non funzionante." Parsomatic evidenzia automaticamente in giallo i bit attivi, consentendo di visualizzare immediatamente la situazione.

La logica di Parsomatic è scritta interamente in JavaScript e tutto il codice è contenuto nel file HTML, quindi è possibile consultare il codice sorgente con qualsiasi editor. Si noti che il parser è progettato per essere a tolleranza di errore (failsoft): i byte che non possono essere interpretati vengono semplicemente ignorati (ma visualizzati in rosso sullo schermo), anziché causare l'interruzione dell'analisi con un'eccezione. Il parser tenterà di ignorare i byte sconosciuti e di proseguire l'analisi, partendo dal presupposto che potrebbe comunque essere utile conoscere il significato del resto dei propri dati, anche se una parte di essi non è stata analizzata correttamente.

Parsomatic è un ottimo strumento di apprendimento per chi si avvicina per la prima volta ai ID TECH Products o allo sviluppo di applicazioni di pagamento EMV. È inoltre un utile strumento di diagnostica. (Ed è gratuito! Cosa si potrebbe volere di più?)

Hai domande sulla tecnologia dei pagamenti? Contatta i nostri esperti: chiama il numero 1-800-984-1010 in qualsiasi momento.