Configurazione nodo dei pagamenti
Il nodo dei pagamenti è un applicativo che funge da middleware per tutti i servizi di pagamento che possono essere richiesti dai componenti software della galassia VBG. Il suo compito è quello di esporre ai componenti di VBG una interfaccia unificata e standardizzata per l'accesso ai servizi di pagamento su piattaforma PagoPA. In questa documentazione verrà trattata la configurazione che permette di interfacciare VBG con il nodo dei pagamenti.
Prerequisiti
- backend ( VBG ) alla versione 2.77 o successiva
- applicativo nodo-pagamenti
- comunicazione tra l'applicativo nodo-pagamenti e vbg (solitamente tramite http sulla porta 8080 )
- comunicazione tra l'applicativo nodo-pagamenti e ibcsecurity (solitamente tramite http sulla porta 8080 )
Configurazioni preliminari
E' necessario verificare che l'applicativo nodo-pagamenti sia installato e che i seguenti parametri siano impostati nei relativi file di configurazione
deploy.properties
In questo file ci sono alcune configurazioni utili per il corretto avvio del nodo-pagamenti. Ogni modifica a questo file necessita di un riavvio dell'applicativo
idcomunealias=<indicare l`identificativo dell`ente all`interno di ibcsecurity>
installationId=TZT
ws.oggetti.mtom=true
ws.eventi.mtom=true
#BACKEND
ws.backend.url=<indicare la url per raggiungere il backend>
#attivazione scheduler di quartz, i trigger di attivazione dei job devono essere configurati nella tabella PAY_CONNECTOR_WS_ENDPOINT
scheduler.enabled=true
un esempio di configurazione funzionante è il seguente
db.properties
In questo file ci sono le configurazione che permettono all'applicativo nodo-pagamenti di accedere al proprio db contentente le impostazioni dello specifico connettore
connection.url=<stringa di connessione al database>
connection.username=<utente del database>
connection.password=<password dell`utente del database>
connection.driver.classname=<driver utilizzati per connettersi al database>
hibernate.dialect=<dialect di hibernate da utilizzare per le interrogazioni al database>
un esempio di configurazione funzionante è il seguente
log4j.properties
In questo file ci sono le impostazioni che permettono di monitorare le attività svolte dal nodo-pagamenti. Tali parametri vanno modificati con cautela in quanto una eccessiva attività di logging potrebbe portare al blocco dell`applicativo stesso
log4j.logger.it.gruppoinit.pal.gp=DEBUG
un esempio di configurazione funzionante è il seguente
Configurazioni dello specifico connettore
Per potersi interfacciare con i differenti sistemi di pagamento utilizati dai vari enti il nodo dei pagamenti utilizza degli specifici componenti software chiamati connettori. I connettori sono già presenti nell'installazione del nodo pagamenti ma per poterli utilizzare occorre configurarli in un gruppo di specifiche tabelle del nodo pagamenti.
Allo stato attuale non è presente una UI per poter configurare tali contenuti per cui si andrà ad operare direttamente nelle tabelle interessate che sono le seguenti:
- AMMINISTRAZIONI
- PAY_CONNECTOR_WS_ENDPOINT
- PAY_CONNECTOR_CONFIG
- PAY_CONNECTOR_CONFIG_PARAMS
- PAY_CONNECTOR_CONFIG_VALUES
- PAY_REGISTRAZIONI_CAUSALI
- PAY_PROFILI_ENTI_CREDITORI
Di seguito verranno illustrate le informazioni da riportare nelle varie tabelle
amministrazioni
Tabella che configura i dati anagrafici salienti dell'ente creditore per cui si attiva il connettore.
Colonna | Descrizione |
---|---|
IDCOMUNE | Identificativo dell'installazione |
CODICEAMMINISTRAZIONE | Numero progressivo |
AMMINISTRAZIONE | Nome dell'amministrazione |
INDIRIZZO | Indirizzo |
CITTA | Località |
CAP | CAP |
PROVINCIA | Provincia |
TELEFONO1 | Numero di telefono |
pay_connector_config
Tabella che censisce i connettori installati nel nodo e ne definisce i servizi attivi
Colonna | Descrizione |
---|---|
CODICE | Identificativo del connettore |
DESCRIZIONE | Descrizione del connettore |
PAY_CONNECTOR_JAVA_CLASS | Classe java che identifica il connettore |
WS_URL | Deprecata vedi fk_ws_caricamento |
WS_USR | Deprecata vedi fk_ws_caricamento |
WS_PWD | Deprecata vedi fk_ws_caricamento |
WS_TIMEOUT | Deprecata vedi fk_ws_caricamento |
URL_PORTALE_PAGAMENTI | Url per accedere al portale dei pagamenti |
PWD_PORTALE_PAGAMENTI | Password applicativa per accedere al portale dei pagamenti |
IN_WS_TIMEOUT | Deprecata |
IN_WS_PWD | Deprecata |
IN_WS_USR | Deprecata |
FK_WS_CARICAMENTO | FK ai parametri di configurazione del servizio per il caricamento delle posizioni debitorie |
FK_WS_ANNULLAMENTO | FK ai parametri di configurazione del servizio di annullamento delle posizioni debitorie |
FK_WS_VERIFICA | FK ai parametri di configurazione del servizio di verifica dello stato di una posizione debitoria |
FK_WS_ATTIVA_SESSIONE | FK ai parametri di configurazione del servizio di attivazione di una sessione di pagamento |
FK_WS_AVVISO | FK ai parametri di configurazione del servizio di generazione/invio dell'avviso di pagamento |
FK_WS_NOTIFICA | FK ai parametri di configurazione del servizio esposto dal nodo di ricezione della notifica dell'avvenuto pagamento |
FK_WS_SECURITY | FK ai parametri di configurazione del servizio di generazione del token di sicurezza |
APPLICATION_CODE | Codice che identifica lo specifico connettore presso il sistema di pagamenti esterno con cui si interfaccia |
FK_WS_FATTURA | FK ai parametri di configurazione del servizio di generazione della fattura |
FK_WS_RICEVUTA | FK ai parametri di configurazione del servizio per il recupero della ricevuta telematica di pagamento |
FK_WS_IUV | FK ai parametri di configurazione del servizio per la generazione dello iuv |
pay_connector_ws_endpoint
Tabella di configurazione dei servizi (SOAP, json, scambio files) utilizzati dai connettori per dialogare con i sistemi di pagamento esterni
Colonna | Descrizione |
---|---|
CODICE_CONNETTORE | Codice del connettore nel nodo pagamenti, si può impostare qualunque codice. Il codice deve essere valorizzato in FK nel campo PAY_PROFILI_ENTI_CREDITORI.CODICE_CONNETTORE |
ID | Numero progressivo |
ENDPOINT_URL | URL per l'invocazione del servizio |
UTENTE | Utente per l'autenticazione del servizio |
PASSWORD | Password per l'autenticazione del servizio |
TIMEOUT | Serve a configurare il timeout di attesa nell'invocazione del servizio configurato nel campo ENDPOINT_URL |
DESCRIZIONE | Descrizione aggiuntiva che spiega a cosa si riferisce questo endpoint |
QUARTZ_SCHEDULE | Espressione chron di schedulazione. Se impostato il servizio viene attivato anche come procedura schedulata |
FLAG_SOLO_SCHEDULATO | Indica se la chiamata all'endpoint avviene in maniera solo schedulata (1) oppure anche sincrona (0) |
MAX_CHIAMATE | Numero massimo di tentativi di chiamata prima di restituire l'errore di irraggiungibilità del servizio, non impostato significa nessun limite |
FLAG_SPEGNI_SCHEDULER | utile per disattivare gli scheduler mantenendo memorizzata l'espressione che lo configura in quartz_schedule |
pay_connector_config_params
Tabella che definisce dei parametri di configurazione che possono essere validi per dei connettori specifici oppure per tutti i connettori
Colonna | Descrizione |
---|---|
CONFIG_PARAM | Nome del parametro |
DESCRIZIONE | Descrizione del parametro |
CODICE_CONNETTORE | Riferimento al connettore per cui e' prevista la valorizzazione del parametro, se lasciato vuoto il parametro esiste per tutti i connettori |
pay_connector_config_values
Tabella che configura i valori assegnati ai parametri di configurazione definiti nella tabella PAY_CONNECTOR_CONFIG_PARAMS.
Colonna | Descrizione |
---|---|
IDCOMUNE | Identificativo dell'installazione |
ID | Numero progressivo |
CONFIG_PARAM | Nome del parametro |
CODICE_CONNETTORE | Identificativo del connettore per cui si assegna il valore al parametro. Se lasciato vuoto assegna un valore di default al parametro che è valido per tutti i connettori |
VALORE | Valore che assume per lo specifico connettore |
pay_profili_enti_creditori
Tabella che definisce i profili che gli enti possono utilizzare per caricare debiti nel nodo pagamenti. Ogni profilo ente creditore associa tramite le sue foreign key una amministrazione (CODICEAMMINISTRAZIONE) ad un connettore (CODICE_CONNETTORE). Alcune specifiche informazioni di configurazione sono associate al profilo ente creditore Tutte le chiamate che i client effuano al nodo devono contenere un codice identificativo (CF_CODICE_PROFILO) del profilo ente per indicare al nodo quale configurazione usare per gestire il servizio richiesto.
Colonna | Descrizione |
---|---|
IDCOMUNE | Identificativo dell'ente |
ID | Numero progressivo |
CODICECOMUNE | Codice Belfiore che identifica il comune |
CODICEAMMINISTRAZIONE | Fk verso la tabella AMMINISTRAZIONI che identifica i dati dell'ente |
SOFTWARE | Identificativo del modulo dell'ente |
CBILL | |
CC_POSTALE | Conto Corrente Postale |
CF_CODICE_PROFILO | E' il codice che il backoffice trasmette per identificare il sistema dei pagamenti da utilizzare |
CODICE_CONNETTORE | Identificativo del connettore |
FK_CUSALE_REG_DEFAULT | FK verso pay_registrazioni_causali |
ID_APP_PSP | |
CF_CODICE_PROFILO_PSP | ID dell'ente in NEXI |
URL_ESITO_PAGAMENTO | Url che gestisce il reindirizzamento dell'utente che vuole tornare all'applicazione client dopo aver effettuato con successo un pagamento sul portale on-line |
URL_ANNULLAMENTO_PAGAMENTO | Url che gestisce il ritorno all'app chiamante dopo l'annullamento del pagamento online |
CODICE_SEGREGAZIONE | Identificativo numerico del punto di emissione degli iuv di un ente creditore |
APPLICATION_CODE | Identificativo numerico dell'archivo di pagamenti associato a questo servizio dell'ente creditore in pagopa, utilizzato per la generazione del codice avviso con aux digit = 0 |
CF_ENTE_QRCODE_PAGOPA | Il codice fiscale/partitaiva dell'ente che serve per generare la sezione Identificativo Ente/codice fiscale dell'Ente Creditore dell'algoritmo di generazione qrcode |
pay_registrazioni_causali
Tabella che definisce le causali per cui è possibile caricare i debiti nel sistema di pagamento esterno. Ad ogni debito che viene caricato tramite il nodo pagamenti sarà associata una causale di questa tabella. Se il client non specifica la causale di registrazione del debito il sistema gliene assegnerà una di default che è definita per ciascun ente in PAY_PROFILI_ENTI_CREDITORI.FK_CUSALE_REG_DEFAULT.
Colonna | Descrizione |
---|---|
ID | Numero progressivo |
IDCOMUNE | Identificativo dell'ente |
SOFTWARE | Identificativo del modulo dell'ente |
DESCRIZIONE | Descrizione della causale |
ORDINE | |
FLAG_RIDUZIONE | |
FLAG_NOINCASSI | |
CODICE_VERSAMENTO | Codice che identifica l'onere nel sistema dei pagamenti dell'ente |
Configurazione del backend
Ora che il nodo-pagamenti e il connettore sono configurati, bisogna indicare al backend che è attivo un sistema per poter pagare in maniera integrata. Per fare ciò bisogna recarsi nella voce di menù del backend Configurazione -> Tutti i backoffice -> Configurazione regole
attivare la verticalizzazione NODO_PAGAMENTI
e configurare i seguenti parametri personalizzandoli a seconda dell'ente in modo che
Parametro | Valore |
---|---|
AR_COD_FISC_ENTE_CREDITORE | |
URL_WS | http://devel9:8085/nodo-pagamenti/services/pagamentiSOAP?wsdl |
Configurazione soggetto debitore
È possibile aggiungere un nuovo parametro sulla verticalizzazione NODO_PAGAMENTI per determinare se la posizione debitoria deve essere aperta verso l'azienda (se presente, altrimenti il richiedente ) o direttamente verso il richiedente (comportamento di DEFAULT). Il parametro è configurabile per comune e software.
Se configurato accetta come parametri:
- AZIENDA: inserirà il titolare legale della società;
- RICHIEDENTE: inserirà il richiedente della pratica. Se non configurato, di default la posizione sarà aperta verso il richiedente.