LogoLogo
SANPSACITutto il resto
SANP 3.0.0
SANP 3.0.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
      • Sicurezza e conservazione
      • L’adesione alla piattaforma pagoPA
      • Utilizzo del marchio pagoPA
    • Erogazione e Livelli di servizio
    • Specifiche tecniche
    • 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
      • 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
    • 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 touch point di PagoPA S.p.A.
      • Gestione strumenti di pagamento
      • Best practice
    • Commissioni
    • Attestazione di pagamento
    • Processo di avvio in Esercizio
  • 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
    • Generazione e stampa degli avvisi
    • Primitive
    • Funzionalità deprecate
  • FAQ
    • Ente Creditore
    • PSP
    • Intermediario tecnologico
Powered by GitBook
On this page
  • Fase di richiesta di creazione della posizione debitoria
  • Fase di verifica
  • Fase di attivazione
  • Fase di invio della ricevuta
  1. Ente Creditore
  2. Modalità d'integrazione

Integrazione tramite API

PreviousModalità d'integrazioneNextIntegrazione touch point dell’EC con Checkout

Last updated 2 years ago

Per la gestione degli errori fare riferimento a

Fase di richiesta di creazione della posizione debitoria

  • il numero avviso;

  • il codice fiscale dell'EC da utilizzare nella fase di attivazione;

  • l'importo parziale di ogni singolo versamento;

  • il codice fiscale dell’EC beneficiario di ogni singolo versamento.

Durante questa fase la posizione debitoria deve rimanere nello stato aperta.

Gli EC mettono a disposizione i dati dello specifico servizio tramite il Catalogo dei servizi.

Fase di verifica

  • importo parziale;

  • codice fiscale dell’EC beneficiario;

  • il parametro allCCP, che indica se l’opzione di pagamento è associabile a tutti conti correnti postali o meno

    • allCCP = true: l’opzione è associabile a tutti conti correnti postali;

    • allCCP = false: l’opzione non è associabile a tutti conti correnti postali.

Durante questa fase la posizione debitoria deve rimanere nello stato aperta.

Il Nodo effettua una verifica semantica sulla response:

  • deve essere presente la paymentList;

  • il tag officeName è opzionale, tutti i restanti tags sono obbligatori.

Fase di attivazione

  • importo parziale;

  • codice fiscale dell’EC beneficiario;

  • IBAN da usare per il riversamento.

Durante questa fase la posizione debitoria deve rimanere nello stato aperta, sarà cura del Nodo inibire altri tentativi di pagamento per lo stesso numero avviso.

Il Nodo effettua una verifica semantica sulla response:

  • verifica la corrispondenza tra il valore di paymentAmount e la somma di tutti gli amount presenti nei transfer;

  • ci deve essere almeno un'occorrenza di transfer;

  • controllo semantico degli IBAN in ogni transfer;

  • viene verificata l'esistenza sul Nodo dell'associazione tra fiscalCodePA e IBAN;

  • nel caso di presenza di un'EC secondario viene verificato che sia abilitato sul Nodo.

Fase di invio della ricevuta

In questa fase, dopo la ricezione della receipt, la posizione debitoria deve essere posta nello stato chiusa.

La è utilizzata per richiedere all’EC la creazione della posizione debitoria in base ai dati dello specifico servizio inviati, l'EC invia in risposta le informazioni necessarie per avviare il processo di pagamento, in particolare:

La è utilizzata per richiedere all’EC la verifica dell’opzione di pagamento identificata dal numero avviso, che invia le informazioni di pagamento relative al numero avviso, in particolare:

La richiesta di attivazione del pagamento giunge all’EC per mezzo della , l'EC invia l’importo del pagamento ed i dati necessari per il riversamento della somma, in particolare per ogni versamento:

Tramite la primitiva viene inoltrata agli n EC interessati al pagamento la receipt (ricevuta) solo se il pagamento è stato effettuato, la receipt è un oggetto generato dalla piattaforma pagoPA.

Gestione degli errori
paDemandPaymentNotice
paVerifyPaymentNotice
paGetPayment
paSendRT