LogoLogo
SANPSACITutto il resto
SANP 3.9.1
SANP 3.9.1
  • ⬅️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
    • Opzioni di pagamento
      • Casi d'uso
        • Unica opzione totale
        • Più opzioni di pagamento con scadenze differenti
        • Unico piano rateale
        • Opzione totale e piano rateale (unico)
        • Opzione con molteplici piani rateali (con o senza opzione totale)
        • Co-obbligati in solido
  • 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
    • Opzioni di pagamento
      • Casi d'uso
        • Unica opzione totale
        • Più opzioni di pagamento con scadenze differenti
        • Unico piano rateale
        • Opzione totale e piano rateale (unico)
        • Opzioni con molteplici piani rateali (con o senza opzione totale)
        • Co-obbligati in solido
  • 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
    • Posizioni Debitorie
      • Modello Dati
      • Stati della posizione debitoria
      • Pagamenti presso frontend dell'EC in modalità asincrona
      • Gestione Massiva
        • 📄Specifiche tracciato di input
        • ⚙️Gestione massiva tramite API REST
        • 📥Gestione massiva tramite SFTP
      • Operazioni disponibili
    • POS Fisici
  • FAQ
    • Ente Creditore
    • PSP
    • Intermediario tecnologico
Powered by GitBook
On this page
  1. Ente Creditore

Opzioni di pagamento

PreviousProcesso di avvio in EsercizioNextCasi d'uso

Last updated 25 days ago

PagoPA mette a disposizione degli Enti Creditori (EC) una funzionalità per gestire le opzioni di pagamento, come piani rateali, maggiorazioni o riduzioni dell’importo. L’EC in fase di verifica del pagamento può inserire una serie di opzioni di pagamento che, tramite il touchpoint del PSP da cui è partita la richiesta, il cittadino può scegliere di pagare. Grazie a questa nuova funzionalità gli EC possono gestire il proprio archivio delle posizioni debitorie contemplando la possibilità di gestire le opzioni di pagamento che possono offrire al cittadino. Ad esempio possono dare al cittadino la possibilità di pagare un avviso in modalità unica piuttosto che con dei piani rateali. La piattaforma pagoPA, nell’attuale processo di verifica della posizione debitoria, non prevede il concetto di opzioni di pagamento (OdP) multiple, pertanto è stato necessario implementare un nuovo servizio che preveda questo tipo di gestione. Il nuovo servizio si comporta da proxy esponendo una API che i PSP possono invocare per verificare il pagamento e recuperare le OdP disponibili nell’ambito della stessa posizione debitoria. Il nuovo servizio gestisce internamente la configurazione necessaria per poter contattare l’endpoint esposto dagli EC, che dunque devono esporre un nuovo servizio mediante la seguente URL:

<baseEcUrl>/payment-options/organizations/{fiscal-code}/notices/{notice-number}

Tale URL viene invocata dalla nuova componente mediante una chiamata GET REST. L’esposizione del servizio sopraindicato è in carico all’EC in caso di integrazione sincrona, o in carico a Gestione Posizioni Debitorie (GPD) in caso di integrazione asincrona. Per riassumere, gli EC che vogliono utilizzare la nuova funzionalità di OdP devono:

  • configurare le stazioni per specificare se si supporta o meno il recupero delle opzioni di pagamento (per maggiori informazioni si rimanda al manuale utente del Backoffice al seguente link: );

  • in caso di integrazione sincrona configurare un nuovo endpoint REST per le stazioni che supportano le opzioni di pagamento;

  • implementare la logica delle opzioni di pagamento secondo quanto descritto nei .

Viene pertanto utilizzato il nuovo flag all’interno della configurazione delle stazioni per determinare se il servizio può restituire o meno le nuove opzioni di pagamento.

Processo di pagamento con opzioni di pagamento

Di seguito sono descritti i passi principali del flusso di pagamento con la gestione delle opzioni di pagamento, lato Ente Creditore:

L’EC se gestisce le opzioni di pagamento (l’EC quindi ha configurato le proprie stazioni per poterle gestire), restituisce nella response della le opzioni di pagamento disponibili per quel numero avviso. Se l’EC non gestisce le opzioni di pagamento, il PSP riceverà in response un messaggio di errore che lo invita ad utilizzare la primitiva . A questo punto il flusso procede normalmente con la primitiva verso l’EC.

Tutti i dettagli relativi al funzionamento della nuova API sono disponibili nella pagina Primitive alla sezione .

https://developer.pagopa.it/pago-pa/guides/manuale-bo-ec/readme/funzionalita/stazioni/configurazione-opzioni-di-pagamento
casi d'uso
paVerifyPaymentOptions
verifyPaymentNotice
paVerifyPaymentNotice
#pagetpayment-1
paVerifyPaymentOptions