Esecuzione

Lo scenario fin qui descritto è stato arricchito di una collection Postman che consente di eseguire autonomamente i passi dello scenario utilizzando come riferimento l”Ambiente Demo di GovPay.

../../_images/postman_dovuto1_menu.png

Fig. 96 Elenco operazioni presenti nella collection postman

Le operazioni elencate (Fig. 96) possono essere eseguite in sequenza al fine di riprodurre i passi già descritti nella sezione di Realizzazione.

Di seguito la sequenza di esecuzione delle operazioni:

  • PUT Pendenza: l’operazione prevede l’invio di un messaggio contenente una pendenza con due voci di pagamento (quindi senza la generazione dell’avviso). Per quanto riguarda i parametri:

    • Il primo parametro è l’identificativo dell’applicazione gestionale che inserisce la pendenza. In questo caso si utilizza l’applicazione A2A-DEMO, censita nell’ambiente demo.

    • Il secondo parametro è l’identificativo della pendenza, fornito dall’applicazione. In questo caso l’identificativo viene automaticamente generato tramite uno script che utilizza numeri casuali.

    L’operazione si ritiene conclusa con successo se restituisce il codice HTTP 201 (Fig. 97).

../../_images/postman_dovuto1_put_response.png

Fig. 97 Risposta ottenuta dalla PUT Pendenza

  • GET Posizione Debitoria: l’operazione, eseguita tipicamente dall’applicazione corrispondente al portale di pagamento, prevede la ricerca delle pendenze filtrando rispetto all’identificativo dell’utente debitore. Tra le pendenze restituite ci sarà quella caricata al passo precedente (Fig. 98).

../../_images/postman_dovuto1_getposizione_response.png

Fig. 98 Risposta ottenuta dalla GET Posizione Debitoria

  • POST Pagamento: l’operazione, eseguita in seguito alla conferma dell’utente per effettuare il pagamento, prevede che il body contenga i seguenti elementi:

    • idA2A: identificativo del gestionale che ha caricato la pendenza

    • idPendenza: identificativo della pendenza che si vuol pagare

    L’operazione si ritiene conclusa correttamente se viene restituito il codice HTTP 201 (Fig. 99). La risposta ottenuta contiene i seguenti dati:

    • id: identificativo del pagamento creato

    • location: uri per la visualizzazione del dettaglio del pagamento

    • redirect: url per il reindirizzamento del browser utente verso il prossimo passo del flusso di pagamento

    • idSession: identificativo della sessione assegnato da pagoPA

../../_images/postman_dovuto1_post_pagamento.png

Fig. 99 Operazione POST Pagamento

  • GET Pagamento: questa operazione viene eseguita dal portale di pagamento, al termine dell’operazione di versamento da parte dell’utente, per verificare l’esito dell’operazione e consentire lo scaricamento della ricevuta telematica (Fig. 100). L’operazione utilizzata per il recupero del dettaglio del pagamento è quella che prevede la ricerca basata sull’identificativo di sessione assegnato da pagoPA. Tale valore viene estratto dalla risposta alla POST del passo precedente ed inserito nella richiesta corrente.

../../_images/postman_dovuto1_get_pagamento.png

Fig. 100 Operazione GET Pagamento