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:
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.
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.
Informazioni di riepilogo di un’applicazione
| Campo | Significato | Note |
|---|---|---|
| Id A2A | identificativo dell’applicazione | Obbligatorio |
| Principal | Identificativo del principal autenticato nelle chiamate alle Web API di integrazione | |
| Abilitato | se disabilitato, tutte le nuove richieste all’applicazione saranno negate |
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.
Sezione Codifica Avvisi di un’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.
Connettore alle API di Integrazione
| 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:
Sezione Autorizzazioni di un’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 |