Servizi di gestione del pagamento > Inquiry, interrogazione per transazione

Inquiry, interrogazione per transazione

Attraverso il messaggio sincrono di inquiry è possibile ottenere a posteriori le informazioni sull’esito di un pagamento.

Si consiglia di effettuare l'operazione di inquiry al termine della durata massima di una sessione di pagamento, ovvero dopo 20 minuti dalla generazione del paymentid.

Invio del messaggio di inquiry

Esempio messaggio HTTP di inquiry

id=99999999&password=99999999&tenantId=10&operationType=inquiry&paymentId=123456789012345

Parametri di chiamata del messaggio HTTP di inquiry

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	'Inquiry', per pagamenti con Carta di Credito 'Inquirymybank', per pagamenti MyBank	AN Lunghezza max: 50
paymentid	Identificativo univoco della richiesta di autorizzazione sul Gateway	AN Lunghezza max: 18

                                        Esempio messaggio XML di esito inquiry                                    

                                    <?xml version="1.0" encoding="UTF-8"?>
<response>
 <result>APPROVED</result>
 <paymentid>434166330386052949</paymentid>
 <transactiontime>2015-10-23T09:55:17.837+0200</transactiontime>
 <amount>0.10</amount>
 <currencycode>978</currencycode>
 <merchantorderid>2011IVR4189718Anti</merchantorderid>
 <authorizationcode>888620</authorizationcode>
 <threedsecure>H</threedsecure>
 <responsecode>000</responsecode>
 <customfield>some custom field</customfield>
 <description>some description</description>
 <rrn>123456789012</rrn>
 <cardcountry>ITALY</cardcountry>
 <cardbrand>MC</cardbrand>
 <cardtype>MONETA</cardtype>
 <maskedpan>539832**1283</maskedpan>
 <securitytoken>925a86bbbf0444809dbc37ab08ee1d87</securitytoken>
 <cardholderip>192.168.99.202</cardholderip>
</response>
                                

                                        Esempio messaggio XML di esito inquirymybank                                    

                                    <?xml version="1.0" encoding="UTF-8"?>
<response>
 <amount>0.10</amount>
 <authorizationcode>888621</authorizationcode>
 <currencycode>978</currencycode>
 <customfield>some custom field</customfield>
 <description>Some description</description>
 <merchantorderid>2011IVR4189718Anti</merchantorderid>
 <mybankid>7844111</mybankid>
 <paymentid>423129329528760639</paymentid>
 <result>AUTHORISED</result>
 <securitytoken>6afebc810bcf48bd9aff71d39c223dc4</securitytoken>
 <selectedbank>Intesa San Paolo</selectedbank>
 <transactiontime>2016-03-03 16:51:51.746</transactiontime>
</response>
                                

Parametri di risposta al messaggio di inquiry

NOME

DESCRIZIONE

FORMATO

result	Esito della transazione: APPROVED = transazione autorizzata NOT APPROVED = transazione negata AUTH VOIDED = transazione annullata CAPTURED = transazione confermata VOIDED = transazione stornata NOT AUTHENTICATED = autenticazione 3D fallita PARES ERROR = errore in fase di autenticazione 3D CANCELED = pagamento annullato dal titolare/pagatore AUTHORISED = bonifico MyBank autorizzato dalla Banca del pagatore [solo per pagamento MyBank] ERROR = bonifico MyBank non completato poiché negato dalla Banca del pagatore [solo per pagamento MyBank] AUTHORISINGPARTYABORTED = bonifico MyBank abbandonato dal pagatore (a seguito dell'accesso al portale della Banca) [solo per pagamento MyBank] TIMEOUT = bonifico MyBank non completato per superamento del tempo limite a disposizione [solo per pagamento MyBank] PENDING = pagamento in attesa di esito [solo per i pagamenti MyBank]	AN Lunghezza max: 32
paymentid	Identificativo univoco della richiesta di autorizzazione sul Gateway	AN Lunghezza max: 18
transactiontime	Ora della richiesta dell'autorizzazione (yyyy-MM-dd'T'HH:mm:ss.SSS±HH:mm) [Formato ISO 8601]	AN
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
authorizationcode	Codice di autorizzazione, valorizzato solo se la transazione è stata autorizzata	AN Lunghezza max: 6
threedsecure	Livello di sicurezza della transazione: S = transazione Full Secure H = transazione Half Secure N = transazione Not Secure	AN Lunghezza max: 1
responsecode	Codice di risposta (es: '000' se transazione autorizzata, in tutti gli altri casi transazione negata)	N Lunghezza max: 3
customfield	Campo libero inviato dal commerciante in fase di inizializzazione	AN Lunghezza max: 255
description	Descrizione del pagamento	AN Lunghezza max: 255
rrn	Riferimento univoco della transazione generato dal Sistema Autorizzativo (da utilizzare in caso di contabilizzazione esplicita a mezzo file)	AN Lunghezza max: 12
cardcountry	Nazionalità della carta di credito utilizzata	AN Lunghezza max: 255
cardbrand	Circuito e tipologia della carta di credito utilizzata ['Amex', 'Diners', 'Maestro', 'Mastercard', 'Visa', 'JCB']	AN Lunghezza max: 10
cardtype	Circuito e tipologia della carta di credito utilizzata (su richiesta) Amex Diners Maestro Mastercard Moneta Visa BAPAYPAL PAYPAL	AN Lunghezza max: 10
maskedpan	PAN mascherato della carta di credito utilizzata (nellaforma 123456******7890)	AN Lunghezza max: 19

Parametri di risposta al messaggio di inquiry: parametri facoltativi (solo per transazioni 3DSecure)

NOME

DESCRIZIONE

FORMATO

		securitytoken	Token di sicurezza	AN Lunghezza max: 32
		cardholderip	IP del titolare carta	AN Lunghezza max: 15

Parametri di risposta al messaggio di inquiry: parametri facoltativi (solo per MyBank)

NOME

DESCRIZIONE

FORMATO

		mybankid	ID transazione EBA	AN Lunghezza max: 35
		selectedbank	Banca selezionata dal Pagatore	AN Lunghezza max: 511

Comportamento del sistema in caso di errore in fase di inquiry

In caso di invio di parametri errati (es. terminale sconosciuto, password errata, riferimento transazione non univoco, …) 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 inquiry                                    

                                    <?xml version="1.0" encoding="UTF-8"?>
<error>
 <errorcode>GW00201</errorcode>
 <errormessage>Transaction not found.</errormessage>
</error>
                                