Integrazione touch point dell’EC con Checkout

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.

Parametri della redirect

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.

Selezione della Lingua

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.

Compatibilità Browser

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.