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:
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.
Analizziamo le sottosezioni in cui è strutturata l'applicazione, ovvero:
- Informazioni di riepilogo
- Codifica avvisi
- API integrazione
- Autorizzazioni API
- Autorizzazioni Backoffice
In questa sottosezione sono contenute le informazioni che definiscono un'applicazione in tutti i suoi aspetti di interazione con il sistema dei pagamenti.
Dettagli della sezione Informazioni di riepilogo di una nuova ApplicazioneCampo | 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 |
In questa sottosezione sono contenute le informazioni che definiscono un'applicazione in tutti i suoi aspetti di interazione con il sistema dei pagamenti.
Dettagli della sezione Codifica avvisi di una nuova ApplicazioneCampo | 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 |
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.
Dettagli della sezione API Integrazione di una ApplicazioneCampo | 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 |
In questa sezione è possibile specificare le autorizzazioni dell'Applicazione sulle API di integrazione:
Dettagli della sezione API Integrazione di una ApplicazioneCampo | 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 |