Tabella dei contenuti
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.
.png)
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
Dicci cosa ne pensi
Per chiarimenti sulle specifiche d’implementazione, come SACI e SANP, puoi aprire una segnalazione su GitHub