Il Servizio PagoPA di Buffetti Finance consente ai partner tecnologici di integrare nei propri sistemi la gestione completa dei pagamenti verso la Pubblica Amministrazione tramite il circuito pagoPA, nel rispetto delle specifiche ufficial. Il servizio espone API bancarie che permettono di verificare posizioni debitorie, inizializzare e confermare pagamenti, gestire esiti e produrre le ricevute di pagamento. È progettato per abilitare casi d’uso sia POS fisici sia canali digitali, demandando a Buffetti Finance il ruolo di PSP e l’interazione diretta con l’infrastruttura pagoPA.

A chi è rivolto

  • Software house che sviluppano soluzioni per enti, professionisti o reti di punti operativi
  • Partner tecnologici e system integrator
  • PSP / fintech che necessitano di un accesso indiretto a pagoPA
  • Applicazioni web, mobile o back‑office che gestiscono incassi verso la PA

Valore per il cliente / per lo sviluppatore

  • Astrazione della complessità normativa e tecnica del circuito pagoPA
  • Riduzione del time‑to‑market grazie a API già allineate alle specifiche ufficiali
  • Flussi standardizzati per verifica, pagamento, rendicontazione e ricevuta
  • Delega a Buffetti Finance degli aspetti PSP, regolamentari e di connessione ai circuiti
  • Coerenza dei flussi tra canali fisici (POS) e digitali (VPOS)

Modello di integrazione

Il partner integra le API di Buffetti Finance all’interno delle proprie applicazioni. Buffetti Finance opera come Payment Service Provider, interfacciandosi direttamente con il nodo pagoPA secondo le specifiche SANP.

Il partner:

  • raccoglie i dati di pagamento (es. Notice Number, ente creditore)
  • orchestra il flusso applicativo verso l’utente finale

Buffetti Finance:

  • valida la posizione debitoria
  • gestisce l’esecuzione del pagamento
  • comunica con pagoPA
  • restituisce esiti e ricevute

PagoPA rappresenta l’infrastruttura esterna che garantisce l’allineamento con gli enti creditori.

Il pagamento può essere finalizzato:

  • tramite POS fisico, con ingaggio del terminale associato all’agenzia
  • tramite VPOS, con reindirizzamento del cliente a una pagina di pagamento e callback asincrona verso il partner

Modelli operativi

  • Modello POS fisico con carrello: il servizio consente la creazione di un carrello contenente uno o più pagamenti pagoPA (IUV). Il partner aggiunge le posizioni al carrello e invoca la conferma del pagamento. La conferma attiva il terminale POS fisico associato all’agenzia, al quale viene inviato l’importo complessivo del carrello. Il pagatore effettua il pagamento secondo gli standard bancari; Buffetti Finance restituisce l’esito della conferma e la ricevuta conforme agli standard pagoPA.
  • Modello VPOS con carrello: il partner crea un carrello di uno o più pagamenti pagoPA e ne richiede la conferma. In questo scenario la conferma del pagamento genera il reindirizzamento del pagatore verso una pagina sicura di Virtual POS per l’inserimento dei dati di pagamento.
  • Modello SDD / addebito differito per agenzia convenzionata: l’agenzia convenzionata può processare i pagamenti pagoPA con addebito differito sul proprio conto tramite disposizione di incasso nel giorno successivo. L’integrazione applicativa prevede le fasi di verifica e conferma del pagamento pagoPA, mentre gli aspetti di regolamento e incasso sono disciplinati da accordi operativi e dalla sottoscrizione del mandato all’incasso tra agenzia e Buffetti Finance.
  • Modello incasso su conto Buffetti Finance (contanti o addebito su conto): l’agenzia che integra il servizio apre un conto dedicato presso Buffetti Finance. I pagamenti pagoPA possono essere incassati dall’agenzia anche in contanti . In fase di conferma del pagamento pagoPA, al messaggio applicativo di conferma è associato il flusso finanziario: Buffetti Finance decurta l’importo dal conto dell’agenzia e procede all’esecuzione del pagamento verso pagoPA. Questo modello è applicabile sia alle agenzie che incassano direttamente dai pagator che si abilitano come soggetti esternalizzati all’incasso che raccolgono i pagamenti e regolano gli importi tramite il proprio conto Buffetti Finance.

 Flusso operativo del servizio

  1. Autenticazione del partner e ottenimento del token di accesso
  2. Inizializzazione del flusso di pagamento e correlazione tramite Transaction ID
  3. Verifica della posizione debitoria pagoPA
  4. Conferma del pagamento
  5. Esecuzione del pagamento tramite i sistemi Buffetti Finance
  6. Invio dell’esito a pagoPA
  7. Recupero della ricevuta di pagamento
  8. Consultazione dello stato della transazione (opzionale)

Funzionalità principali

  • Verifica posizione debitoria pagoPA
  • Gestione pagamenti pagoPA singoli o multipli
  • Supporto a POS fisico e VPOS
  • Conferma e annullamento delle operazioni
  • Recupero ricevute di pagamento
  • Consultazione stato transazioni
  • Funzioni di supporto (plafond, rendicontazione, anagrafiche)

Integrazione tecnica (high level)

  • Integrazione tramite API REST
  • Formato dati JSON
  • Autenticazione basata su OAuth con token JWT
  • Disponibilità di ambienti di test e produzione
  • Gestione sincrona e asincrona degli esiti (callback)

I dettagli di payload, parametri e codici di errore sono disponibili nella documentazione tecnica.