LogoLogo
SANPSACITutto il resto
SANP 3.7.0
SANP 3.7.0
  • ⬅️Torna a pagoPA.gov.it
  • Specifiche attuative del nodo dei pagamenti SPC
    • Premessa
    • Changelog
    • Glossario
    • Roadmap
    • Documentazione
    • Funzionamento generale
      • Ruoli
      • Ciclo di vita di un pagamento
      • Processi di pagamento
      • Rendicontazione e Cashflow
      • Overview delle componenti
      • Sicurezza e conservazione
      • L’adesione alla piattaforma pagoPA
      • Utilizzo del marchio pagoPA
      • Stand In
    • Erogazione e Livelli di servizio
    • Modello dati
  • Casi d'uso
    • Pagamento di un avviso presso PSP
    • Pagamento spontaneo presso PSP
      • Catalogo dei servizi
      • Bollo auto
    • Pagamento presso frontend dell'EC
    • Pagamento da Touchpoint PagoPA
      • Checkout
      • App IO
  • Ente Creditore
    • Adesione
    • Modalità d'integrazione
      • Integrazione tramite API asincrone
      • Integrazione tramite API sincrone
      • Integrazione touch point dell’EC con Checkout
      • Best practice
    • Generazione dell’Identificativo Univoco di Versamento
    • Tassonomia dei servizi di incasso
    • Tributi multi-beneficiario
    • Attestazione di pagamento
    • Riconciliazione contabile
    • Servizio @e.bollo
    • Stampa avvisi pagoPA
    • Processo di avvio in Esercizio
  • Prestatore di Servizi di Pagamento
    • Adesione
    • Modalità di integrazione
      • Integrazione tramite API
      • Catalogo Dati Informativi
      • Offrire sistemi di pagamento su touchpoints di PagoPA S.p.A.
      • Integrazione standard per gli strumenti di pagamento
      • Integrazione per strumento di pagamento PayPal
      • Integrazione per strumento di pagamento tramite Redirect
      • Best practice
    • Commissioni
    • Attestazione di pagamento
    • Processo di avvio in Esercizio
    • Quality Improvement
  • Esperienza per il Cittadino
    • App IO
      • Carte
      • PayPal
    • Checkout
  • Appendici
    • Connettività
    • Indicatori di qualità per i soggetti aderenti
      • Livelli di Servizio Enti Creditori
      • Livelli di Servizio PSP
    • Giornale degli eventi
    • Generazione e stampa degli avvisi
    • Gestione evoluta commissioni
    • Primitive
    • Funzionalità deprecate
    • Adesione ai servizi con subscription key
    • Posizioni Debitorie
      • Modello Dati
      • Stati della posizione debitoria
      • Pagamenti presso frontend dell'EC in modalità asincrona
      • Gestione Massiva
        • Caricamento massivo
      • Operazioni disponibili
    • POS Fisici
  • FAQ
    • Ente Creditore
    • PSP
    • Intermediario tecnologico
Powered by GitBook
On this page
  • Processo di pagamento in Stand In
  • Funzionalità di Stand In per i pagamenti attivati presso PSP
  • Tracciamento dei pagamenti in Stand In
  • Rendicontazione dei pagamenti gestiti in Stand In
  • Impatti per gli EC derivanti dall'attivazione dello Stand In
  • Aggiornamento della posizione debitoria su ACA
  • Gestione degli avvisi di pagamento pagati in Stand In
  • Gestione degli avvisi di pagamento pagati in Stand In nel caso di conferimento all’ACA tramite la paCreatePosition
  • Definizione di un IBAN di default per pagamenti in Stand In
  • Attivazione dello Stand In
  • Disattivazione dello Stand In
  • Pricing per posizione debitoria gestita
  1. Specifiche attuative del nodo dei pagamenti SPC
  2. Funzionamento generale

Stand In

PreviousUtilizzo del marchio pagoPANextErogazione e Livelli di servizio

Last updated 3 months ago

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

Funzionalità di Stand In per i pagamenti attivati presso PSP

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.

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.

Per casistiche da valutarsi caso per caso, è possibile definire delle esclusioni dalla funzionalità di Stand in, tale impostazione è attivabile 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.

Le condizioni di esclusione saranno definite da parte di PagoPA S.p.A. secondo un processo ad hoc che sarà stabilito nelle future versioni delle SANP.

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

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.

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

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.

Attivazione dello Stand In

  • 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

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.

La funzionalità di Stand In può essere attivata per il caso Pagamento spontaneo presso PSP, in particolare richiamando le primitive e .

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 utilizzando le modalità standard dettagliate in .

response

response

response

request

request.

È 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 in.

L’integrazione con ACA, solo ed esclusivamente nel caso di conferimento tramite la , prevede la comunicazione delle seguenti informazioni:

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

Qualora il pagamento di una posizione debitoria di tipo multi-beneficiario avvenga in modalità di Stand In, solo ed esclusivamente nel caso di conferimento all’ACA tramite la , verrà effettuato un unico riversamento all’EC che ha creato l’avviso di pagamento con l’importo totale (EC presente nel campo fiscalCodePA), sarà responsabilità di quest’ultimo assicurare una suddivisione accurata delle quote di pagamento tra gli ulteriori EC inseriti come beneficiari, nelle modalità da lui individuate in accordo con gli EC secondari.

Tali informazioni relative all’IBAN di default vengono utilizzate solo nel caso non siano stati inviati entrambi i campi Iban e postalIban tramite la .

In caso di conferimento all’ACA tramite API di creazione e aggiornamento del servizio di (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.

Le logiche per attivare la funzionalità si fondano sulle primitive e , di queste primitive si monitorano i seguenti faultCode:

Le logiche per disattivare la funzionalità si fondano sulla primitiva , 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 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.

link
paVerifyPaymentNotice
paGetPaymentV1/V2
verifyPaymentNotice
verificaBollettino
activatePaymentNoticeV1/V2
pspNotifyPaymentV1/V2
paSendRTV1/V2
paCreatePosition
paCreatePosition
paCreatePosition
paCreatePosition
paVerifyPaymentNotice
paGetPaymentV1/V2
paVerifyPaymentNotice
paVerifyPaymentNotice
paSendRTV1/V2
Fase di invio della ricevuta
Archivio Centralizzato Avvisi
Gestione Posizione Debitorie