Applicazioni

Le Applicazioni in GovPay rappresentano i portali di pagamento e i sistemi applicativi gestionali dei debiti che si interfacciano tramite le Web API di integrazione. Accedendo alla sezione Configurazioni > Applicazioni, viene visualizzato l’elenco delle applicazioni già censite. Sul lato sinistro della pagina è presente un form che consente di filtrare i dati visualizzati nella pagina, come di seguito mostrato:

Fig. 47 Vista generale delle applicazioni censite e criterio di filtro

Nuova Applicazione

Per aggiungere una nuova applicazione, premere il pulsante posizionato, come sempre, in basso a destra. Analizzeremo questa funzionalità che è del tutto analoga, dal punto di vista delle informazioni richieste, a quella della modifica di un’applicazione già censita nel sistema.

Fig. 48 Vista generale dei campi di una nuova applicazione

Analizziamo le sottosezioni in cui è strutturata l’applicazione, ovvero:

• Informazioni di riepilogo

• Codifica avvisi

• API integrazione

• Autorizzazioni API

• Autorizzazioni Backoffice

Informazioni di riepilogo

In questa sottosezione sono contenute le informazioni che definiscono un’applicazione in tutti i suoi aspetti di interazione con il sistema dei pagamenti.

Fig. 49 Informazioni di riepilogo di un’applicazione

Tabella 38 Dettagli della sezione Informazioni di riepilogo di una nuova Applicazione

Campo	Significato	Note
Id A2A	identificativo dell’applicazione	Obbligatorio
Principal	Identificativo del principal autenticato nelle chiamate alle Web API di integrazione	Obbligatorio
Password	Password necessaria per l’autenticazione
Abilitato	se disabilitato, tutte le nuove richieste all’applicazione saranno negate

Il campo Principal deve essere valorizzato in base al tipo di autenticazione che si intende utilizzare:

Tipo autenticazione	Valore da inserire
HTTP Basic	Username dell’autenticazione Basic
SSL	Subject del certificato X509
SSL Header	Subject del certificato X509 contenuto nell’header
Header	Principal contenuto nell’header
Api Key	APP-ID presentato dal client tramite header X-APP-ID

Il campo Password deve essere valorizzato in base al tipo di autenticazione che si intende utilizzare:

Tipo autenticazione	Valore da inserire
HTTP Basic	Password dell’autenticazione Basic
SSL	Non necessario
SSL Header	Non necessario
Header	Non necessario
Api Key	API-Key presentato dal client tramite header X-API-KEY

Codifica avvisi

In questa sottosezione sono contenute le informazioni che definiscono un’applicazione in tutti i suoi aspetti di interazione con il sistema dei pagamenti.

Fig. 50 Sezione Codifica Avvisi di un’applicazione

Tabella 39 Dettagli della sezione Codifica avvisi di una nuova Applicazione

Campo	Significato	Note
Codifica IUV	Numero identificativo dell’applicazione nel prefisso IUV, se configurato
RegEx IUV	Espressione regolare che consente di effettuare la validazione dei codici IUV inviati dall’applicazione	es. 99[0-9]*
Generazione IUV interna	Se il flag è attivo l’applicazione genera autonomamente i codici IUV relativi alle proprie pendenze, altrimenti detti codici saranno generati da GovPay

API Integrazione

La piattaforma GovPay utilizza le API di Notifica e Verifica esposte dagli applicativi integrati per completare gli scenari d’uso descritti nelle sezioni di integrazione. In questa sezione si definiscono i dettagli del connettore per l’invocazione delle API.

Fig. 51 Connettore alle API di Integrazione

Tabella 40 Dettagli della sezione API Integrazione di una Applicazione

Campo	Significato
API Integrazione	URL di invocazione del servizio esposto dall’applicazione
Versione API	Versione delle API da invocare
Tipo Autenticazione	Modalità di autenticazione di GovPay verso le API

Autorizzazioni

In questa sezione è possibile specificare le autorizzazioni dell’Applicazione sulle API di integrazione:

Fig. 52 Sezione Autorizzazioni di un’applicazione

Tabella 41 Dettagli della sezione API Integrazione di una Applicazione

Campo	Significato
Tipi pendenza	Lista delle tipologie di pendenza su cui l’applicazione può operare
Ruoli	Ruoli autorizzativi sulle API di Backoffice
API Pagamenti	Abilita/disabilita l’utilizzo delle Api di pagamento
API Pendenze	Abilita/disabilita l’utilizzo delle Api di pendenze
API Ragioneria	Abilita/disabilita l’utilizzo delle Api di ragioneria
Enti creditori	Lista degli Enti ed unità operative su cui l’applicazione può operare