open menu
axerve docs
Pagamenti/Pagamenti con carta/Controllo carta

Controllo carta

SOAP

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 WSs2sapi link corretto da utilizzare a questo scopo è il callCheckCartaS2Sapi link. 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 CVVapi link

  • 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 CallVerifyCardS2Sapi link).

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, utilizzando il metodo AuthorizationErrorCode:

    • Se AuthorizationResult 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 APIapi link.

Precedente
prevPagamenti con carta
Successiva
Verifica cartanext