Strumenti per l'integrazione di dispositivi di pagamento: UDemo

Gli sviluppatori di applicazioni di pagamento che necessitano di accelerare l'integrazione dei lettori di carte ID TECH nei propri sistemi POS (o in altri sistemi) possono avanzare rapidamente sfruttando l'Universal SDK di ID TECH. L'SDK fornisce librerie (e un'API comune) per gestire tutti i lettori di carte attualmente in produzione di ID TECH, inclusi i lettori per carte chip (EMV), a banda magnetica (MSR) e contactless, in diversi linguaggi di programmazione (come C# per Windows, Java per Android, Swift per iOS e C per Linux).

Non è necessario installare l'SDK, tuttavia, per eseguire il programma demo associato, un'applicazione standalone che chiamiamo Universal Demo, o semplicemente UDemo. È possibile ottenere UDemo (versione standalone per Windows) accedendo a qui.

Raccomandiamo a tutti i nostri clienti sviluppatori di familiarizzare con l'app UDemo, poiché illustra in dettaglio l'aspetto delle richieste e delle risposte grezze (da e verso il dispositivo), consente di configurare un dispositivo con impostazioni specifiche e offre un ambiente di test in cui gli sviluppatori possono facilmente sperimentare vari comandi con diversi valori di argomento, in tempo reale. UDemo è inoltre un ottimo strumento per approfondire la conoscenza di EMV.

Dopo aver eseguito il programma di installazione di UDemo, avviare l'applicazione. Verrà visualizzata una finestra simile alla seguente:

Tenere presente che è possibile collegare qualsiasi lettore di carte ID TECH supportato alla porta USB del computer in qualsiasi momento: verrà rilevato automaticamente da UDemo. Al riconoscimento del dispositivo, la struttura ad albero dei comandi (vedere "COMMANDS" in alto) si popolerà con i comandi specifici per il dispositivo in questione (mostrando, ad esempio, un gruppo "CTLS" se il dispositivo supporta le interazioni Contactless, "EMV" se il dispositivo supporta le transazioni con carta chip a contatto EMV, e così via).

Il flusso operativo di base è il seguente:

1. Collegare un dispositivo.
2. Navigare nella struttura ad albero dei comandi fino a trovare il comando desiderato.
3. Fare doppio clic sul comando nell'albero, OPPURE fare clic singolo sul pulsante verde Execute Command in fondo alla finestra.
4. Controllare il pannello Log per visualizzare le richieste e le risposte. (I valori inviati al dispositivo sono indicati con "OUT", mentre i valori ricevuti dal dispositivo sono indicati con "IN".)
5. Controllare il pannello Results (a destra) per visualizzare la spiegazione in linguaggio naturale di quanto è avvenuto.

Nella schermata precedente, il comando Start EMV Transaction è stato eseguito (su un lettore di carte ID TECH VP3300) utilizzando l'importo predefinito della transazione di $1,00. Il comando effettivamente eseguito è mostrato nella parte superiore del Log. Dal dispositivo sono state ricevute quattro risposte "IN". La prima risposta era un ACK, mentre le due successive contengono informazioni di stato relative ai messaggi LCD (come "Processing…") che potrebbe essere necessario visualizzare sul POS durante l'elaborazione della transazione. La quarta e ultima risposta IN contiene un blocco di dati TLV (tag-length-value) restituito dal lettore. Alcune delle elaborazioni TLV sono mostrate nel pannello Result.

Suggerimenti per UDemo

UDemo è uno strumento altamente interattivo che si impara meglio utilizzandolo direttamente. Per accelerare la curva di apprendimento, è utile tenere presenti i seguenti aspetti:

1. Molti comandi richiedono valori come argomento oppure possono essere configurati prima dell'esecuzione. È sufficiente fare clic singolo su un comando nell'elenco Comandi. Se il comando selezionato accetta valori aggiuntivi, i campi del modulo appropriati appariranno automaticamente appena sopra il pannello Log. Inserire i valori eventualmente richiesti, quindi fare doppio clic sul comando per eseguirlo con tali valori.
2. Il tastierino virtuale in alto a destra si attiva quando la carta inserita nel lettore richiede l'inserimento del PIN come uno dei metodi di verifica del titolare.
3. Appena sopra l'elenco dei comandi è presente un pulsante denominato Decryption. Fare clic su questo pulsante per aprire una finestra di dialogo che consente di decifrare i dati della transazione.
4. Sotto il pannello Log è presente un pulsante Start Capture to Disk (insieme a un pulsante Clear Logs e al pulsante Email Logs to Support). Il pulsante Start Capture è utile quando si desidera acquisire i dati di una sessione per un'analisi successiva. È anche possibile inviarci i risultati via e-mail (tramite il pulsante Email Logs) qualora si decida di aprire un caso di Supporto Tecnico.

Prima di eseguire una transazione EMV

Naturalmente, UDemo è soltanto uno strumento di test e non è in grado di addebitare effettivamente una transazione reale su una carta di credito; tuttavia, simulerà tutte e tre le fasi (Avvio, Autenticazione e Completamento) di una sessione EMV con contatto. Prima di poter eseguire i comandi di transazione, però, il lettore di carte dovrà essere sottoposto ad almeno alcune configurazioni, pena il fallimento della simulazione.

È possibile configurare rapidamente un dispositivo con impostazioni predefinite ragionevoli eseguendo tre comandi:

1. Per prima cosa, sotto il nodo AID dell'albero dei comandi, individuare Load Default AID ed eseguirlo. Si tratta di un'operazione batch che caricherà nel dispositivo una mezza dozzina di AID comuni. Attendere circa dieci secondi.
2. Successivamente, nel nodo CAPK dell'albero dei comandi, individuare il comando Load Default CAPK ed eseguirlo. Anche questo è un comando batch che richiederà alcuni secondi. Carica le chiavi pubbliche per i vari circuiti di pagamento, da utilizzare per la validazione degli artefatti crittografici prodotti da una carta con chip al momento della transazione. (ATTENZIONE: Le chiavi sono destinate esclusivamente ai test e non devono essere utilizzate in produzione. Richiedere le chiavi di produzione al proprio gateway o processore di pagamento.)
3. Infine, nel nodo Terminal Config dell'albero dei comandi, individuare ed eseguire Save Terminal Data. Questo comando caricherà i TLV predefiniti appropriati per il lettore, al fine di supportare le varie funzionalità del terminale.

Una volta eseguiti questi comandi, il lettore di carte conterrà i dati predefiniti appropriati e comandi come Start Transaction dovrebbero funzionare senza errori.

Per ulteriori informazioni

L'app UDemo offre ovviamente numerose funzionalità, troppe per essere descritte in questa sede. Il modo migliore per ottenere ulteriori informazioni? Guardare nell'angolo in basso a sinistra della schermata UDemo (fare riferimento all'immagine sopra) e individuare il pulsante rosa Documentation . Cliccando su quel pulsante, si aprirà un PDF in Acrobat Reader (a condizione che sia installato sul proprio computer), con la Guida Rapida all'avvio di UDemo.

Per comprendere il significato di tutti i byte esadecimali visualizzati in UDemo, sarà probabilmente necessario ottenere la guida API di basso livello (firmware) per il proprio lettore. Di norma è possibile scaricarla direttamente dalla sezione Downloads della nostra Knowledge Base pubblica (senza necessità di registrazione); tuttavia, alcuni documenti sono disponibili solo su richiesta. In tal caso, è possibile contattare il proprio referente ID TECH e i documenti necessari verranno forniti gratuitamente.

Hai domande sull'Universal SDK o su uno qualsiasi dei prodotti di ID TECH? Contatta i nostri esperti all'indirizzo 1-800-984-1010!