LogoLogo
SANPSACITutto il resto
SANP 3.6.0
SANP 3.6.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
  • 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
      • Operazioni disponibili
    • POS Fisici
  • FAQ
    • Ente Creditore
    • PSP
    • Intermediario tecnologico
Powered by GitBook
On this page
  • Parametri della redirect
  • Selezione della Lingua
  • Compatibilità Browser
  1. Ente Creditore
  2. Modalità d'integrazione

Integrazione touch point dell’EC con Checkout

PreviousIntegrazione tramite API sincroneNextBest practice

Nel caso di Pagamento presso frontend dell'EC l'integrazione con la piattaforma pagoPA avviene per mezzo di Checkout, un’applicazione web che consente ad ogni utente la navigazione degli strumenti di pagamento resi disponibili dai PSP aderenti alla piattaforma pagoPA.

La navigazione del Checkout può avvenire solo in modalità Guest, viene richiesta una mail a cui inviare l’esito dell’operazione.

Parametri della redirect

  • emailNotice: indirizzo mail a cui inviare la ricevuta di pagamento, sarà possibile modificarlo durante il processo di pagamento

  • returnUrls: indirizzi di ritorno sul sito dell'ente creditore

    • returnOkUrl: casi di successo

    • returnCancelUrl: casi di annullamento

    • returnErrorUrl: casi di errore

  • un array degli avvisi da pagare, con un numero massimo di 5, per ognuno dei quale è necessario specificare

    • noticeNumber: numero avviso

    • fiscalCode: codice fiscale dell'EC

    • amount: importo dell'avviso di pagamento ( in centesimi di euro)

    • companyName : denominazione dell'ente creditore

    • description : oggetto del pagamento

In risposta a tale chiamata, si ottiene un HTTP Status 302 che istruisce il browser dell'utente al re-indirizzamento verso la pagina dove procedere con il pagamento.

Terminata la sessione di pagamento l'utente viene riportato alla url indicata dall'EC in base all'esito del pagamento.

Selezione della Lingua

Checkout verrà visualizzato nella lingua impostata all'interno del Browser dell'utente, nel caso di lingua non supportata verrà utilizzata la lingua italiana. In qualsiasi momento, l'utente potrà modificare la lingua.

Compatibilità Browser

Lo sviluppo del Checkout segue le linee guida di design per i servizi digitali della PA.

In particolare, viene assicurata la compatibilità con versioni dei browser che abbiano una penetrazione media tra la popolazione di almeno 1 persona ogni 100 abitanti.

Ciò significa che con i dati disponibili ad oggi i browser supportati sono:

  • Chrome

  • Safari

  • Firefox

  • Samsung Internet Browser

  • Edge

  • Opera

Il browser Internet Explorer 11 (IE-11) non rientra tra la lista dei browser supportati. Nel dettaglio, IE-11 non supporta gli standard web moderni ed è un freno all’implementazione all’interno delle nostre piattaforme di API web moderne e con misure di sicurezza più avanzate rispetto a quanto disponibile nel 2013.

L'integrazione con Checkout è attivata per mezzo di una redirect innescata tramite una chiamata specificando i seguenti parametri :

idCart: identificativo del carrello attribuito dall'EC, il parametro viene inserito in fase di attivazione nel tag paymentNote della

allCCP: impostandolo a TRUE l'EC comunica alla piattaforma pagoPA che tutti i transfer dell'avviso possono essere associati a IBAN postali, la che l'EC riceverà per l'attivazione dell'avviso corrente conterrà il parametro .

transferType valorizzato a POSTAL
POST
paGetPayment
paGetPayment