Linee guida

Linee guida di integrazione

1. Gestione degli errori

Gestione degli errori

Tutte le chiamate ai servizi di integrazione hanno una comune struttura di base nei messaggi di risposta che contiene questi elementi:

• Codice Operazione: identificativo dell'operazione su GovPay. Utile per un'eventuale operazione diagnostica
• Mittente: indica il componente dell'architettura che ha emesso l'errore.
• Codice Esito: codifica dell'esito dell'operazione
• Descrizione Esito: testo descrittivo dell'esito dell'operazione
• Dettaglio Esito: eventuale ulteriore dettaglio di chiarimento dell'esito.

Se il Codice Esito e' diverso da OK, la richiesta non si e' completata correttamente. In questi casi, se il mittente non e' GovPay, i campi codice, descrizione e dettaglio esito sono valorizzati con i corrispondenti campi del FaultBean ricevuto dal Nodo dei Pagamenti. Per dettagli in merito si rimanda alla specifica SANP

Quasi tutti gli errori richiedono un'analisi a cura dell'EC per individuare se si e' in presenza di un errore di integrazione, di errata configurazione del proprio ambiente o di un'errore del Nodo dei Pagamenti. In questi casi al cittadino non si puo' far altro che presentare una generica pagina di errore interno.

Ci sono alcuni errori che pero' non sono di competenza dell'EC e gli applicativi devono gestirli. Vediamoli in dettaglio.

Sessione WISP scaduta

Mittente: NodoDeiPagamentiSPC Codice Esito: PPT_WISP_SESSIONE_SCADUTA

La sessione WISP di scelta PSP e' scaduta. Il Portale di Pagamento dell'EC deve gestire l'errore invitando il cittadino ad eseguire una nuova scelta sul WISP.

Errore del Canale di Pagamento

Mittente: PSP Codice Esito: PPT_CANALE_ERRORE

L'errore indica un rifiuto della RPT da parte del PSP. Informazioni maggiori sono presenti nel dettaglio, ad esempio:

FaultCode PSP: CANALE_SEMANTICA
FaultString PSP: Risposta dal Canale: Errore semantico.
Description PSP: Il soggetto pagatore non ha un conto IdP