Nessun risultato trovato

Conferma del pagamento (richiesta di contabilizzazione)

Attraverso l’operazione di conferma è possibile richiedere la contabilizzazione di una transazione autorizzata. La Conferma può essere richiesta una sola volta e la somma da contabilizzare può essere totale o parziale.

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

  • Carte di credito, debito e prepagate

Invio del messaggio di conferma pagamento

Esempio messaggio HTTP di conferma pagamento
id=99999999&password=99999999&tenantId=10&operationType=confirm&amount=1.00& currencyCode=978& merchantOrderId=TrackingNo12345&paymentId=123456789012345

Parametri di chiamata del messaggio HTTP di conferma pagamento

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 'confirm' 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 conferma

Parametri di risposta al messaggio di conferma

NOME DESCRIZIONE FORMATO
paymentid Identificativo univoco della richiesta di autorizzazione sul Gateway AN
Lunghezza max: 18
result Esito della conferma:
  • CAPTURED = transazione confermata
 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 Inizializzazione (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 conferma

In caso di invio di parametri errati (es. terminale sconosciuto, password errata, tentativo di confermare un pagamento già confermato, tentativo di confermare un pagamento per un importo maggiore rispetto a quanto autorizzato, …) 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 conferma