Vai al contenuto

PagoPA - Piattaforma Pagamenti PA

Panoramica

L'integrazione PagoPA gestisce i pagamenti delle sanzioni del Codice della Strada. Il sistema genera IUV (Identificativo Univoco Versamento) per ogni sanzione e traccia lo stato dei pagamenti attraverso la piattaforma PagoPA.

Architettura

sequenceDiagram
    participant OP as Operatore (GeCo.Alfa)
    participant ELB as ElaborazioneService
    participant CONN as ConnessioneService
    participant PAGO as PagoPA

    OP->>ELB: Generazione avviso pagamento
    ELB->>ELB: Generazione IUV + barcode
    ELB->>CONN: Invio posizione debitoria
    CONN->>PAGO: nodoInviaRPT (SOAP)
    PAGO-->>CONN: Esito invio

    Note over PAGO: Cittadino paga

    CONN->>PAGO: Verifica stato pagamento
    PAGO-->>CONN: RT (Ricevuta Telematica)
    CONN-->>ELB: Aggiornamento pagamento
    ELB->>ELB: Update VvPagamento

Classi di Implementazione

Configurazione

Entita Descrizione
VpParPagopa Parametri integrazione PagoPA (credenziali, endpoint, codice ente)

Entita JPA (MLib)

Entita Tabella Descrizione
VvPagamento vv_pagamento Record pagamento sanzione
VvRateizzazione vv_rateizzazione Piano di rateizzazione
VvRata vv_rata Singola rata del piano
VvRataPag vv_rata_pag Collegamento rata-pagamento
VvCauzione vv_cauzione Deposito cauzionale
VvBollincasCcpriep vv_bollincas_ccpriep Bollettino incasso
VvBollincasCcpver vv_bollincas_ccpver Bollettino versamento

Tabelle di Riferimento

Entita Descrizione
VfModalPag Modalita di pagamento accettate
VfTipoPag Tipologie pagamento
VfTipoPagrate Tipi piani rateizzazione
VpParRateizzazione Parametri configurazione rate

Protocollo

  • Tipo: SOAP over HTTPS
  • Autenticazione: Mutual TLS + firma richiesta
  • Formato dati: XML (WSDL PagoPA)
  • Operazioni principali:
    • Invio posizione debitoria (nodoInviaRPT)
    • Verifica stato pagamento
    • Ricezione Ricevuta Telematica (RT)
    • Generazione IUV

Generazione Avvisi

Il sistema genera avvisi di pagamento con:

  • IUV: Identificativo Univoco Versamento
  • Barcode: Generato con ZXing (MLib)
  • QR Code: Per pagamento tramite app IO
  • PDF avviso: Generato con iText (template in VpTemplate)

Riferimenti