Skip to content

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

Esempio di deploy.properties

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

Esempio idi db.properties

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

Esempio di log4j.properties

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.

Amministrazioni coinvolte

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
EMAIL Email

pay_connector_config

Tabella che censisce i connettori installati nel nodo e ne definisce i servizi attivi

pay connector config

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

ws endpoint

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

config params

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.

config values

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.

profili enti creditori

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.

Registrazioni causali

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

backend menu

attivare la verticalizzazione NODO_PAGAMENTI

Verticalizzazione

e configurare i seguenti parametri personalizzandoli a seconda dell'ente in modo che corrisponda al valore configurato nel campo CF_CODICE_PROFILO della tabella PAY_PROFILI_ENTI_CREDITORI. Mentre L'URL_WS deve riportare l'URL su cui è esposto il nodo pagamenti.

Parametro

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.

soggetto pendenza

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.