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 complesso, anche nelle condizioni più favorevoli. Avere una buona documentazione è di grande aiuto. Avere buoni strumenti lo è ancora di più.

ID TECH offre una serie di strumenti gratuiti per semplificare il processo di integrazione. Uno dei più apprezzati, Parsomatic, è disponibile direttamente su questo sito (vai qui). Un altro strumento ampiamente utilizzato non solo dai clienti, ma anche dal personale di supporto interno di ID TECH, è il nostro Tool di Cifratura/Decifratura (vai qui). Disponiamo inoltre di un'utility basata su Windows (.NET), compatibile con tutti i ID TECH Products attualmente in produzione (e con alcuni modelli precedenti), denominata UDemo (o Universal SDK Demo). È disponibile, insieme a numerosi altri demo e utility, sulla nostra pagina dei download.

Se stai avviando 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 fa al caso tuo.

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

1. Per scoprire la funzione di un determinato tag EMV, è sufficiente utilizzare il piccolo campo di ricerca testuale nella parte superiore della pagina. Nello screenshot qui sopra, abbiamo inserito '5F20', che corrisponde al Nome del Titolare della Carta. Si tratta di un tag standard definito da EMVCo. Parsomatic consente tuttavia di ricercare anche i tag proprietari di ID TECH, che sono oltre 100.
2. Se si dispone di un blocco di dati esadecimali contenente dati TLV (tag-lunghezza-valore), è possibile incollare i dati nell'area di testo principale, selezionare la casella "TLVs only" (come mostrato sopra; osservare attentamente), quindi fare clic sul pulsante Analizza. Parsomatic è dotato di un parser a discesa ricorsiva in grado di analizzare tutti i TLV, compresi quelli annidati, e di restituire i risultati in due formati distinti (vedere di seguito).
3. Se hai eseguito una transazione su un dispositivo ID TECH (tramite banda magnetica, EMV a contatto o contactless), il dispositivo genererà un blocco di dati consistente, racchiuso in un wrapper di protocollo. Parsomatic è in grado di analizzare questi dati e visualizzarli graficamente, mostrandoti esattamente il significato di ogni byte.

Dopo aver analizzato i dati, Parsomatic li visualizza in due modalità. La prima sezione mostra più righe di dati esadecimali con testo a colori: i tag TLV in blu, i valori di lunghezza in arancione, i dati in nero e tutto ciò che non è stato possibile interpretare in rosso. Passando il cursore su uno qualsiasi degli elementi colorati, compare un tooltip in stile CSS che spiega cosa si sta visualizzando. Nello screenshot qui sopra, il cursore è posizionato su un tag TLV, 5F2A. Il tooltip indica che si tratta del Codice Valuta della Transazione. (Nei dati mostrati, il codice è 0840, che corrisponde al dollaro statunitense.)

La seconda modalità con cui Parsomatic visualizza i dati è tramite una grande tabella:

Anche in questo caso il testo è codificato a colori, con i nomi dei tag in blu, le lunghezze in arancione e così via.

Se hai incollato dati di transazione nella finestra, e si tratta di dati EMV (tag), e tali dati contengono il Tag 95, tutti i flag di bit del Tag 95 verranno mostrati in fondo alla pagina:

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

Nelle transazioni con carta a chip, il Tag 95 riveste un ruolo fondamentale nel determinare se una transazione verrà approvata o rifiutata. Alcuni dei possibili motivi di rifiuto sono visibili nell'immagine. In questo esempio, il bit più significativo del byte 3 è attivo, indicando che "la verifica del titolare della carta non è andata a buon fine"; è inoltre attivo il bit 5, che segnala che "è richiesta l'immissione del PIN, ma il lettore PIN è assente o non funzionante". Parsomatic evidenzia automaticamente in giallo i bit attivi, consentendo di comprendere immediatamente la situazione.

La logica di Parsomatic è scritta in puro JavaScript e tutto il codice è contenuto nel file HTML, quindi puoi consultarne il sorgente facilmente con qualsiasi editor. Il parser è progettato per essere failsoft, ovvero qualsiasi byte che non possa essere interpretato viene semplicemente ignorato (ma visualizzato in rosso sullo schermo), anziché causare l'interruzione del parsing con un'eccezione. Il parser tenterà di ignorare i byte sconosciuti e proseguire l'analisi, partendo dal presupposto che potresti voler conoscere il significato del resto dei tuoi dati anche se una parte di essi non è stata interpretata correttamente.

Parsomatic è un ottimo strumento didattico se stai muovendo i primi passi con i ID TECH Products o nello sviluppo di applicazioni di pagamento EMV. È anche uno strumento utile per la risoluzione dei problemi. (Ed è gratuito! Cosa c'è di meglio?)

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