Controllo carta

Questa funzione permette di verificare la validità della carta, come CallVerifyCardS2S, e anche di ottenere altre informazioni relative alla carta.

Il Check Carta consiste nello spedire alcuni dati di carta (come il numero di carta e la scadenza) ai server della banca per ricevere come contropartita altre informazioni, come per esempio la tipologia di strumento (carta prepagata, di credito, ecc).

Il metodo web service WSs2s corretto da utilizzare a questo scopo è il callCheckCartaS2S. Tuttavia, prima di usare questo metodo, occorre assegnare tutte le informazioni necessarie:

• shopLogin: codice assegnato all’esercente
• shopTransactionID: codice identificativo della transazione
• cardNumber: numero di carta di credito
• expMonth: card expiration month
• expYear: anno di scadenza della carta
• CVV2: Stringa contenente il CVV (Card Verification Value) stampato sul retro della carta, come specificato nel capitolo Gestire il campo CVV
• withAuth: Y richiede anche l’autorizzazione (di un importo a scelta); N non richiede l’autorizzazione.

Se viene impostato il flag Y su withAuth, il gateway effettua una richiesta autorizzativa, con relativa risposta OK o KO, senza poi addebitare realmente l’importo al cliente. Nel caso di flag N , vengono restituite solo le informazioni della carta richieste (come CallVerifyCardS2S ).

Dopo aver effettuato il metodo callCheckCartaS2S, è possibile conoscere il risultato dell’operazione utilizzando i valori presenti nei campi rilevanti:

• Innanzitutto è possibile usare il metodo TransactionResult che restituisce la stringa OK se il check è stato effettuato, o la stringa KO in caso contrario. In caso di errore, nei campi TransactionErrorCode e TransactionErrorDescription ci sono informazioni dettagliate.
• Il metodo AuthorizationResult restituisce la stringa OK se la transazione è stata autorizzata, KO in caso contrario.

• Se AuthorizationResult restituisce la stringa KO, è possibile conoscere se il diniego è dovuto ad una risposta negativa del circuito, utilizando il metodoAuthorizationErrorCode:

• SeAuthorizationResult restituisce un valore <> 0, la transazione è stata negata a causa di problemi tecnici; il valore restituito varia in base alla ragione specifica del diniego. Il metodo AuthorizationErrorDescription restituisce una descrizione della ragione del diniego (nella lingua specificata nel back office).

• Se AuthorizationErrorCode restituisce il valore 0, la transazione non è fallita per problemi tecnici. La descrizione dell’errore viene mostrata nella lingua specificata nel back office utilizzando il metodo AuthorizationErrorDescription.

• Se AuthorizationResult restituisce il valore OK, la transazione è stata autorizzata e la carta è considerata valida.

Approfondisci le descrizioni di altri campi nella sezione API.