PagoPA ha sviluppato un nuovo portale B2B il quale, attraverso l’accesso all’ Area Riservata, è il canale dedicato di interfaccia alla piattaforma pagoPA (Back Office) per i PSP, gli Enti Creditori ed i loro eventuali Partner/Intermediari tecnologici.

Il Back Office è nato per offrire ai vari stakeholder un unico luogo da cui attivare e integrare uno dei prodotti di PagoPA, al fine di semplificare le procedure di adesione alle singole piattaforme e, successivamente, configurare e gestire in autonomia i relativi servizi.

A quale esigenza rispondiamo?

Fino a dicembre 2023, l’adesione alle diverse piattaforme in carico a PagoPA S.p.A. e la relativa integrazione dei servizi avveniva tramite tools specifici, secondo procedure distinte. Area Riservata e, di conseguenza, Back Office pagoPA garantiscono una maggior semplicità nella fruizione dei servizi, con un'unica interfaccia ed una user experience moderna e intuitiva.

Quale soluzione adottiamo?

L’introduzione del nuovo portale Back Office pagoPa costituisce un unico tool che permette agli stakeholder di gestire in autonomia - dalla propria area riservata - tutti i prodotti in modo semplice, coerente e standardizzato, riducendo l’effort di integrazione e configurazione, ad oggi gestiti tramite processi manuali.

L’adesione e la firma della documentazione contrattuale è stata automatizzata.

L’accesso al nuovo portale Area Riservata avviene attraverso SPID/CIE. Ciascun Referente amministrativo potrà delegare un subset di funzionalità ai diversi profili utente.

Impatti

L'adozione sarà obbligatoria da parte di EC, PSP e Partner/Intermediari tecnologici, ma non richiederà nessun adeguamento tecnico da parte degli stessi.

Perché è importante adeguarsi

L’adozione del nuovo portale offre benefici in termini di semplificazione dei processi, senza comportare alcun adeguamento tecnico da parte di PSP ed EC.

La funzionalità consentirà all’Utente di recuperare gli Avvisi di pagamento di cui è debitore in maniera semplice e rapida.

A quale esigenza rispondiamo?

La necessità di fornire all’Utente la possibilità di recuperare facilmente e attraverso un unico punto di accesso (es. app mobile, touchpoint fisico o digitale) tutti gli Avvisi di pagamento emessi a suo carico.

Quale soluzione adottiamo?

La funzionalità consentirà all’Utente, in modalità diretta o per il tramite di un PSP autorizzato, di recuperare gli Avvisi di pagamento di cui è il debitore. Ottenuta la lista di tutti gli Avvisi di pagamento a suo carico, l’Utente potrà procedere con il pagamento di tutti o solo alcuni di essi su diversi canali che saranno messi a disposizione (come avviene oggi dai singoli PSP o da PagoPA). La funzionalità dei Pagamenti pull apre alla possibilità di poter informare l'Utente della presenza di Avvisi di pagamento a proprio carico anche in situazioni in cui l'Utente stesso stia interagendo con PagoPA o altri soggetti collegati (es. durante una operazione di prelievo presso un ATM e/o di pagamento di un altro avviso).

Impatti

L'integrazione avverrà attraverso specifiche primitive sfruttando anche le integrazioni previste per le altre funzionalità presenti in roadmap.

Perché è importante adeguarsi

L'adeguamento è obbligatorio perché è un servizio ad alto valore aggiunto per il cittadino.

Serve supporto?

Per gli sviluppatori è possibile aprire una issue su GitHub.

Per altri chiarimenti suggeriamo di rivolgersi all’Account PagoPA di riferimento.

Lo Stand In è una funzionalità che consente agli Utenti di procedere con il pagamento degli Avvisi anche nei momenti di indisponibilità dei sistemi degli Enti Creditori; le specifiche tecniche e di ingaggio sono disponibili nelle SANP, a partire dalla versione 3.6.0.

A quale esigenza rispondiamo?

