Requisiti per l'integrazione

Introduzione

L’area personale di OpenCity Italia è progettata per integrarsi con vari intermediari di pagamento utilizzati da Comuni ed enti pubblici. Questa sezione descrive i requisiti tecnici necessari per sviluppare e implementare l'integrazione tra la piattaforma e l'intermediario di pagamento PagoPA.

Le interazioni avvengono in seguito ad alcune azioni da parte dei cittadini e degli operatori:

• Invio di una pratica da parte del cittadino

• Approvazione di una pratica da parte di un operatore nel caso di un pagamento posticipato

• Importazione di dovuti da parte dell'operatore mediante API file csv

• Pagamento di un dovuto da parte del cittadino a seguito dell'importazione di quest'ultimo

Requisiti Generali

Per sviluppare l'integrazione con l'intermediario di pagamento PagoPA, sono richiesti i seguenti elementi:

• Documentazione Tecnica: Manuali, guide e riferimenti API.

• Endpoint/Ambiente di Test: URL degli endpoint e accesso a un ambiente di test per effettuare chiamate API.

• Modalità di Verifica dello Stato del Pagamento: Specifiche delle modalità di verifica dello stato del pagamento, tramite polling o notifica.

Dettagli Tecnici dell'Integrazione

Per integrare OpenCity Italia Area Personale con l’intermediario di PagoPA, sono necessari i seguenti parametri minimi:

Creazione di un Pagamento

• Parametri per la creazione di un pagamento

• Parametri per la creazione di una Marca da Bollo Digitale

• Restituzione del numero IUV e/o del numero avviso in fase di creazione del pagamento

Scaricamento Documenti

• Parametri per scaricare l’avviso di pagamento cartaceo

• Parametri per scaricare la ricevuta telematica una volta effettuato il pagamento

Dovuto

• API per il download degli importi dovuti (se disponibile)

Specifiche delle API

L’intermediario di pagamento deve fornire documentazione dettagliata delle API, comprensiva di:

• Endpoint

• Metodi supportati (GET, POST, etc.)

• Parametri richiesti e facoltativi

• Formato dei dati (JSON, XML)

• Esempi di richieste e risposte

Configurazione di Rete

Per garantire le comunicazioni fra la piattaforma e l’intermediario di pagamento, è necessario sbloccare gli IP delle chiamate entranti verso gli endpoint dell’intermediario di pagamento. Gli IP di OpenCity da sbloccare sono:

• 93.41.234.251/32

• 78.47.94.152/32

• 54.220.150.231/32

• 63.33.155.248/32

• 37.186.144.203/32

Supporto Tecnico

Per risolvere eventuali complicazioni, errori o bug durante l'integrazione, è fondamentale avere un contatto tecnico dedicato. Si prega di fornire i seguenti dettagli del contatto tecnico:

• Nome

• Email

• Telefono

• Disponibilità (orari di lavoro)