Nessun risultato trovato

Storno Contabile

Attraverso l’operazione di storno è possibile riaccreditare l’importo di una transazione già contabilizzata sullo strumento di pagamento originariamente utilizzato dal titolare. Lo Storno può essere totale o parziale e, in quest'ultimo caso, può essere ripetuto fino al raggiungimento dell'importo contabilizzato.

L'operazione di Storno è supportata dai seguenti metodi di pagamento:

  • Carte di credito, debito e prepagate

Invio del messaggio di storno contabile

Esempio messaggio HTTP di storno
id=99999999&password=99999999&tenantId=10&operationType=voidconfirmation&amount=1.00&currencyCod e=978&merchantOrderId=TrackingNo12345&paymentId=123456789012345

Parametri di chiamata del messaggio HTTP di storno

NOME DESCRIZIONE FORMATO
id Id associato al terminale N
Lunghezza max: 8
password Password associata all'id terminale AN
Lunghezza max: 50
tenantId Codice identificativo del servizio di acquiring di appartenenza dell'esercente. Nel caso in cui si tratti di un esercente convenzionato con Intesa inserire "10", altrimenti inserire "20". N
operationType 'voidconfirmation' AN
Lunghezza max: 50
amount Importo della transazione utilizzando il punto come separatore dei decimali (es: 1428,76€ = "1428.76"). La parte decimale può variare a seconda della valuta N Int. 18 - Dec. 4
currencyCode Codice numerico della currency (default '978' [euro]) N
Lunghezza max: 3
merchantorderid Riferimento Operazione inviato dal commerciante in fase di Inizializzazione (può contenere solo lettere e numeri e deve essere univoco in assoluto) AN
Lunghezza max: 18
paymentid Identificativo univoco della richiesta di autorizzazione sul Gateway AN
Lunghezza max: 18
customField Campo libero AN
Lunghezza max: 255
description Descrizione del pagamento AN
Lunghezza max: 255
Esempio messaggio XML di esito storno

Parametri di risposta al messaggio di storno

NOME DESCRIZIONE FORMATO
paymentid Identificativo univoco della richiesta di autorizzazione sul Gateway AN
Lunghezza max: 18
result Esito dello storno:
  • VOIDED = pagamento stornato
 AN
Lunghezza max: 20
responsecode Codice di risposta (es: '000' se transazione autorizzata, in tutti gli altri casi transazione negata) N
Lunghezza max: 3
authorizationcode Codice di autorizzazione, valorizzato solo se la transazione è stata autorizzata AN
Lunghezza max: 6
merchantOrderId Riferimento Operazione inviato dal commerciante in fase di Storno (può contenere solo lettere e numeri e deve essere univoco in assoluto) AN
Lunghezza max: 18
description Descrizione del pagamento AN
Lunghezza max: 255
customfield Campo libero inviato dal commerciante in fase di inizializzazione AN
Lunghezza max: 255

Comportamento del sistema in caso di errore in fase di storno

In caso di invio di parametri errati (es. terminale sconosciuto, password errata, tentativo di stornare un pagamento già completamente stornato, …) il Gateway risponde con un messaggio di errore in formato XML.

Tale messaggio comprende:

  • un codice di errore
  • una descrizione parlante dell’errore

Esempio messaggio di errore in fase di storno