Pagamento

PAY

All’interno del flow per i pagamenti Server to Server è la servlet esposta per la richiesta di autorizzazione nel caso di circuiti non partecipanti al 3D Secure (verifyenrollment con result = [NOT SUPPORTED]); riceve in input tutti i dati del pagamento: dati ordine, dati carta (l'eci è opzionale, se presente, deve essere valorizzato con '07'); restituisce in output l'esito del pagamento.

Questa modalità di autorizzazione viene utilizzata anche per le transazioni MIT in quanto non necessitano un'autenticazione da parte del cliente.

PAYTHREESTEP

All’interno del flow per i pagamenti Server to Server è la servlet esposta per la richiesta di autorizzazione nel caso la carta abbia eseguito l'autenticazione sul sito dell'Issuer (verifyenrollment con result = [ ENROLLED, NOT ENROLLED ] ); riceve in input tutti i dati del pagamento: dati ordine, dati carta e dati 3D Secure; restituisce in output l'esito del pagamento.

Parametri di richiesta

		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 "pay" per i seguenti casi: Verifica enrollment con result NOT SUPPORTED Per pagamenti MIT 'paythreestep' per i seguenti casi: Verifica enrollment con result ENROLLED Verifica enrollment con result NOT ENROLLED "cardverification": per eseguire una verifica carta(ASI) senza addebito, con il solo scopo di verificare la validita di una carta. Con questa modalità sarà necessario valorizzare il campo "amount" a 0. "preauthorization": per eseguire una preautorizzazione, ovvero un blocco temporaneo di un importo specifico su una carta di pagamento. Sarà successivamente necessario eseguire un'operazione di contabilizzazione totale o parziale, se questa operazione non verrà eseguita entro il limite di tempo impostato nel back office, il Gateway libererà l'importo preautorizzato. AN paymentid Id associato alla sessione di pagamento (restituito dalla Verify Enrollment), da utilizzare solo nel caso PAYTHREESTEP Object 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 card Numero carta di credito N Lunghezza max: 19 cvv2 Codice di sicurezza della carta di credito N Lunghezza max: 4 expiryMonth Mese di scadenza della carta (mm) N Lunghezza max: 2 expiryYear Anno di scadenza della carta (aaaa) N Lunghezza max: 4 eci Electronic Commerce Indicator: indicatore del livello di sicurezza della transazione AN Lunghezza max: 2 xid Id univoco associato al processo 3D Secure, da utilizzare solo nel caso PAYTHREESTEP (ove restituito nella PaRes) AN Lunghezza max: 255 cavv Firma del pagamento, da utilizzare solo nel caso PAYTHREESTEP (ove restituito nella PaRes) AN Lunghezza max: 255 description Descrizione del pagamento AN Lunghezza max: 255 cardHolderName Nome del titolare carta Object Lunghezza max: 125 customField Campo libero AN Lunghezza max: 255

L'ECI deve essere valorizzato con il valore ricevuto nella verifyenrollment nel caso di NO 3D e con il valore ricevuto nella verifypares nel caso di transazione sicura (FULL o HALF).

Parametri di risposta

		NOME	DESCRIZIONE	FORMATO
result Esito della transazione: APPROVED = transazione autorizzata NOT APPROVED = transazione negata CAPTURED = transazione confermata AN Lunghezza max: 20 authorizationcode Codice di autorizzazione, valorizzato solo se la transazione è stata autorizzata AN Lunghezza max: 6 paymentid Id associato alla sessione di pagamento (restituito dalla Verify Enrollment), da utilizzare solo nel caso PAYTHREESTEP Object merchantorderid Riferimento Operazione scelto dal Commerciante (può contenere solo lettere e numeri e deve essere univoco in assoluto) AN Lunghezza max: 18 rrn Riferimento univoco della transazione generato dal Sistema Autorizzativo (da utilizzare in caso di contabilizzazione esplicita a mezzo file) AN Lunghezza max: 12 responsecode Codice di risposta (es: '000' se transazione autorizzata, in tutti gli altri casi transazione negata) N Lunghezza max: 3 cardtype Circuito e tipologia della carta di credito utilizzata (su richiesta) Amex Diners Maestro Mastercard Moneta Visa BAPAYPAL PAYPAL AN Lunghezza max: 10 cardcountry Nazionalità della carta di credito utilizzata AN Lunghezza max: 255 description Descrizione del pagamento AN Lunghezza max: 255 customfield Campo libero inviato dal commerciante in fase di inizializzazione AN Lunghezza max: 255 schematid Tid di circuito alfanumerico (inviato solo per pagamenti ricorrenti MIT). AN Lunghezza max: 15 walletid Token carta (inviato solo per pagamenti ricorrenti MIT). N Lunghezza max: 18