DevPortalPagoPA



Tabella dei contenuti

Stand In

Processo di pagamento in Stand In

Lo Stand In è una funzionalità che consente di sopperire alla situazione in cui i sistemi degli EC sono temporaneamente indisponibili, affinché gli utenti possano effettuare i pagamenti degli avvisi pagoPA anche in tale situazione, a condizione che l’avviso di pagamento sia stato correttamente caricato nell’Archivio Centralizzato Avvisi (ACA).
An image

Funzionalità di Stand In per i pagamenti attivati presso PSP

La funzionalità di Stand In può essere attivata per il caso pagamento-spontaneo-presso-psp, in particolare richiamando le primitive paVerifyPaymentNotice e paGetPaymentV1/V2.
In caso l'EC non risponda all’invocazione delle citate primitive entro il tempo massimo previsto, così come indicato in Livelli di Servizio PSP, la piattaforma attiva automaticamente la funzionalità di Stand In, successivamente il NodoSPC verifica la presenza dell'avviso di pagamento in ACA.
Se l'avviso di pagamento è stato correttamente caricato nell'ACA, la piattaforma pagoPA restituisce all’utente l'importo dell'avviso che è stato in precedenza comunicato dall’EC ad ACA e consente all’utente di procedere al pagamento.
In questo caso il pagamento viene gestito in modalità Stand In e al termine del pagamento la piattaforma pagoPA effettua l'invio della ricevuta telematica tramite la paSendRTV1/V2 utilizzando le modalità standard dettagliate in Fase invio ricevuta.
Tuttavia se l'avviso di pagamento non è presente in ACA l’utente non è in grado di procedere al pagamento, poiché pagoPA non dispone dei dati necessari.

Condizioni di esclusione dalla funzionalità Stand In

E’ possibile definire delle esclusioni dalla funzionalità di Stand in tramite il backoffice pagoPA per intere porzioni di APA o puntualmente per ogni singola posizione debitoria conferita all’ACA, impostando a false il campo payStandIn.
Tali esclusioni sono motivate dalla variabilità dell’importo della posizione debitoria fino al momento del pagamento.
Le motivazioni a cui devono essere ricondotte tutte le casistiche di esclusione rientrano nel seguente elenco tassativo:
  • maggiorazioni per more e interessi dipendenti dalla data di pagamento;
  • maggiorazioni per spese di notifica, variabili in base alla data di notifica.

Tracciamento dei pagamenti in Stand In

Per identificare e distinguere i pagamenti gestiti tramite il processo di Stand In da quelli gestiti mediante il “processo standard”, gli EC ed i PSP, che vogliono ricevere tale informazione, devono adeguare il proprio software per la gestione del nuovo flag.
Il flag standin viene valorizzato nelle primitive:
Il suddetto flag può assumere uno dei seguenti due valori:
  • standin = true: questo valore è assegnato ai pagamenti che sono avvenuti tramite il processo di Stand In;
  • standin = false: questo valore è assegnato ai pagamenti che sono avvenuti con il processo standard.
L'utilizzo di questo flag consente di distinguere chiaramente i due processi di pagamento.

Rendicontazione dei pagamenti gestiti in Stand In

I pagamenti che vengono elaborati con successo mediante il processo di Stand In sono successivamente riversati sull'IBAN dell'EC precedentemente configurato, inoltre, questi pagamenti sono riportati nel flusso di rendicontazione con il codice esito 4.

Impatti per gli EC derivanti dall'attivazione dello Stand In

Aggiornamento della posizione debitoria su ACA

È necessario che gli EC mantengano aggiornata la posizione debitoria su ACA per garantire un'adeguata gestione dell'attualizzazione dell'importo e dell'annullamento delle posizioni debitorie; tutte le indicazioni per poter adempiere a tale compito sono disponibili inArchivio centralizzato avvisi.

Gestione degli avvisi di pagamento pagati in Stand In

Gli EC devono essere in grado di gestire importi potenzialmente non attualizzati relativi agli avvisi di pagamento pagati in modalità Stand In, perché potrebbe essere necessario gestire pagamenti il cui l'importo non è stato precedentemente aggiornato su ACA.

Gestione degli avvisi di pagamento pagati in Stand In nel caso di conferimento all’ACA tramite la paCreatePosition

Il meccanismo Stand In, attivato quando la stazione dell'EC è temporaneamente indisponibile, recupera le informazioni necessarie per il pagamento in ACA.
L’integrazione con ACA, solo ed esclusivamente nel caso di conferimento tramite la paCreatePosition, prevede la comunicazione delle seguenti informazioni:
  • fiscalCodePA: codice fiscale dell’EC che ha creato la posizione debitoria;
  • entityUniqueIdentifierType: tipologia del debitore (F=persona fisica, G=persona giuridica);
  • entityUniqueIdentifierValue: codice fiscale del debitore;
  • fullName: nome e cognome del debitore;
  • IUV: identificativo univoco versamento;
  • amount: importo (non è possibile censire una posizione con un importo uguale a zero);
  • description: causale;
  • dueDate: data di scadenza della posizione debitoria;
  • Iban: IBAN di riversamento (opzionale);
  • postalIban: IBAN postale di riversamento (opzionale);
  • switchToExpired: flag per indicare se la dueDate è vincolante o meno;
  • payStandIn: flag per indicare se la posizione è pagabile o meno in Stand In.
