Integrazione touch point dell’EC con Checkout
Last updated
Last updated
L'integrazione del frontend dell'EC con la piattaforma pagoPA avviene per mezzo di Checkout, un’applicazione web che consente ad un utente la navigazione degli strumenti di pagamento resi disponibili dai PSP aderenti alla piattaforma pagoPA.
La navigazione del Checkout può avvenire solo in modalità Guest, viene richiesta una mail dove inviare l’esito dell’operazione.
L'integrazione con Checkout è attivata da una redirect dal frontend dell'EC che contiene i seguenti parametri in POST:
returnUrl: l'indirizzo al quale sarà reindirizzato l'utente dopo la conclusione del processo di pagamento;
fiscalCodePA: identificativo dell'EC che ha attivato il processo di pagamento;
lang: opzionalmente la lingua da utilizzare;
un array degli avvisi da pagare, per ognuno dei quale è necessario
noticeNumber: numero avviso
fiscalCode: codice fiscale dell'EC
amount: importo
agreement: eventuale codice della convenzione tra EC e PSP
Dopo la conclusione della sessione di pagamento Checkout effettua una redirect verso l'indirizzo indicato dall'EC in returnUrl aggiungendo il parametro outcome in POST (OK = esito positivo, KO = esito negativo), tale parametro indica l'esito del pagamento, nel caso di esito negativo saranno inviati anche i parametri
errorCode: codice dell'errore;
errorDescription: descrizione dell'errore.
Checkout effettua una redirect con outcome KO anche nel caso in cui la verifica delle eventuali convenzioni dia esito negativo.
L’EC, come precedentemente detto, può selezionare la lingua di avvio del Checkout aggiungendo il parametro lang. I valori ammessi sono:
it (it-IT): Italiano
en (en-US): Inglese
fr (fr-FR): Francese
sl (sl-SI): Sloveno
de (de-DE): Tedesco
Qualora il parametro non sia presente, oppure errato, verrà proposta la lingua di default.
Lo sviluppo del Checkout segue le linee guida di design per i servizi digitali della PA.
In particolare, viene assicurata la compatibilità con versioni dei browser che abbiano una penetrazione media tra la popolazione di almeno 1 persona ogni 100 abitanti.
Ciò significa che con i dati disponibili ad oggi i browser supportati sono:
Chrome
Safari
Firefox
Samsung Internet Browser
Edge
Opera
Il browser Internet Explorer 11 (IE-11) non rientra tra la lista dei browser supportati. Nel dettaglio, IE-11 non supporta gli standard web moderni ed è un freno all’implementazione all’interno delle nostre piattaforme di API web moderne e con misure di sicurezza più avanzate rispetto a quanto disponibile nel 2013.
