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.
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).
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).
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
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.