Nel caso non siano stati inviati i campi Iban e postalIban, il sistema recupera autonomamente l’IBAN che verrà utilizzato in fase di accredito, viene utilizzato quello configurato dall’EC tramite backoffice pagoPa o, se non presente tale configurazione, viene utilizzato quello con la modifica più recente.
La struttura dei dati conferma che vi è un solo importo totale comunicato dall’EC, che rappresenta la somma degli importi presenti nei vari transfer della posizione debitoria originaria, questo implica che la funzionalità di Stand In, solo ed esclusivamente nel caso di conferimento all’ACA tramite la paCreatePosition, non può gestire la suddivisione degli importi di una posizione debitoria di tipo multi-beneficiario, in quanto non vengono fornite le informazioni necessarie per l’esecuzione di tale struttura di pagamento.

Definizione di un IBAN di default per pagamenti in Stand In

Gli EC possono definire un IBAN di default tramite backoffice pagoPA per la gestione di pagamenti in modalità Stand In, garantendo un corretto instradamento dei riversamenti.
Se l’EC non dichiara un IBAN di default viene utilizzato l’IBAN con la data di modifica più recente.
Tali informazioni relative all’IBAN di default vengono utilizzate solo nel caso non siano stati inviati entrambi i campi Iban e postalIban tramite la paCreatePosition.
In caso di conferimento all’ACA tramite API di creazione e aggiornamento del servizio di Gestione Posizione Debitorie (GPD) il campo iban di ogni transfer è obbligatorio.
Per accedere alla guida dettagliata sull'inserimento dell'IBAN da utilizzare durante le operazioni Stand In, ti invitiamo a fare clic sul seguente link.

Attivazione dello Stand In

Le logiche per attivare la funzionalità si fondano sulle primitive paVerifyPaymentNotice e paGetPaymentV1/V2, di queste primitive si monitorano i seguenti faultCode:
  • PPT_STAZIONE_INT_PA_IRRAGGIUNGIBILE
  • PPT_STAZIONE_INT_PA_TIMEOUT
  • PPT_STAZIONE_INT_PA_SERVIZIO_NON_ATTIVO
Le stazioni dell’EC sono costantemente monitorate al fine di valutare la loro disponibilità, viene attivata la modalità Stand In qualora in un intervallo di 30 minuti si verifichino tutte le seguenti condizioni
durante le ore notturne, comprese tra le 22:00 e le 6:00
  • le stazioni presentino una disponibilità inferiore al 50%;
  • il traffico totale dei pagamenti gestiti dalla stazione superi il 10% del traffico totale del NodoSPC;
durante le ore diurne, comprese tra le 6:00 e le 22:00
  • le stazioni presentino una disponibilità inferiore al 50%;
  • il traffico totale dei pagamenti gestiti dalla stazione superi il 5% del traffico totale del NodoSPC.

Disattivazione dello Stand In

Le logiche per disattivare la funzionalità si fondano sulla primitiva paVerifyPaymentNotice, in particolare, nel periodo in cui la stazione si trova in Stand In, vengono effettuate chiamate tecniche per verificare il ripristino delle operatività della stazione.
Per le chiamate tecniche alla primitiva paVerifyPaymentNotice si utilizzerà uno IUV fittizio (000000000000000000) in modo da ottenere PAA_PAGAMENTO_SCONOSCIUTO, in caso di una percentuale minima del 50% di risposte positive la condizione di Stand In della stazione viene disabilitata, ripristinando la normale configurazione operativa della stazione dell'EC.

Pricing per posizione debitoria gestita

Nel caso in cui i dati NON siano dall’EC comunicati ad ACA lo Stand In non potrà essere attivato, all'EC viene, pertanto, addebitato un importo fisso di 5 centesimi per ciascun pagamento, funzionale alla gestione del processo fuori da Stand In.
Ai fini della fatturazione dello Stand In vale l’anagrafica delle EC fornita in sede di adesione alla piattaforma pagoPA ovvero quella risultante alla data del 1 gennaio 2025 in caso di aggiornamento della stessa anagrafica da parte dell’Ente antecedentemente a tale data.
Serve aiuto?

Apri un ticket utilizzando l’apposita funzione all’interno della tua Area Riservata

Dicci cosa ne pensi

Per chiarimenti sulle specifiche d’implementazione, come SACI e SANP, puoi aprire una segnalazione su GitHub