Questa operazione permette di verificare la validità della carta. Consiste nell’inviare i dati di carta (come il numero di 16 cifre/PAN e la data di scadenza) ad Fabrick Payment Orchestra per ricevere in risposta l’esito.
Il metodo web service WSs2s da usare per questo scopo è il CallVerifycardS2S.
CallVerifycardS2S invia anche una chiamata autorizzativa di basso importo.
Questa è la lista dei campi obbligatori necessari per verificare la carta:
shopLogin – codice esercente
shopTransactionID – codice identificativo della transazione
cardNumber – numero della carta di credito
expMonth – mese di scadenza
expYear – anno di scadenza
CVV2 – Stringa contenente il CVV (Card Verification Value) stampato sul retro della carta, come specificato nel capitolo Gestione del campo CVV.
Il metodo CallVerifyCardS2S invia al gateway tutti i dati assegnati e restituisce il risultato dell’operazione.
Una volta eseguito, è possibile conoscere il risultato dell’operazione usando i valori dell’XML:
Prima di tutto è possibile usare il campo TransactionResult che restituisce la stringa OK se la transazione viene autorizzata o KO se viene negata.
Se TransactionResult restituisce esito KO, è possibile sapere se l’esito negativo viene dal circuito o meno usando il metodo ErrorCode:
Se ErrorCode restituisce un valore che è <> 0, la transazione è fallita a causa di problemi tecnici; il valore restituito varia a seconda della ragione specifica. Il metodo ErrorDescription restituisce una descrizione dell’errore (nella lingua specificata nel back office).
Se ErrorCode restituisce il valore 0, la transazione non è fallita per problemi tecnici. Usando ErrorCode è possibile conoscere il codice errore assegnato; la descrizione dell’errore viene mostrata usando il metodo ErrorDescription, nella lingua scelta a back office.
Se TransactionResult restituisce il valore OK, la transazione è stata autorizzata e la carta è valida.