> For the complete documentation index, see [llms.txt](https://docs.opencityitalia.it/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.opencityitalia.it/sviluppatori-e-partner-tecnologici/integrazioni/integrazione-con-intermediari-di-pagamento-pagopa/requisiti-per-lintegrazione.md).

# 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)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.opencityitalia.it/sviluppatori-e-partner-tecnologici/integrazioni/integrazione-con-intermediari-di-pagamento-pagopa/requisiti-per-lintegrazione.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.