Al fine di migliorare le performance e la disponibilità della piattaforma pagoPA, la soluzione permetterà di gestire l'autorizzazione delle operazioni di pagamento anche in caso di indisponibilità e/o problemi sui sistemi dei soggetti direttamente connessi al Nodo dei pagamenti che gestiscono le posizioni debitorie (EC, PT, IT). La funzionalità Stand In utilizzerà le informazioni disponibili nell’Archivio Centralizzato Avvisi “ACA” e si attiverà in automatico.

La Società è inserita nell’elenco dei “fornitori critici di infrastrutture o servizi” e, in quanto tale, è assoggettata alla sorveglianza di Banca d’Italia ai sensi dell’art. 20 del Provvedimento del 9 novembre 2021 attuativo dell’art. 146 TUB. La funzionalità di Stan In risponde alla necessità di assicurare un insieme di misure di continuità operativa.

Quale soluzione adottiamo?

Nel caso in cui l'EC non risponda nel tempo massimo previsto alla richiesta di verifica o attivazione di un avviso di pagamento, la piattaforma attiverà la funzionalità Stand In.

Il sistema procederà quindi a verificare la presenza dell'avviso di pagamento su ACA.

Se l'avviso di pagamento è stato correttamente caricato nell'ACA, la piattaforma pagoPA potrà confermare l'importo dell'avviso e consentirà al cittadino di procedere al pagamento. In questo caso, il pagamento verrà gestito in modalità Stand In.

Al termine del pagamento, pagoPA proverà ad effettuare l'invio della ricevuta tramite la "paSendRT" utilizzando le modalità standard.

Tuttavia, se l'avviso di pagamento non è presente in ACA, il cittadino non sarà in grado di procedere al pagamento poiché pagoPA non dispone dei dati necessari.

Impatti

Per gli EC integrati con modalità sincrona è obbligatoria l'adesione alla funzionalità di ACA. Nei casi di non aggiornamento della posizione debitoria con attualizzazione dell'importo da parte dell'Ente Creditore, sarà l'Ente stesso successivamente a dover gestire l'eventuale disavanzo. Pertanto gli impatti sono relativi all'attivazione di questa funzionalità propedeutica.

Gli EC devono essere in grado di gestire importi potenzialmente non attualizzati relativi agli avvisi di pagamento pagati in modalità Stand In; questo si verifica perché potrebbe essere necessario gestire pagamenti in cui l'importo non è stato precedentemente aggiornato su ACA.

Perché è importante adeguarsi

Lo Stand In permette di assicurare misure di continuità operativa. L'adeguamento è importante poichè garantisce all’Utente la possibilità di pagare gli Avvisi anche nei momenti di indisponibilità dei sistemi degli EC, con conseguente miglioramento delle performance del servizio offerto.

Serve supporto?

Per gli sviluppatori è possibile aprire una issue su GitHub,

per altri chiarimenti suggeriamo di rivolgersi all’Account PagoPA di riferimento.

Domande frequenti

Per i PSP

I pagamenti che necessitano di Stand In saranno evidenziati in qualche modo?

