Protocolli di pagamento > Protocollo XML Hosted 3DSecure > Notifica

Notifica

A fronte del corretto inserimento dei dati della carta di credito da parte del titolare, il pagamento viene processato e viene fornita all'esercente una notifica dell’esito del pagamento stesso. La notifica viene effettuata tramite post HTTP in formato NVP (NameValue Pair) sull’url indicato nel parametro responseToMerchantUrl.

Tra i vari parametri passati in post, il securityToken è un codice di sicurezza generato dal Gateway di pagamento e comunicata all'esercente sia in fase di risposta alla inizializzazione, sia in fase di notifica dell’esito; per scopi di sicurezza, si consiglia di verificare che il valore del securityToken ricevuto in fase di notifica corrisponda a quanto ricevuto in fase di inizializzazione.

Al fine di poter redirigere la sessione web del titolare verso una nuova pagina contenente l’esito della transazione, l'esercente deve rispondere al messaggio di notifica appena ricevuto, con l’url della propria pagina di esito associando il 'paymentid' come parametro. Questo url può essere arricchito con dei parametri per consentire la corretta visualizzazione dell’esito stesso.
La risposta alla notifica dovrà essere in formato "Plain text".

ATTENZIONE: la risposta non deve contenere codice HTML.

I nostri servizi, all'atto della notifica di un pagamento hosted verso la merchant response URL, una volta instaurata la connessione, attendono per 20 secondi di ricevere in risposta la URL per la redirezione finale. Allo scadere del timeout, la socket viene chiusa.

Nel caso in cui la response URL presenti un certificato self-signed o emesso da CA secondarie, è necessario contattare il servizio di supporto.

Nel caso in cui la comunicazione dell’url di redirezione del titolare dovesse fallire (indisponibilità della pagina responseToMerchantUrl, contenuto della pagina responseToMerchantUrl non valido, timeout nella risposta o certificato non riconosciuto) il titolare verrà reindirizzato verso la pagina recoveryUrl, che viene comunicata dall'esercente stesso tramite l’apposito parametro del messaggio di Inizializzazione. Qualora il parametro recoveryUrl non fosse stato valorizzato il titolare verrà rediretto verso una pagina di cortesia.

Dalla pagina di dettaglio della transazione, dal portale di Back-Office, è possibile visualizzare gli errori di notifica con la relativa causale.

Esempio messaggio di esito del pagamento

Transazione autorizzata

authorizationcode=85963&cardcountry=ITALY&cardexpirydate=0115&cardtype=VISA&customfield=somecustom field&maskedpan=483054******1294&merchantorderid=TRCK0001&paymentid=123456789012345678&response code=000&result=APPROVED&rrn=123456789012&securitytoken=80957febda6a467c82d34da0e0673a6e &threedsecure=S

Pagamento annullato dal cardholder

paymentid=882244493221440719,result=CANCELED,threedsecure=N

Parametri del messaggio HTTP di Notifica esito del pagamento tramite carta

NOME

DESCRIZIONE

FORMATO

paymentid	Identificativo univoco dell'ordine generato dal Gateway, corrisponde allo stesso campo ricevuto in risposta durante la fase di Inizializzazione	AN Lunghezza max: 18
result	Esito della transazione: APPROVED = transazione autorizzata NOT APPROVED = transazione negata CAPTURED = transazione contabilizzata CANCELED = il cardholder ha annullato la transazione NOT AUTHENTICATED = autenticazione fallita SOFT DECLINE = transazione non permessa dall'emittente della carta, ritentare il pagamento UNEXPECTED ERROR = errore del sistema generico SYSTEM UNAVAILABLE = sistema momentaneamente non disponibile La risposta conterrà solo i parametri paymentid, result e threedsecure.	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
threedsecure	Livello di sicurezza della transazione: S = transazione Full Secure H = transazione Half Secure N = transazione Not Secure	AN Lunghezza max: 1
rrn	Riferimento univoco della transazione generato dal Sistema Autorizzativo (da utilizzare in caso di contabilizzazione esplicita a mezzo file)	AN Lunghezza max: 12
maskedpan	PAN mascherato della carta di credito utilizzata (nellaforma 123456******7890)	AN Lunghezza max: 19
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
cardexpirydate	Data di scadenza della carta di credito utilizzata (nel formato mmaa)	N Lunghezza max: 4
customfield	Campo libero inviato dal commerciante in fase di inizializzazione	AN Lunghezza max: 255
securitytoken	Token di sicurezza	AN Lunghezza max: 32
schematid	Tid di circuito alfanumerico (inviato solo per pagamenti ricorrenti MIT).	AN Lunghezza max: 15
walletid	Token carta (inviato solo per tokenizzazioni).	N Lunghezza max: 18

Parametri del messaggio HTTP di Notifica esito del pagamento tramite MyBank

Il protocollo MyBank, definito dal consorzio EBA, prevede che la risposta verso l'esercente venga inviata solo dopo che il cliente (Intestatario del conto) abbia fatto ritorno dalla pagina della Banca che ha scelto per effettuare il bonifico. Nei casi in cui il cliente non faccia ritorno dalla pagina della propria Banca e interrompa quindi il processo di pagamento, come da protocollo, il gateway offre la possibilità, attraverso lo strumento di inquiry, di conoscere in qualsiasi momento lo stato della transazione. L'integrazione MyBank è soggetta a certificazione e pertanto aderisce al protocollo del consorzio EBA.

NOME

DESCRIZIONE

FORMATO

paymentid	Identificativo univoco della richiesta di autorizzazione sul Gateway	AN Lunghezza max: 18
result	Esito della transazione: AUTHORISED = bonifico autorizzato dalla Banca del pagatore ERROR = bonifico non completato poiché negato dalla Banca del pagatore AUTHORISINGPARTYABORTED = bonifico abbandonato dal pagatore (a seguito dell'accesso al portale) CANCELED* = pagamento annullato dal pagatore (prima dell'accesso al portale della Banca). La risposta conterrà solo i parametri paymentid e result TIMEOUT = pagamento non confermato entro il limite stabilito (in genere di 15 minuti) PENDING = pagamento in attesa che la Banca comunichi l'esito	AN Lunghezza max: 32
description	Descrizione del pagamento	AN Lunghezza max: 255
authorizationcode	End-to-end ID del pagamento	AN Lunghezza max: 35
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
mybankid	Identificativo univoco del pagamento rilasciato dal circuito myBank	N Lunghezza max: 35
customfield	Campo libero inviato dal commerciante in fase di inizializzazione	AN Lunghezza max: 255
securitytoken	Token di sicurezza	AN Lunghezza max: 32

Update automatico delle transazioni MyBank

Tutti i pagamenti MyBank assumono lo stato PENDING (sui sistemi Nexi) in attesa che la Banca comunichi l'esito del bonifico. Il cliente ha tempo 15 minuti, dall'inizio della transazione, per confermare il bonifico. Oltre questo limite lo stato del pagamento sarà impostato a TIMEOUT dalla Banca.

Se il bonifico verrà autorizzato (AUTHORISED) o negato (ERROR) dalla Banca oppure annullato (AUTHORISINGPARTYABORTED) dal cliente sull'homebanking, lo stato sarà aggiornato coerentemente.

Quando il cliente non raggiunge o non fa ritorno dalla pagina della Banca, lo stato resterà PENDING sui sistemi Nexi, ma il merchant non riceverà notifica. Un batch automatico aggiornerà, ogni 8 minuti, interrogando i servizi MyBank, lo stato di eventuali pagamenti pending. È possibile forzare l'aggiornamento dello stato di un pagamento in stato pending in qualsiasi momento attraverso il servizio di inquirymybank.

*Il pagamento potrà assumere lo stato CANCELED nei seguenti scenari:

