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’esercenteshopTransactionID
: codice identificativo della transazionecardNumber
: numero di carta di creditoexpMonth
: card expiration monthexpYear
: anno di scadenza della cartaCVV2
: Stringa contenente il CVV (Card Verification Value) stampato sul retro della carta, come specificato nel capitolo Gestire il campo CVVwithAuth
: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 stringaKO
in caso contrario. In caso di errore, nei campiTransactionErrorCode
eTransactionErrorDescription
ci sono informazioni dettagliate. - Il metodo
AuthorizationResult
restituisce la stringaOK
se la transazione è stata autorizzata,KO
in caso contrario. -
Se
AuthorizationResult
restituisce la stringaKO
, è possibile conoscere se il diniego è dovuto ad una risposta negativa del circuito, utilizando ilmetodoAuthorizationErrorCode
: 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 metodoAuthorizationErrorDescription
restituisce una descrizione della ragione del diniego (nella lingua specificata nel back office).-
Se
AuthorizationErrorCode
restituisce il valore0
, la transazione non è fallita per problemi tecnici. La descrizione dell’errore viene mostrata nella lingua specificata nel back office utilizzando il metodoAuthorizationErrorDescription
. - Se
AuthorizationResult
restituisce il valoreOK
, la transazione è stata autorizzata e la carta è considerata valida.
Approfondisci le descrizioni di altri campi nella sezione API.