Per identificare e distinguere i pagamenti gestiti tramite il processo di Stand In da quelli gestiti mediante il processo standard, gli EC ed i PSP che vogliono ricevere tale informazione, devono adeguare il proprio software per la gestione del nuovo flag (https://docs.pagopa.it/sanp/specifiche-attuative-del-nodo-dei-pagamenti-spc/funzionamento-generale/stand-in).

Questo perché l'informazione deve arrivare anche all'Ente Creditore in relazione alla possibile mancata attualizzazione dell'importo.

Per gli EC

Quali sono le integrazioni previste per attivare la funzionalità Stand In?

E' necessaria l'adesione alla funzionalità di ACA (Archivio Centralizzato Avvisi) per poter fornire alla piattaforma pagoPA tutte le informazioni necessarie alla gestione dello Stand In.

In quali casi viene attivato lo Stand In?

L'attivazione dello Stand In è automatica ed avviene quando la piattaforma pagoPA non riceve risposta dall'EC alle primitive previste dal workflow di pagamento.

Tutte le regole di ingaggio dello Stand In e relativi impatti sono definite nelle SANP 3.6.1

A quale esigenza rispondiamo?

PagoPA ha realizzato un archivio contenente le principali informazioni relative agli avvisi di pagamento emessi da tutti gli Enti Creditori aderenti per garantire la continuità di servizio anche a fronte di disservizi e/o indisponibilità dei propri sistemi.

Quale soluzione adottiamo?

L'Archivio Centralizzato Avvisi (ACA) contiene le principali informazioni necessarie alla continuità del servizio.

La comunicazione dei dati necessari avverrà tramite l'utilizzo di nuove specifiche primitive, invocate dall’EC a seguito di un determinato evento che verrà definito nelle specifiche stesse.

La funzionalità non implica alcuna gestione della posizione debitoria da parte di PagoPA, né modifiche al workflow di pagamento della piattaforma pagoPA.

Qualora l’ente prediliga procedere con l’integrazione sincrona invece dell'integrazione asincrona, l’adesione all’archivio centralizzato avvisi diventa obbligatoria.

Con riferimento ai soli soggetti diversi dalle pubbliche amministrazioni rimane facoltà dell’ente scegliere se alimentare l’archivio centralizzato avviso (sempre in caso di integrazione sincrona).

Impatti

L'EC dovrà integrare specifiche primitive messe a disposizione dalla piattaforma pagoPA.

Trovate la relativa documentazione al seguente link: https://docs.pagopa.it/sanp/ente-creditore/modalita-dintegrazione/integrazione-tramite-api-sincrone

Perché è obbligatorio adeguarsi

La Società è inserita nell’elenco dei “fornitori critici di infrastrutture o servizi”, e in quanto tale è assoggettata alla sorveglianza di Banca d’Italia ai sensi dell’art. 20 del Provvedimento del 9 novembre 2021 attuativo dell’art. 146 TUB. La messa a disposizione dell'Archivio Centralizzato Avvisi risponde alla necessità di assicurare un insieme di misure di continuità operativa.

Serve supporto?

Per gli sviluppatori è possibile aprire una issue su GitHub.

Per altri chiarimenti suggeriamo di rivolgersi all’Account PagoPA di riferimento.

A quale esigenza rispondiamo?

La possibilità di recuperare e stampare la ricevuta di pagamento di un Avviso è una funzionalità importante per gli Utenti che potrebbero avere la necessità di recuperarle anche dopo molto tempo rispetto al momento del pagamento. Oggi non esiste un unico archivio dove l’Utente può ritrovare tutte le ricevute; tale funzionalità consente di soddisfare questa esigenza. Ricordiamo, in ogni caso, che a fini liberatori l’Utente dovrà sempre rivolgersi all’Ente Creditore per ottenere la relativa quietanza.

Quale soluzione adottiamo?

PagoPA metterà a disposizione degli Utenti la possibilità di stampare una copia della ricevuta sul canale di appIO; l'Utente autenticato potrà effettuare una ricerca tra gli Avvisi di pagamento pagati o intestati a quel codice fiscale.

Impatti

Non si prevedono impatti perché tutte le informazioni necessarie sono già a disposizione della piattaforma pagoPA nel normale flusso di pagamento.

Perché è importante adeguarsi

Non è previsto alcun adeguamento, la funzionalità sarà disponibile senza impatti per gli EC.

Serve supporto?

Per gli sviluppatori è possibile aprire una issue su GitHub.

Per altri chiarimenti suggeriamo di rivolgersi all’Account PagoPA di riferimento.

PagoPA metterà a disposizione degli EC una nuova funzionalità per la produzione di un Pdf “stampabile”dell’Avviso di pagamento pagoPA, con la possibilità per gli EC di gestire l’intero ciclo di vita dell'Avviso stesso, dalla generazione alla stampa, al pagamento e alla rendicontazione.

A quale esigenza rispondiamo?

La gestione del ciclo di vita dell’Avviso di pagamento è una attività complessa. In particolare, una componente critica è rappresentata dall'implementazione delle funzionalità di generazione e stampa nel rispetto delle performance e delle evoluzioni delle specifiche. Gli EC hanno necessità di una soluzione semplice, ma che allo stesso tempo consenta di governare tutte le funzionalità legate alla gestione della posizione debitoria, inclusa la stampa dell'Avviso di pagamento.

Quale soluzione adottiamo?

PagoPA metterà a disposizione degli EC una nuova primitiva per generare il Pdf dell’Avviso di pagamento pagoPA, con la possibilità, quindi, per gli EC di gestire l’intero ciclo di vita dell'Avviso di pagamento, dalla generazione alla stampa.

Il servizio sarà connesso con l'integrazione asincrona o disponibile per gli EC che lo gestiscono in autonomia. Ciò consente di semplificare i processi di gestione delle posizioni debitorie. L'adesione al servizio da parte dell'EC è facoltativa.

Impatti

L'EC interessato ad aderire al servizio dovrà integrare una nuova primitiva (API Rest) che consentirà di gestire la stampa dell'Avviso di pagamento tramite la piattaforma pagoPA.

Perché è importante adeguarsi

L'adesione al servizio da parte dell'Ente Creditore è facoltativa.

L'utilizzo della funzionalità consente all'Ente Creditore di semplificare notevolmente il processo di gestione della posizione debitoria, delegando a PagoPA la stampa dell'Avviso di pagamento tramite una semplice integrazione o, in maniera trasparente, nel caso di adesione ad altre iniziative (es. Integrazione Asincrona).

Serve supporto?

Per altri chiarimenti suggeriamo di rivolgersi all’Account PagoPA di riferimento.

Domande frequenti

Per gli EC

Ci sono relazioni con la funzionalità di "integrazione asincrona"?

Se un EC usufruisce del servizio di integrazione asincrona è possibile combinare anche la funzionalità di stampa degli Avvisi di pagamento, senza la necessità di una primitiva ad hoc, semplicemente integrando la richiesta nella gestione delle posizioni debitorie.

Quali opzioni vengono fornite per l'invio dell'Avviso di pagamento in caso di adesione?

Le opzioni di invio rimangono invariate. Lo scopo della funzionalità in questione è di fornire Avvisi di pagamento secondo gli standard PagoPA, alleggerendo l'effort di sviluppo, integrazione ed adeguamento allo standard in carico all'EC.

Roadmap 2023-2024

Una vista approfondita

Di seguito gli interventi previsti nel 2023/2024 e le relative date di adeguamento.

Archivio centralizzato avvisi -->

Stand In -->

Pagamenti pull -->

Stampa ricevute per cittadino -->

Stampa avvisi pagoPA per Enti -->

Opzioni di pagamento -->

Flussi di rendicontazione ->

Quality Improvement -->

PagoPA metterà a disposizione degli EC una funzionalità per gestire le opzioni di pagamento, come ad esempio i piani rateali, le maggiorazioni o le riduzioni dell’importo.

A quale esigenza rispondiamo?

La possibilità di avere a disposizione ulteriori opzioni di pagamento permetterà di soddisfare la crescente richiesta di gestione dei casi di maggiorazione o di riduzione dell’ importo, nonché dei piani rateali.

Quale soluzione adottiamo?

Si andrà ad estendere la possibilità di richiamare le primitive “verifyPaymentNotice” e “paVerifyPaymentNotice”, che gestiranno anche i casi specifici delle diverse opzioni di pagamento.

Impatti

Gli EC e i PSP dovranno adeguare le chiamate alle primitive messe a disposizione dalla piattaforma pagoPA per poter gestire le diverse opzioni di pagamento.

Perché è importante adeguarsi

L'adesione al servizio da parte dell'Ente Creditore e del PSP è facoltativa.

L'adeguamento è importante poichè nell'ottica del principio di centralità dell’Utente mette a disposizione del medesimo la possibilità di scegliere l'opzione di pagamento più adatta, in base ad un elenco definito dall'EC. L'EC in questo modo, non solo migliora la qualità della relazione con l’Utente, ma semplifica anche i processi interni in quanto i pagamenti seguiranno lo stesso ciclo di quelli attuali.

Serve supporto?

Per gli sviluppatori .

Per altri chiarimenti suggeriamo di rivolgersi all’Account PagoPA di riferimento.

Domande frequenti

Per i PSP

Come sarà informato l’Utente della disponibilità di più opzioni di pagamento?

Il PSP dovrà farsi carico dell'esposizione di questa informazione all’Utente.

Per gli EC

Chi valida le opzioni di pagamento?

La validazione delle opzioni di pagamento è a carico dell’EC.

A quale esigenza rispondiamo?

L'esigenza è quella di estendere le modalità di gestione dei Flussi di Rendicontazione “FdR” introducendo nuovi strumenti per la trasmissione delle informazioni.

Quale soluzione adottiamo?

PagoPA ha messo a disposizione degli EC/PSP delle nuove primitive, che andranno ad affiancare quelle già esistenti, per la gestione dei download/upload dei FdR. Le nuove API funzioneranno in parallelo fino alla dismissione di quelle già esistenti che avverrà nel Q1 2025.

L'introduzione dei nuovi servizi ha l’obiettivo di ottimizzare l’attuale flusso logico, gestendo in maniera ottimale tutte le fasi di gestione dei FdR, anche di dimensioni elevate.

Gli EC ed i PSP potranno adeguare le chiamate alle primitive messe a disposizione dalla piattaforma pagoPA per poter gestire in maniera efficiente i FdR.

Perché è importante adeguarsi

Le implementazioni da parte di EC e PSP sono obbligatorie.

L'utilizzo delle nuove funzionalità consente ad EC e PSP di rendere notevolmente più robusto il processo di gestione dei FdR, in considerazione del fatto che le nuove primitive implementano delle logiche di controllo sulla sintassi del flusso e sulle operazioni di download/upload. Tali controlli si ritengono necessari per evitare dei blocchi nella catena del pagamento e, quindi, limitare gli attuali interventi manuali effettuati per lo sblocco.

Serve supporto?

Per gli sviluppatori .

Per altri chiarimenti suggeriamo di rivolgersi all’Account PagoPA di riferimento.

A quale esigenza rispondiamo?

L’aumento del numero delle transazioni gestite e l’assoggettamento di PagoPA alla sorveglianza di Banca d’Italia ai sensi dell’art. 20 del Provvedimento del 9 novembre 2021 attuativo del citato art. 146 TUB, hanno reso necessaria l’adozione di presidi di mitigazione dei problemi che impattano la Piattaforma e che possono generare disagi e/o disservizi verso Enti Creditori e Utenti.

Quale soluzione adottiamo?

Al fine di assicurare la continuità operativa PagoPA sta ultimando la strutturazione di un processo di Quality Improvement che prevede il monitoraggio periodico delle performance dei PSP sulle aree di maggior impatto attraverso specifiche metriche definite "KPI".

Impatti

L'adeguamento da parte dei PSP è obbligatorio.

L'obiettivo di tale processo è quello di incentivare i player a garantire livelli di performance adeguati al servizio offerto dalla piattaforma pagoPA, sia verso i cittadini, sia verso gli Enti Creditori. L'iniziativa è inserita nell’ambito della revisione delle Linee Guida pagoPA.

Per i PSP:

Errori, ritardi o mancato invio dei Flussi di Rendicontazione

Il PSP può generare FdR errati, mancato invio, o ritardo nella trasmissione degli stessi, spesso anche successivamente alla richiesta esplicita da parte di PagoPA. Tra le casistiche di errore più frequenti riscontriamo:

• produzione di FdR con idFlusso che non corrisponde alla causale del SCT;

• FdR con incongruenze rispetto al totale del SCT (con conseguenti squadrature).

Mancato rispetto delle Specifiche

Il PSP non rispetta le modalità di gestione dei flussi di pagamento descritti nelle SANP.

Serve supporto?

Per gli sviluppatori è possibile aprire una issue su GitHub.

Per altri chiarimenti suggeriamo di rivolgersi all’Account PagoPA di riferimento.

Di seguito alcuni elementi utili per una corretta lettura delle informazioni di sintesi presenti nelle tabelle riportate nell'intestazione di ogni capitolo: