Tabella dei contenuti
Giornale degli eventi
La funzione del Giornale degli Eventi è quella di consentire la tracciabilità di ogni operazione di pagamento attivata sulla piattaforma pagoPA.
L'operazione di pagamento si sviluppa mediante la cooperazione applicativa tra sistemi diversi degli EC, della piattaforma pagoPA e dei PSP, per ricostruire il processo complessivo è necessario che ognuno dei sistemi interessati dal pagamento telematico si doti di funzioni specifiche per registrare i passaggi principali del trattamento dell'operazione di pagamento.
Le tracce registrate dai singoli sistemi, in caso di richiesta di verifica, devono essere estratte e confrontate con le analoghe informazioni prodotte da tutti i sistemi di collaborazione coinvolti nelle operazioni interessate.
Ai fini del confronto sono state individuate due aree di identificazione dell'operazione di pagamento: l'identificazione del pagamento telematico, basata sui campi chiave che rendono univoco il riferimento al pagamento, e l'identificazione dello scambio dei messaggi di interfaccia basata sui parametri dei messaggi stessi che collegano in modo inequivocabile tali messaggi con il pagamento specifico.
Nella tabella seguente sono indicate le informazioni e le specifiche di rappresentazione dei dati che tutti i soggetti sono tenuti a fornire per le verifiche di cui sopra.
| Dato | Contenuto |
|---|---|
| dataOraEvento | Indica la data e l’ora dell’evento secondo il formato ISO 8601, alla risoluzione del millisecondo e sempre riferito al GMT. Formato [YYYY]-[MM]-[DD]T[hh]:[mm]:[ss.sss] |
| identificativoDominio | Campo alfanumerico contenente il codice fiscale dell’EC |
| identificativoUnivocoVersamento | Riferimento univoco assegnato al pagamento dall’EC. |
| codiceContestoPagamento | Codice univoco necessario a definire il contesto nel quale viene effettuato il versamento. |
| numeroAvviso | Numero dell'avviso emesso dall'EC. |
| identificativoPrestatoreServiziPagamento | Identificativo del PSP univoco nel dominio scelto dall’utilizzatore finale e/o dall’EC. |
| tipoVersamento | Forma tecnica di pagamento presente nel messaggio che ha originato l’evento. |
| componente | Sistema o sottosistema che ha generato l’evento (es. FESP, WFESP). |
| categoriaEvento | INTERNO/INTERFACCIA, indica se l'evento tracciato è relativo un'operazione di interfaccia con altri sistemi oppure se rappresenta un'operazione interna (es. cambio di stato) al proprio sistema. |
| tipoEvento | Identificativo del tipo di evento. Nel caso di interazioni SOAP è il nome del metodo SOAP. |
| sottoTipoEvento | Nel caso di interazioni SOAP sincrone assume i valori REQ/RESP per indicare rispettivamente SOAP Request e SOAP Response. |
| identificativoFruitore | Nel caso di eventi di tipo INTERFACCIA si deve utilizzare l’identificativo del sistema del soggetto richiedente nell’ambito del dominio (Es. NodoDeiPagamentiSPC nel caso della paGetPayment). Nel caso di eventi di tipo INTERNO, si può utilizzare un nome di componente o sotto componente che genera l’evento. |
| identificativoErogatore | Nel caso di eventi di tipo INTERFACCIA si deve utilizzare l’identificativo del sistema del soggetto rispondente nell’ambito del dominio (Es. identificativoStazioneIntermediarioPA nel caso della paGetPayment). Nel caso di eventi di tipo INTERNO, si può utilizzare un nome di componente o sotto componente che processa l’evento. Per quest’ultima tipologia il valore può coincidere con l’identificativoFruitore, qualora non vi sia un componente che risponde all’ evento stesso. |
| identificativoStazioneIntermediarioPA | Identificativo della Stazione dell’intermediario dell’EC nel sistema della piattaforma pagoPA, da cui sono transitati payment e receipt. |
| canalePagamento | Identificativo del Canale del PSP nel sistema della piattaforma pagoPA da cui sono transitati payment e receipt. |
| parametriSpecificiInterfaccia | Parametri specifici utilizzati nell’interfaccia dal PSP o dall’EC. |
| esito | Campo opzionale in base allo stato dell’operazione al momento della registrazione dell’evento. Obbligatorio nel caso di richieste SOAP. |
Dicci cosa ne pensi
Per chiarimenti sulle specifiche d’implementazione, come SACI e SANP, puoi aprire una segnalazione su GitHub