|
|
RTS DLL Per Pos Verifone
Il componente RtsPosVerifone.dll ha lo scopo di permettere ad un programma gestionale su PC, di gestire il collegamento con i terminali POS VERIFONE per il pagamento elettronico tramite la gestione denominata
Public Sub SetPassword(pwd As String)
Permette di abilitare completamente il componente tramite la password rilasciata da RTS Engineering snc . Tale metodo va eseguito una tantum prima dell'apertura della porta. La password deve essere di 8 caratteri.
Public Function GetPwdCode() As String
Tale metodo permette di leggere il codice interno a 8 cifre legato alla DLL da trasmettere a RTS Engineering per ricevere, previo pagamento, la password di abilitazione.
Public Function SetComPort(sPrt As String) As Boolean
Tale metodo permette di definire la porta di comunicazione (1 carattere numerico: Es. “1”)
Public Function OpenPort() As Boolean
Tale metodo permette di aprire la porta di comunicazione selezionata dalla precedente funzione SetComPort.
Public Function EseguiScambioImporto(importo As String) As String
Tale metodo gestisce completamente la procedura di scambio importo tra applicativo gestionale e POS Verifone.
IMPORTANTE: il parametro “importo” deve essere espresso in centesimi di Euro.
Il metodo restituisce una stringa composta da 5 campi così definiti:
1. Codice di ritorno della procedura
2. Messaggio esplicativo
3. PanCarta
4. TipoCarta
5. SocietaEmettitrice
Esempio:
“01/Transazione KO/***************5043/*/00”
Codifica del codice di ritorno della procedura (codici Verifone)
“00”: Procedura terminata correttamente
"94": Carta Non Ammessa
"95": Carta Estratta Troppo Presto
"96": Carta Irregolare
"97": Carta Bloccata
"98": Timeout Operazione
"99": Mancato Collegamento
Altri positivi: Transazione KO
Codici di errore negativi (aggiunti da RTS)
“-98” Comunicazione interrotta manualmente
"-99”: Password non valida (solo su Trace)
“-100”: Errore generico procedura (con indicazione del codice e descrizione dell'errore)
Public Sub SetConnectionTimeout (toutInSec As Integer)
Tale metodo definisce il parametro che indica il timeout di attesa in secondi della prima fase di connessione tra applicativo gestionale e POS Verifone, prima cioè della fase di connessione telefonica del POS.
Valore minimo: 30 secondi
Valore di default: 30 secondi
Public Sub SetTransactionResultTimeout (toutInSec As Integer)
Tale metodo definisce il parametro che indica il timeout di attesa in secondi della seconda fase di connessione tra applicativo gestionale e POS Verifone, e cioè la massima durata della fase di connessione telefonica del POS.
Valore minimo: 120 secondi
Valore di default: 300 secondi
Public Function SetTraceOnOff (traceOn As Boolean, traceDirectory As String, traceFile As String) As Boolean() As Boolean
Tale metodo permette di abilitare il salvataggio su file di log dei tracciati di comunicazione tra PC e POS Verifone, a scopo di verifica e di test.
Il primo parametro, se “True” abilita il trace sul file di log identificato dalla cartella “traceDirectory” e dal nome del file “traceFile”.
NB: è demandato al programma chiamante la DLL, la creazione della directory “traceDirectory”.
Il file di log va sempre in “append”.
Il metodo ritorna “True” se la directory è già esistente.
Es. di abilitazione del Trace:
SetTraceOnOff (true, “c:\temp”, “LogFile.txt”)
Es. di disabilitazione del Trace:
SetTraceOnOff (false, “”, “”)
Public Function GetConnectionStatus() As String
Questo metodo permette di interrogare lo stato della connessione tra DLL e POS Verifone durante la procedura di scambio importo. Sono stati identificati i seguenti stati:
1. "STATO DISCONNESSO"
2. "IN ATTESA DI CONNESSIONE CON IL POS"
3. "POS CONNESSO: IN ATTESA DI RISPOSTA DAL POS"
4. "RICEVUTA RISPOSTA DAL POS"
5. "OPERAZIONE TERMINATA"
Attenzione: si consiglia di interrogare con frequenza non superiore al secondo.
|
|
|
|
|
|
|
|
|