Qualora non fosse possibile associare uno stato finale ad un pagamento (aggiornamento batch, l'esercente non riceverà alcuna notifica)
Qualora il cliente dovesse abbandonare la sessione prima della scelta Banca (aggiornamento batch, l'esercente non riceverà alcuna notifica)
Qualora il cliente dovesse cliccare su “Annulla la transazione” dalla pagina di scelta banca (l'esercente riceverà relativa notifica)

Parametri del messaggio HTTP di Notifica esito del pagamento tramite PayPal

NOME

DESCRIZIONE

FORMATO

paymentid	Identificativo univoco della richiesta di autorizzazione sul Gateway	AN Lunghezza max: 18
result	Esito della transazione: APPROVED = transazione autorizzata CAPTURED = transazione confermata PENDING = transazione sospesa in attesa di verifica	AN Lunghezza max: 20
responsecode	Codice di risposta (es: '000' se transazione autorizzata, in tutti gli altri casi transazione negata)	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
cardtype	Circuito e tipologia della carta di credito utilizzata (su richiesta) Amex Diners Maestro Mastercard Moneta Visa BAPAYPAL PAYPAL	AN Lunghezza max: 10
securitytoken	Token di sicurezza	AN Lunghezza max: 32

package sample;

// Protocollo XML Hosted 3DSecure - Notifica

import java.util.HashMap;
import java.util.Map;

public class Notify {

private final String RESULT_PAGE_URL = GlobalVariables.MERCHANT_DOMAIN + "result.jsp?";
	private final Map<String, String[]> parameters;

public Notify(Map<String, String[]> parameters) {
		this.parameters = parameters;
	}

public String getResultPage() {
		String paymentId = parameters.get("paymentid")[0];

Map<String, String> results = new HashMap<String, String>();
		for (String key : parameters.keySet()) {
			results.put(key, parameters.get(key)[0]);
		}

GlobalVariables.payment_results.put(paymentId, results);
		return RESULT_PAGE_URL + String.format("paymentid=%s", paymentId);
	}
	// paymentid: parameters["paymentid"],
	// result: parameters["result"],
	// authorizationcode: parameters["authorizationcode"],
	// rrn: parameters["rrn"],
	// merchantorderid: parameters["merchantorderid"],
	// responsecode: parameters["responsecode"],
	// threedsecure: parameters["threedsecure"],
	// maskedPan: parameters["maskedpan"],
	// cardcountry: parameters["cardcountry"],
	// customfield: parameters["customfield"],
	// securityToken: parameters["securitytoken"]

}

using System;
using System.Collections.Generic;
//using System.Linq;
using System.Web;
using System.Web.UI;
using System.Web.UI.WebControls;

// Protocollo XML Hosted 3DSecure - Notifica

namespace AspNetAntiguaHosted
{
    public partial class Notify : System.Web.UI.Page
    {
        private const string cardHolderRedirectUrl = GlobalVariables.MERCHANT_DOMAIN + "result.aspx";
        private System.Collections.Specialized.NameValueCollection parameters;
        //private Dictionary<string, string[]>  parameters;

protected void Page_Load(object sender, EventArgs e)
        {
            this.parameters = Request.Params;

//string id = Request["paymentid"];
            //string result = Request["result"];
            //string authorizationcode = Request["authorizationcode"];
            //string rrn = Request["rrn"];
            //string merchantorderid = Request["merchantorderid"];
            //string responsecode = Request["responsecode"];
            //string securitytoken = Request["securitytoken"];
            //string threedsecure = Request["threedsecure"];
            //string maskedpan = Request["maskedpan"];
            //string cardcountry = Request["cardcountry"];
            //string customfield = Request["customfield"];

Response.Write(string.Format("{0}?result={1}&paymentid={2}", cardHolderRedirectUrl, parameters.Get("result"), parameters.Get("paymentid")));
            
        }
    }
}

COPIA CODICE

AREA TEST