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
  • paVerifyPaymentNotice
  • paGetPayment
  • paGetPayment versione 1
  • paGetPayment versione 2
  • paSendRT
  • paSendRT versione 1
  • paSendRT versione 2
  • verifyPaymentNotice
  • verificaBollettino
  • activatePaymentNotice
  • activatePaymentNotice versione 1
  • activatePaymentNotice versione 2
  • sendPaymentOutcome
  • sendPaymentOutcome versione 1
  • sendPaymentOutcome versione 2
  • pspNotifyPayment
  • pspNotifyPayment versione 1
  • pspNotifyPayment versione 2
  • demandPaymentNotice
  • paDemandPaymentNotice
  • nodoInviaFlussoRendicontazione
  • nodoChiediElencoFlussiRendicontazione
  • nodoChiediFlussoRendicontazione
  • nodoChiediInformativaPA
  • nodoChiediCatalogoServizi
  • nodoChiediTemplateInformativaPSP
  1. Appendici

Primitive

PreviousLivelli di Servizio PSPNextFunzionalità deprecate

Last updated 2 years ago

Per la gestione degli errori fare riferimento a .

I campi contrassegnati con﹡sono obbligatori

Per i dettagli

paVerifyPaymentNotice

POST

-

Request Body

Name
Type
Description

idPA*

String

codice fiscale della struttura che invia la richiesta di pagamento

idBrokerPA*

String

identificativo del soggetto che opera come intermediario per l'EC

idStation*

String

identificativo della stazione dell'EC nel sistema pagoPa

qrCode*

String

è composto da fiscalCode e noticeNumber

fiscalCode*

String

codice fiscale dell'EC

noticeNumber*

String

[auxDigit][segregationCode][IUVBase][IUVCheckDigit]

  <soapenv:Envelope>
    <soapenv:Header />
    <soapenv:Body>
      <nod:paVerifyPaymentNoticeReq>
        <idPA>77777777777</idPA>
        <idBrokerPA>77777777777</idBrokerPA>
        <idStation>77777777777_01</idStation>
        <qrCode>
          <fiscalCode>77777777777</fiscalCode>
          <noticeNumber>311111111112222222</noticeNumber>
        </qrCode>
      </nod:paVerifyPaymentNoticeReq>
    </soapenv:Body>
  </soapenv:Envelope>
<soapenv:Envelope>
  <soapenv:Header />
  <soapenv:Body>
    <paf:paVerifyPaymentNoticeRes>
      <outcome>OK</outcome>
      <paymentList>
        <paymentOptionDescription>
          <amount>30.00</amount>
          <options>EQ</options>
          <dueDate>2021-12-31</dueDate>
          <detailDescription>test</detailDescription>
          <allCCP>false</allCCP>
        </paymentOptionDescription>
      </paymentList>
      <paymentDescription>payment</paymentDescription>
      <fiscalCodePA>77777777777</fiscalCodePA>
      <companyName>company EC</companyName>
      <officeName>office EC</officeName>
    </paf:paVerifyPaymentNoticeRes>
  </soapenv:Body>
</soapenv:Envelope>
  • outcome﹡: il risultato dell'operazione che può contenere i seguenti codici

    • OK : operazione eseguita con successo

    • KO : operazione terminata con errore

  • paymentList: struttura che contiene i dettagli del pagamento, al momento può contenere una sola paymentOptionDescription, da inserire obbligatoriamente in caso di outcome OK

    • paymentOptionDescription﹡

      • amount﹡: importo in euro

      • options﹡: al momento deve essere valorizzato con EQ

      • dueDate: data di scadenza del pagamento secondo il formato ISO 8601 [AAAA]-[MM]-[GG]

      • detailDescription: testo libero per descrivere l'oggetto del pagamento

      • allCCP﹡: se TRUE indica che tutti i bonifici sono associabili a IBAN postali

  • paymentDescription: testo libero per descrivere l'oggetto del pagamento, da inserire obbligatoriamente in caso di outcome OK

  • fiscalCodePA: codice fiscale dell'EC, da inserire obbligatoriamente in caso di outcome OK

  • companyName: nome completo dell'EC, da inserire obbligatoriamente in caso di outcome OK

  • officeName: nome completo dell'ufficio dell'EC

paGetPayment

paGetPayment versione 1

POST

Request Body

Name
Type
Description

idPA*

String

Codice fiscale della struttura che invia la richiesta di pagamento.

dueDate

String

Data di scadenza del pagamento secondo il formato ISO 8601 [AAAA]-[MM]-[GG].

transferType

String

Valore ammesso: POSTAL.

paymentNote

String

Descrizione del pagamento.

amount

String

Importo del pagamento in euro.

noticeNumber*

String

[auxDigit][segregationCode][IUVBase][IUVCheckDigit]

fiscalCode*

String

Codice fiscale dell'EC.

qrCode*

String

E' composto da fiscalCode e noticeNumber.

idStation*

String

Identificativo della stazione dell'EC nel sistema pagoPa.

idBrokerPA*

String

Identificativo del soggetto che opera come intermediario per l'EC.

<soapenv:Envelope>
    <soapenv:Body>
      <pafn:paGetPaymentReq>
        <idPA>77777777777</idPA>
        <idBrokerPA>77777777777</idBrokerPA>
        <idStation>77777777777_01</idStation>
        <qrCode>
          <fiscalCode>77777777777</fiscalCode>
          <noticeNumber>311111111112222222</noticeNumber>
        </qrCode>
        <amount>30.00</amount>
      </pafn:paGetPaymentReq>
    </soapenv:Body>
  </soapenv:Envelope>    
<soapenv:Envelope>
  <soapenv:Header />
  <soapenv:Body>
    <paf:paGetPaymentRes>
      <outcome>OK</outcome>
      <data>
        <creditorReferenceId>11111111112222222</creditorReferenceId>
        <paymentAmount>30.00</paymentAmount>
        <dueDate>2021-12-31</dueDate>
        <retentionDate>2021-12-31T23:59:59</retentionDate>
        <lastPayment>0</lastPayment>
        <description>test</description>
        <companyName>company EC</companyName>
        <officeName>office EC</officeName>
        <debtor>
          <uniqueIdentifier>
            <entityUniqueIdentifierType>F</entityUniqueIdentifierType>
            <entityUniqueIdentifierValue>JHNDOE00A01F205N</entityUniqueIdentifierValue>
          </uniqueIdentifier>
          <fullName>John Doe</fullName>
          <streetName>street</streetName>
          <civicNumber>12</civicNumber>
          <postalCode>89020</postalCode>
          <city>city</city>
          <stateProvinceRegion>MI</stateProvinceRegion>
          <country>IT</country>
          <e-mail>john.doe@test.it</e-mail>
        </debtor>
        <transferList>
          <transfer>
            <idTransfer>1</idTransfer>
            <transferAmount>20.00</transferAmount>
            <fiscalCodePA>77777777777</fiscalCodePA>
            <IBAN>IT0000000000000000000000000</IBAN>
            <remittanceInformation>remittanceInformation1</remittanceInformation>
            <transferCategory>0101100IM</transferCategory>
          </transfer>
          <transfer>
            <idTransfer>2</idTransfer>
            <transferAmount>10.00</transferAmount>
            <fiscalCodePA>77777777778</fiscalCodePA>
            <IBAN>IT0000000000000000000000001</IBAN>
            <remittanceInformation>remittanceInformation2</remittanceInformation>
            <transferCategory>0201102IM</transferCategory>
          </transfer>
        </transferList>
        <metadata>
          <mapEntry>
            <key>keytest</key>
            <value>1</value>
          </mapEntry>
        </metadata>
      </data>
    </paf:paGetPaymentRes>
  </soapenv:Body>
</soapenv:Envelope>
  • outcome﹡: il risultato dell'operazione che può contenere i seguenti codici

    • OK : operazione eseguita con successo

    • KO : operazione terminata con errore

  • data: tutti i dettagli del pagamento, da inserire obbligatoriamente in caso di outcome OK

    • creditorReferenceId﹡: IUV Identificativo Univoco Versamento

    • paymentAmount﹡: importo, deve essere uguale alle somme di TransferAmount presenti nella TransferList

    • dueDate﹡: data di scadenza del pagamento secondo il formato ISO 8601 [AAAA]-[MM]-[GG]

    • retentionDate: timestamp che indica la fine del periodo di ritenzione delle informazioni sul pagamento da parte del Nodo

    • lastPayment

    • description﹡: testo libero per descrivere l'oggetto del pagamento

    • companyName: nome completo dell'EC

    • officeName: nome completo dell'ufficio dell'EC

    • debtor﹡: individua il debitore a cui si riferisce la posizione debitoria

      • uniqueIdentifier﹡

        • entityUniqueIdentifierType﹡

          • F : Persona fisica

          • G : Persona giuridica

        • entityUniqueIdentifierValue﹡: codice fiscale o partita IVA

      • fullName﹡: nome completo del debitore

      • streetName: indirizzo

      • civicNumber: numero civico

      • postalCode: CAP

      • city: citta'

      • stateProvinceRegion: regione

      • country: stato

      • e-mail

    • transferList﹡: struttura che contiene i dettagli dei transfer, al momento possono essere inseriti fino a 5 transfer, deve essercene almeno 1

      • transfer﹡

        • idTransfer﹡: indice della lista (da 1 a 5)

        • transferAmount﹡: importo

        • fiscalCodePA﹡: codice fiscale dell'EC

        • IBAN﹡: IBAN sul quale sarà effettuato il riversamento

        • remittanceInformation﹡: motivo del pagamento

        • transferCategory﹡: codice tassonomico, composto da Codice tipo Ente Creditore + Progressivo macro area + Codice tipologia servizio + Motivo Giuridico ( ex. 0101002IM )

    • metadata: è un campo di archiviazione chiave/valore ad uso esclusivo dell'EC. I dati saranno inseriti nella receipt (paSendRT)

      • mapEntry﹡

        • key﹡

        • value﹡

paGetPayment versione 2

POST

In questa versione è possibile inserire i metadata in ogni singolo transfer.

Request Body

Name
Type
Description

idPA*

String

Codice fiscale della struttura che invia la richiesta di pagamento.

idBrokerPA*

String

Identificativo del soggetto che opera come intermediario per l'EC.

idStation*

String

Identificativo della stazione dell'EC nel sistema pagoPa.

qrCode*

String

E' composto da fiscalCode e noticeNumber.

amount*

String

importo del pagamento in euro

paymentNote

String

descrizione del pagamento

transferType

String

valore ammesso: POSTAL

dueDate

String

data di scadenza del pagamento secondo il formato ISO 8601 [AAAA]-[MM]-[GG]

fiscalCode*

String

codice fiscale dell'EC

noticeNumber*

String

[auxDigit][segregationCode][IUVBase][IUVCheckDigit]

<soapenv:Envelope>
    <soapenv:Body>
      <pafn:paGetPaymentReq>
        <idPA>77777777777</idPA>
        <idBrokerPA>77777777777</idBrokerPA>
        <idStation>77777777777_01</idStation>
        <qrCode>
          <fiscalCode>77777777777</fiscalCode>
          <noticeNumber>311111111112222222</noticeNumber>
        </qrCode>
        <amount>30.00</amount>
      </pafn:paGetPaymentReq>
    </soapenv:Body>
  </soapenv:Envelope>         
<soapenv:Envelope>
  <soapenv:Header />
  <soapenv:Body>
    <paf:paGetPaymentRes>
      <outcome>OK</outcome>
      <data>
        <creditorReferenceId>11111111112222222</creditorReferenceId>
        <paymentAmount>30.00</paymentAmount>
        <dueDate>2021-12-31</dueDate>
        <retentionDate>2021-12-31T23:59:59</retentionDate>
        <lastPayment>0</lastPayment>
        <description>test</description>
        <companyName>company EC</companyName>
        <officeName>office EC</officeName>
        <debtor>
          <uniqueIdentifier>
            <entityUniqueIdentifierType>F</entityUniqueIdentifierType>
            <entityUniqueIdentifierValue>JHNDOE00A01F205N</entityUniqueIdentifierValue>
          </uniqueIdentifier>
          <fullName>John Doe</fullName>
          <streetName>street</streetName>
          <civicNumber>12</civicNumber>
          <postalCode>89020</postalCode>
          <city>city</city>
          <stateProvinceRegion>MI</stateProvinceRegion>
          <country>IT</country>
          <e-mail>john.doe@test.it</e-mail>
        </debtor>
        <transferList>
          <transfer>
            <idTransfer>1</idTransfer>
            <transferAmount>20.00</transferAmount>
            <fiscalCodePA>77777777777</fiscalCodePA>
            <IBAN>IT0000000000000000000000000</IBAN>
            <remittanceInformation>remittanceInformation1</remittanceInformation>
            <transferCategory>0101100IM</transferCategory>
            <metadata>
              <mapEntry>
                <key>keytest</key>
                <value>1</value>
              </mapEntry>
            </metadata>
          </transfer>
          <transfer>
            <idTransfer>2</idTransfer>
            <transferAmount>10.00</transferAmount>
            <fiscalCodePA>77777777778</fiscalCodePA>
            <IBAN>IT0000000000000000000000001</IBAN>
            <remittanceInformation>remittanceInformation2</remittanceInformation>
            <transferCategory>0201102IM</transferCategory>
          </transfer>
        </transferList>
        <metadata>
          <mapEntry>
            <key>keytest</key>
            <value>1</value>
          </mapEntry>
        </metadata>
      </data>
    </paf:paGetPaymentRes>
  </soapenv:Body>
</soapenv:Envelope>
  • outcome﹡: il risultato dell'operazione che può contenere i seguenti codici

    • OK : operazione eseguita con successo

    • KO : operazione terminata con errore

  • data: tutti i dettagli del pagamento, da inserire obbligatoriamente in caso di outcome OK

    • creditorReferenceId﹡: IUV Identificativo Univoco Versamento

    • paymentAmount﹡: importo, deve essere uguale alle somme di TransferAmount presenti nella TransferList

    • dueDate﹡: indica la data di scadenza del pagamento secondo il formato ISO 8601 [AAAA]-[MM]-[GG]

    • retentionDate: timestamp che indica la fine del periodo di ritenzione delle informazioni sul pagamento da parte del Nodo

    • lastPayment

    • description﹡: testo libero per descrivere l'oggetto del pagamento

    • companyName: nome completo dell'EC

    • officeName: nome completo dell'ufficio dell'EC

    • debtor﹡: individua il debitore a cui si riferisce la posizione debitoria

      • uniqueIdentifier﹡

        • entityUniqueIdentifierType﹡

          • F : Persona fisica

          • G : Persona giuridica

        • entityUniqueIdentifierValue﹡: codice fiscale o partita IVA

      • fullName﹡: nome completo del debitore

      • streetName: indirizzo

      • civicNumber: numero civico

      • postalCode: CAP

      • city: citta'

      • stateProvinceRegion: regione

      • country: stato

      • e-mail

    • transferList﹡: struttura che contiene i dettagli dei transfer, al momento possono essere inseriti fino a 5 transfer, deve essercene almeno 1

      • transfer﹡

        • idTransfer﹡: indice della lista (da 1 a 5)

        • transferAmount﹡: importo in euro

        • fiscalCodePA﹡: codice fiscale dell'EC

        • IBAN﹡: IBAN sul quale sarà effettuato il riversamento

        • remittanceInformation﹡: motivo del pagamento

        • transferCategory﹡: codice tassonomico, composto da Codice tipo Ente Creditore + Progressivo macro area + Codice tipologia servizio + Motivo Giuridico ( ex. 0101002IM )

        • metadata: è un campo di archiviazione chiave/valore.

          • mapEntry﹡

            • key﹡

            • value﹡

    • metadata: è un campo di archiviazione chiave/valore ad uso esclusivo dell'EC. I dati saranno inseriti nella receipt (paSendRT)

      • mapEntry﹡

        • key﹡

        • value﹡

paSendRT

paSendRT versione 1

POST

Request Body

Name
Type
Description

idPA*

String

codice fiscale della struttura che invia la richiesta di pagamento

receiptId*

String

identificatore univoco della receipt contiene il paymentToken assegnato da pagoPa

outcome*

String

il risultato dell'operazione che può contenere i codici OK o KO

receipt*

String

la ricevuta di pagamento

idStation*

String

identificativo della stazione dell'EC nel sistema pagoPa

idBrokerPA*

String

identificativo del soggetto che opera come intermediario per l'EC

entityUniqueIdentifierType*

String

F : Persona fisica

G : Persona giuridica

uniqueIdentifier*

String

debtor*

String

individua il debitore a cui si riferisce la posizione debitoria

officeName

String

companyName*

String

nome completo dell'EC

description*

String

paymentAmount*

String

importo espresso in euro

creditorReferenceId*

String

IUV Identificativo Univoco Versamento

fiscalCode*

String

codice fiscale dell'EC

noticeNumber*

String

[auxDigit][segregationCode][IUVBase][IUVCheckDigit]

entityUniqueIdentifierValue*

String

codice fiscale o partita IVA

e-mail

String

country

String

stateProvinceRegion

String

city

String

postalCode

String

civicNumber

String

streetName

String

fullName*

String

nome completo del debitore

transferCategory*

String

codice tassonomico, composto da Codice tipo Ente Creditore + Progressivo macro area + Codice tipologia servizio + Motivo Giuridico ( ex. 0101002IM )

remittanceInformation*

String

motivo del pagamento

IBAN*

String

IBAN sul quale sarà effettuato il riversamento

fiscalCodePA*

String

codice fiscale dell'EC

transferAmount*

String

importo

idTransfer*

String

indice della lista (da 1 a 5)

transfer*

String

transferList*

String

struttura che contiene i dettagli dei transfer

channelDescription*

String

idChannel*

String

PSPCompanyName*

String

pspPartitaIVA

String

pspFiscalCode

String

idPSP*

String

identificativo del PSP

key*

String

mapEntry*

String

metadata

String

transferDate

String

data del riversamento

applicationDate

String

data applicativa

paymentDateTime

String

data e ora del pagamento

fee

String

importo della commissione espresso in euro

paymentMethod

String

e-mail

String

country

String

stateProvinceRegion

String

city

String

postalCode

String

civicNumber

String

streetName

String

fullName*

String

nome completo del debitore

entityUniqueIdentifierValue*

String

codice fiscale o partita IVA

entityUniqueIdentifierType*

String

F : Persona fisica

G : Persona giuridica

uniqueIdentifier*

String

payer

String

individua il pagatore

value*

String

  <soapenv:Envelope>
    <soapenv:Body>
      <pafn:paSendRTReq>
        <idPA>77777777777</idPA>
        <idBrokerPA>77777777777</idBrokerPA>
        <idStation>77777777777_01</idStation>
        <receipt>
          <receiptId>c110729d258c4ab1b765fe902aae41d6</receiptId>
          <noticeNumber>311111111112222222</noticeNumber>
          <fiscalCode>77777777777</fiscalCode>
          <outcome>OK</outcome>
          <creditorReferenceId>11111111112222222</creditorReferenceId>
          <paymentAmount>30.00</paymentAmount>
          <description>test</description>
          <companyName>company EC</companyName>
          <officeName>office EC</officeName>
          <debtor>
            <uniqueIdentifier>
              <entityUniqueIdentifierType>F</entityUniqueIdentifierType>
              <entityUniqueIdentifierValue>JHNDOE00A01F205N</entityUniqueIdentifierValue>
            </uniqueIdentifier>
            <fullName>John Doe</fullName>
            <streetName>street</streetName>
            <civicNumber>12</civicNumber>
            <postalCode>89020</postalCode>
            <city>city</city>
            <stateProvinceRegion>MI</stateProvinceRegion>
            <country>IT</country>
            <e-mail>john.doe@test.it</e-mail>
          </debtor>
          <transferList>
            <transfer>
              <idTransfer>1</idTransfer>
              <transferAmount>20.00</transferAmount>
              <fiscalCodePA>77777777777</fiscalCodePA>
              <IBAN>IT0000000000000000000000000</IBAN>
              <remittanceInformation>remittanceInformation1</remittanceInformation>
              <transferCategory>0101100IM</transferCategory>
            </transfer>
            <transfer>
              <idTransfer>2</idTransfer>
              <transferAmount>10.00</transferAmount>
              <fiscalCodePA>77777777778</fiscalCodePA>
              <IBAN>IT0000000000000000000000001</IBAN>
              <remittanceInformation>remittanceInformation2</remittanceInformation>
              <transferCategory>0201102IM</transferCategory>
            </transfer>
          </transferList>
          <idPSP>88888888888</idPSP>
          <pspFiscalCode>88888888888</pspFiscalCode>
          <pspPartitaIVA>88888888888</pspPartitaIVA>
          <PSPCompanyName>PSP name</PSPCompanyName>
          <idChannel>88888888888_01</idChannel>
          <channelDescription>app</channelDescription>
          <payer>
            <uniqueIdentifier>
              <entityUniqueIdentifierType>F</entityUniqueIdentifierType>
              <entityUniqueIdentifierValue>JHNDOE00A01F205N</entityUniqueIdentifierValue>
            </uniqueIdentifier>
            <fullName>John Doe</fullName>
            <streetName>street</streetName>
            <civicNumber>12</civicNumber>
            <postalCode>89020</postalCode>
            <city>city</city>
            <stateProvinceRegion>MI</stateProvinceRegion>
            <country>IT</country>
            <e-mail>john.doe@test.it</e-mail>
          </payer>
          <paymentMethod>creditCard</paymentMethod>
          <fee>2.00</fee>
          <paymentDateTime>2021-10-01T17:48:22</paymentDateTime>
          <applicationDate>2021-10-01</applicationDate>
          <transferDate>2021-10-02</transferDate>
          <metadata>
            <mapEntry>
              <key>keytest</key>
              <value>1</value>
            </mapEntry>
          </metadata>
        </receipt>
      </pafn:paSendRTReq>
    </soapenv:Body>
  </soapenv:Envelope>
<soapenv:Envelope>
  <soapenv:Body>
    <paf:paSendRTRes>
      <outcome>OK</outcome>
    </paf:paSendRTRes>
  </soapenv:Body>
</soapenv:Envelope>
  • outcome﹡: il risultato dell'operazione che può contenere i seguenti codici

    • OK : operazione eseguita con successo

    • KO : operazione terminata con errore

paSendRT versione 2

POST

In questa versione possono essere inseriti i metadata in ogni singolo transfer della receipt.

Request Body

Name
Type
Description

idPA*

String

codice fiscale della struttura che invia la richiesta di pagamento

receiptId*

String

identificatore univoco della receipt contiene il paymentToken assegnato da pagoPa

outcome*

String

il risultato dell'operazione che può contenere i codici OK o KO

receipt*

String

la ricevuta di pagamento

idStation*

String

identificativo della stazione dell'EC nel sistema pagoPa

idBrokerPA*

String

identificativo del soggetto che opera come intermediario per l'EC

entityUniqueIdentifierType*

String

F : Persona fisica

G : Persona giuridica

uniqueIdentifier*

String

debtor*

String

individua il debitore a cui si riferisce la posizione debitoria

officeName

String

companyName*

String

nome completo dell'EC

description*

String

paymentAmount*

String

importo espresso in euro

creditorReferenceId*

String

IUV Identificativo Univoco Versamento

fiscalCode*

String

codice fiscale dell'EC

noticeNumber*

String

[auxDigit][segregationCode][IUVBase][IUVCheckDigit]

entityUniqueIdentifierValue*

String

codice fiscale o partita IVA

e-mail

String

country

String

stateProvinceRegion

String

city

String

postalCode

String

civicNumber

String

streetName

String

fullName*

String

nome completo del debitore

transferCategory*

String

codice tassonomico, composto da Codice tipo Ente Creditore + Progressivo macro area + Codice tipologia servizio + Motivo Giuridico ( ex. 0101002IM )

remittanceInformation*

String

motivo del pagamento

IBAN*

String

IBAN sul quale sarà effettuato il riversamento

fiscalCodePA*

String

codice fiscale dell'EC

transferAmount*

String

importo

idTransfer*

String

indice della lista (da 1 a 5)

transfer*

String

transferList*

String

struttura che contiene i dettagli dei transfer

channelDescription*

String

idChannel*

String

PSPCompanyName*

String

pspPartitaIVA

String

pspFiscalCode

String

idPSP*

String

identificativo del PSP

key*

String

mapEntry*

String

metadata

String

transferDate

String

data del riversamento

applicationDate

String

data applicativa

paymentDateTime

String

data e ora del pagamento

fee

String

importo della commissione espresso in euro

paymentMethod

String

e-mail

String

country

String

stateProvinceRegion

String

city

String

postalCode

String

civicNumber

String

streetName

String

fullName*

String

nome completo del debitore

entityUniqueIdentifierValue*

String

codice fiscale o partita IVA

entityUniqueIdentifierType*

String

F : Persona fisica

G : Persona giuridica

uniqueIdentifier*

String

payer

String

individua il pagatore

value*

String

value

String

key

String

mapEntry

String

metadata

String

  <soapenv:Envelope>
    <soapenv:Body>
      <pafn:paSendRTReq>
        <idPA>77777777777</idPA>
        <idBrokerPA>77777777777</idBrokerPA>
        <idStation>77777777777_01</idStation>
        <receipt>
          <receiptId>c110729d258c4ab1b765fe902aae41d6</receiptId>
          <noticeNumber>311111111112222222</noticeNumber>
          <fiscalCode>77777777777</fiscalCode>
          <outcome>OK</outcome>
          <creditorReferenceId>11111111112222222</creditorReferenceId>
          <paymentAmount>30.00</paymentAmount>
          <description>test</description>
          <companyName>company EC</companyName>
          <officeName>office EC</officeName>
          <debtor>
            <uniqueIdentifier>
              <entityUniqueIdentifierType>F</entityUniqueIdentifierType>
              <entityUniqueIdentifierValue>JHNDOE00A01F205N</entityUniqueIdentifierValue>
            </uniqueIdentifier>
            <fullName>John Doe</fullName>
            <streetName>street</streetName>
            <civicNumber>12</civicNumber>
            <postalCode>89020</postalCode>
            <city>city</city>
            <stateProvinceRegion>MI</stateProvinceRegion>
            <country>IT</country>
            <e-mail>john.doe@test.it</e-mail>
          </debtor>
          <transferList>
            <transfer>
              <idTransfer>1</idTransfer>
              <transferAmount>20.00</transferAmount>
              <fiscalCodePA>77777777777</fiscalCodePA>
              <IBAN>IT0000000000000000000000000</IBAN>
              <remittanceInformation>remittanceInformation1</remittanceInformation>
              <transferCategory>0101100IM</transferCategory>
              <metadata>
                <mapEntry>
                  <key>keytest</key>
                  <value>1</value>
                </mapEntry>
              </metadata>            
            </transfer>
            <transfer>
              <idTransfer>2</idTransfer>
              <transferAmount>10.00</transferAmount>
              <fiscalCodePA>77777777778</fiscalCodePA>
              <IBAN>IT0000000000000000000000001</IBAN>
              <remittanceInformation>remittanceInformation2</remittanceInformation>
              <transferCategory>0201102IM</transferCategory>
            </transfer>
          </transferList>
          <idPSP>88888888888</idPSP>
          <pspFiscalCode>88888888888</pspFiscalCode>
          <pspPartitaIVA>88888888888</pspPartitaIVA>
          <PSPCompanyName>PSP name</PSPCompanyName>
          <idChannel>88888888888_01</idChannel>
          <channelDescription>app</channelDescription>
          <payer>
            <uniqueIdentifier>
              <entityUniqueIdentifierType>F</entityUniqueIdentifierType>
              <entityUniqueIdentifierValue>JHNDOE00A01F205N</entityUniqueIdentifierValue>
            </uniqueIdentifier>
            <fullName>John Doe</fullName>
            <streetName>street</streetName>
            <civicNumber>12</civicNumber>
            <postalCode>89020</postalCode>
            <city>city</city>
            <stateProvinceRegion>MI</stateProvinceRegion>
            <country>IT</country>
            <e-mail>john.doe@test.it</e-mail>
          </payer>
          <paymentMethod>creditCard</paymentMethod>
          <fee>2.00</fee>
          <paymentDateTime>2021-10-01T17:48:22</paymentDateTime>
          <applicationDate>2021-10-01</applicationDate>
          <transferDate>2021-10-02</transferDate>
          <metadata>
            <mapEntry>
              <key>keytest</key>
              <value>1</value>
            </mapEntry>
          </metadata>
        </receipt>
      </pafn:paSendRTReq>
    </soapenv:Body>
  </soapenv:Envelope>
<soapenv:Envelope>
  <soapenv:Body>
    <paf:paSendRTRes>
      <outcome>OK</outcome>
    </paf:paSendRTRes>
  </soapenv:Body>
</soapenv:Envelope>
  • outcome﹡: il risultato dell'operazione che può contenere i seguenti codici

    • OK : operazione eseguita con successo

    • KO : operazione terminata con errore

verifyPaymentNotice

POST

Request Body

Name
Type
Description

idPSP*

String

Identificativo del PSP, assegnato da PagoPA.

Il codice è generalmente rappresentato dal codice BIC (Bank Identifier Code) del PSP.

In assenza del codice BIC, o per gestire situazioni particolari, può essere utilizzato un altro codice, purché identifichi in modo univoco il PSP.

idBrokerPSP*

String

Identificativo dell'intermediario, assegnato da PagoPA.

Identificazione dell'intermediario/broker del PSP che fornisce l'accesso (canale) al PSP per l'erogazione del servizio.

Nota: l'intermediario/broker può coincidere con il PSP stesso.

idChannel*

String

Identificativo del canale, identifica una categoria di servizio di pagamento e attraverso la quale viene effettuata la transazione.

Un identificatore di canale appartiene a un solo intermediario/broker PSP e di conseguenza deve essere univoco rispetto al PSP.

qrCode*

String

è composto da fiscalCode e noticeNumber.

fiscalCode*

String

codice fiscale dell'EC.

noticeNumber*

String

[auxDigit][segregationCode][IUVBase][IUVCheckDigit]

password*

String

Password del canale, assegnata da PagoPA.

  <soapenv:Envelope>
    <soapenv:Body>
      <nod:verifyPaymentNoticeReq>
        <idPSP>88888888888</idPSP>
        <idBrokerPSP>88888888888</idBrokerPSP>
        <idChannel>88888888888_01</idChannel>
        <password>**********</password>
        <qrCode>
          <fiscalCode>77777777777</fiscalCode>
          <noticeNumber>311111111112222222</noticeNumber>
        </qrCode>
      </nod:verifyPaymentNoticeReq>
    </soapenv:Body>
  </soapenv:Envelope>
<soapenv:Envelope>
  <soapenv:Body>
    <nfpsp:verifyPaymentNoticeRes>
      <outcome>OK</outcome>
      <paymentList>
        <paymentOptionDescription>
          <amount>30.00</amount>
          <options>EQ</options>
          <paymentNote>test</paymentNote>
        </paymentOptionDescription>
      </paymentList>
      <paymentDescription>payment</paymentDescription>
      <fiscalCodePA>77777777777</fiscalCodePA>
      <companyName>company EC</companyName>
      <officeName>office EC</officeName>
    </nfpsp:verifyPaymentNoticeRes>
  </soapenv:Body>
</soapenv:Envelope> 
  • outcome﹡: il risultato dell'operazione che può contenere i seguenti codici

    • OK : operazione eseguita con successo

    • KO : operazione terminata con errore

  • paymentList: struttura che contiene i dettagli del pagamento, al momento può contenere una sola paymentOptionDescription, dato valorizzato solo in caso di outcome OK

    • paymentOptionDescription﹡

      • amount﹡: importo in euro

      • options﹡: al momento è valorizzato con EQ

      • dueDate: data di scadenza del pagamento secondo il formato ISO 8601 [AAAA]-[MM]-[GG]

      • paymentNote: testo libero per descrivere l'oggetto del pagamento

  • paymentDescription: testo libero per descrivere l'oggetto del pagamento, dato valorizzato solo in caso di outcome OK

  • fiscalCodePA: codice fiscale dell'EC, dato valorizzato solo in caso di outcome OK

  • companyName: nome completo dell'EC, dato valorizzato solo in caso di outcome OK

  • officeName: nome completo dell'ufficio dell'EC

verificaBollettino

POST

Request Body

Name
Type
Description

idPSP*

String

Identificativo del PSP, assegnato da PagoPA.

Il codice è generalmente rappresentato dal codice BIC (Bank Identifier Code) del PSP.

In assenza del codice BIC, o per gestire situazioni particolari, può essere utilizzato un altro codice, purché identifichi in modo univoco il PSP.

idBrokerPSP*

String

Identificativo dell'intermediario, assegnato da PagoPA.

Identificazione dell'intermediario/broker del PSP che fornisce l'accesso (canale) al PSP per l'erogazione del servizio.

Nota: l'intermediario/broker può coincidere con il PSP stesso.

idChannel*

String

Identificativo del canale, identifica una categoria di servizio di pagamento e attraverso la quale viene effettuata la transazione.

Un identificatore di canale appartiene a un solo intermediario/broker PSP e di conseguenza deve essere univoco rispetto al PSP.

ccPost*

String

conto corrente postale dell'EC.

noticeNumber*

String

[auxDigit][segregationCode][IUVBase][IUVCheckDigit]

password*

String

Password del canale, assegnata da PagoPA.

  <soapenv:Envelope>
    <soapenv:Body>
      <nod:verificaBollettinoReq>
        <idPSP>88888888888</idPSP>
        <idBrokerPSP>88888888888</idBrokerPSP>
        <idChannel>88888888888_01</idChannel>
        <password>**********</password>
        <ccPost>012345678912</ccPost>
        <noticeNumber>311111111112222222</noticeNumber>
      </nod:verificaBollettinoReq>
    </soapenv:Body>
  </soapenv:Envelope>
<soapenv:Envelope>
  <soapenv:Body>
    <nfpsp:verificaBollettinoRes>
      <outcome>OK</outcome>
      <paymentBollettinoList>
        <paymentOptionDescription>
          <amount>30.00</amount>
          <options>EQ</options>
          <dueDate>2021-12-31</dueDate>
          <paymentNote>test</paymentNote>
          <allCCP>true</allCCP>
        </paymentOptionDescription>
      </paymentBollettinoList>
      <paymentDescription>payment</paymentDescription>
      <fiscalCodePA>77777777777</fiscalCodePA>
      <noticeNumber>311111111112222222</noticeNumber>
      <companyName>company EC</companyName>
      <officeName>office EC</officeName>
    </nfpsp:verificaBollettinoRes>
  </soapenv:Body>
</soapenv:Envelope>
  • outcome﹡: il risultato dell'operazione che può contenere i seguenti codici

    • OK : operazione eseguita con successo

    • KO : operazione terminata con errore

  • paymentBollettinoList: struttura che contiene i dettagli del pagamento, al momento può contenere una sola paymentOptionDescription, dato valorizzato solo in caso di outcome OK, dato valorizzato solo in caso di outcome OK

    • paymentOptionDescription﹡

      • amount﹡: importo in euro

      • options﹡: al momento è valorizzato con EQ

      • dueDate: data di scadenza del pagamento secondo il formato ISO 8601 [AAAA]-[MM]-[GG]

      • paymentNote: testo libero per descrivere l'oggetto del pagamento

      • allCCP﹡: se TRUE indica che tutti i bonifici sono associabili a IBAN postali

  • paymentDescription: testo libero per descrivere l'oggetto del pagamento

  • fiscalCodePA: codice fiscale dell'EC, dato valorizzato solo in caso di outcome OK

  • noticeNumber: [auxDigit][segregationCode][IUVBase][IUVCheckDigit], dato valorizzato solo in caso di outcome OK

  • companyName: nome completo dell'EC, dato valorizzato solo in caso di outcome OK

  • officeName: nome completo dell'ufficio dell'EC

activatePaymentNotice

activatePaymentNotice versione 1

POST

Request Body

Name
Type
Description

idPSP*

String

Identificativo del PSP, assegnato da PagoPA.

Il codice è generalmente rappresentato dal codice BIC (Bank Identifier Code) del PSP.

In assenza del codice BIC, o per gestire situazioni particolari, può essere utilizzato un altro codice, purché identifichi in modo univoco il PSP.

idBrokerPSP*

String

Identificativo dell'intermediario, assegnato da PagoPA.

Identificazione dell'intermediario/broker del PSP che fornisce l'accesso (canale) al PSP per l'erogazione del servizio.

Nota: l'intermediario/broker può coincidere con il PSP stesso.

idChannel*

String

Identificativo del canale, identifica una categoria di servizio di pagamento e attraverso la quale viene effettuata la transazione.

Un identificatore di canale appartiene a un solo intermediario/broker PSP e di conseguenza deve essere univoco rispetto al PSP.

qrCode*

String

E' composto da fiscalCode e noticeNumber.

fiscalCode*

String

Codice fiscale dell'EC.

noticeNumber*

String

[auxDigit][segregationCode][IUVBase][IUVCheckDigit]

password*

String

Password del canale, assegnata da PagoPA.

idempotencyKey

Chiave di idempotenza

expirationTime

String

Tempo di scadenza del token ( ms ), max 30 minuti.

La durata del token di pagamento può essere impostata in 2 modi:

- Implicitamente dalla piattaforma pagoPA, se non è impostato nella richiesta di activatePaymentNotice (valore di default durata = 30 minuti)

- Esplicitamente dal PSP, se impostato in richiesta all'activatePaymentNotice

paymentNote

String

Testo libero per descrivere l'oggetto del pagamento

dueDate

String

data di scadenza del pagamento secondo il formato ISO 8601 [AAAA]-[MM]-[GG]

amount*

String

Importo in euro

  <soapenv:Envelope>
    <soapenv:Body>
      <nod:activatePaymentNoticeReq>
        <idPSP>88888888888</idPSP>
        <idBrokerPSP>88888888888</idBrokerPSP>
        <idChannel>88888888888_01</idChannel>
        <password>**********</password>
        <idempotencyKey>70000000001_100149bdWB</idempotencyKey>
        <qrCode>
          <fiscalCode>77777777777</fiscalCode>
          <noticeNumber>311111111112222222</noticeNumber>
        </qrCode>
        <expirationTime>6000</expirationTime>
        <amount>30.00</amount>
      </nod:activatePaymentNoticeReq>
    </soapenv:Body>
  </soapenv:Envelope>
<soapenv:Envelope>
  <soapenv:Body>
    <nfpsp:activatePaymentNoticeRes>
      <outcome>OK</outcome>
      <totalAmount>30.00</totalAmount>
      <paymentDescription>test</paymentDescription>
      <fiscalCodePA>77777777777</fiscalCodePA>
      <companyName>company EC</companyName>
      <officeName>office EC</officeName>
      <paymentToken>c110729d258c4ab1b765fe902aae41d6</paymentToken>
      <transferList>
        <transfer>
          <idTransfer>1</idTransfer>
          <transferAmount>20.00</transferAmount>
          <fiscalCodePA>77777777777</fiscalCodePA>
          <IBAN>IT0000000000000000000000000</IBAN>
          <remittanceInformation>remittanceInformation1</remittanceInformation>
        </transfer>
        <transfer>
          <idTransfer>2</idTransfer>
          <transferAmount>10.00</transferAmount>
          <fiscalCodePA>77777777778</fiscalCodePA>
          <IBAN>IT0000000000000000000000001</IBAN>
          <remittanceInformation>remittanceInformation2</remittanceInformation>
        </transfer>
      </transferList>
      <creditorReferenceId>11111111112222222</creditorReferenceId>
    </nfpsp:activatePaymentNoticeRes>
  </soapenv:Body>
</soapenv:Envelope>
  • outcome﹡: il risultato dell'operazione che può contenere i seguenti codici

    • OK : operazione eseguita con successo

    • KO : operazione terminata con errore

  • totalAmount: rappresenta la somma degli importi dei singoli transfer, dato valorizzato solo in caso di outcome OK

  • paymentDescription: testo libero per descrivere l'oggetto del pagamento, dato valorizzato solo in caso di outcome OK

  • fiscalCodePA: codice fiscale dell'EC, dato valorizzato solo in caso di outcome OK

  • companyName: nome completo dell'EC, dato valorizzato solo in caso di outcome OK

  • officeName: nome completo dell'ufficio dell'EC

  • paymentToken: viene generato dal sistema durante la fase di attivazione del pagamento, è l'identificatore di correlazione da abbinare all'attivazione e all'esito del pagamento, dato valorizzato solo in caso di outcome OK

  • transferList: struttura che contiene i dettagli dei transfer pagamento, al momento i transfer possono essere al massimo 5, dato valorizzato solo in caso di outcome OK

    • transfer﹡

      • idTransfer﹡: valori ammessi da 1 a 5

      • transferAmount﹡: importo in euro

      • fiscalCodePA﹡: al momento è valorizzato con EQ

      • IBAN﹡: IBAN sul quale verra riversata l'importo

      • remittanceInformation﹡: testo libero per descrivere l'oggetto del pagamento

  • creditorReferenceId: IUV Identificativo Univoco Versamento, dato valorizzato solo in caso di outcome OK

activatePaymentNotice versione 2

POST

In questa versione è possibile inserire i metadata in ogni singolo transfer.

Request Body

Name
Type
Description

idPSP*

String

Identificativo del PSP, assegnato da PagoPA.

Il codice è generalmente rappresentato dal codice BIC (Bank Identifier Code) del PSP.

In assenza del codice BIC, o per gestire situazioni particolari, può essere utilizzato un altro codice, purché identifichi in modo univoco il PSP.

idBrokerPSP*

String

Identificativo dell'intermediario, assegnato da PagoPA.

Identificazione dell'intermediario/broker del PSP che fornisce l'accesso (canale) al PSP per l'erogazione del servizio.

Nota: l'intermediario/broker può coincidere con il PSP stesso.

idChannel*

String

Identificativo del canale, identifica una categoria di servizio di pagamento e attraverso la quale viene effettuata la transazione.

Un identificatore di canale appartiene a un solo intermediario/broker PSP e di conseguenza deve essere univoco rispetto al PSP.

qrCode*

String

E' composto da fiscalCode e noticeNumber.

fiscalCode*

String

Codice fiscale dell'EC.

noticeNumber*

String

[auxDigit][segregationCode][IUVBase][IUVCheckDigit]

password*

String

Password del canale, assegnata da PagoPA.

idempotencyKey

Chiave di idempotenza

expirationTime

String

Tempo di scadenza del token ( ms ), max 30 minuti.

La durata del token di pagamento può essere impostata in 2 modi:

- Implicitamente dalla piattaforma pagoPA, se non è impostato nella richiesta di activatePaymentNotice (valore di default durata = 30 minuti)

- Esplicitamente dal PSP, se impostato in richiesta all'activatePaymentNotice

paymentNote

String

Testo libero per descrivere l'oggetto del pagamento

dueDate

String

data di scadenza del pagamento secondo il formato ISO 8601 [AAAA]-[MM]-[GG]

amount*

String

Importo in euro

  <soapenv:Envelope>
    <soapenv:Body>
      <nod:activatePaymentNoticeReq>
        <idPSP>88888888888</idPSP>
        <idBrokerPSP>88888888888</idBrokerPSP>
        <idChannel>88888888888_01</idChannel>
        <password>**********</password>
        <idempotencyKey>70000000001_100149bdWB</idempotencyKey>
        <qrCode>
          <fiscalCode>77777777777</fiscalCode>
          <noticeNumber>311111111112222222</noticeNumber>
        </qrCode>
        <expirationTime>6000</expirationTime>
        <amount>30.00</amount>
      </nod:activatePaymentNoticeReq>
    </soapenv:Body>
  </soapenv:Envelope>
<soapenv:Envelope>
  <soapenv:Body>
    <nfpsp:activatePaymentNoticeRes>
      <outcome>OK</outcome>
      <totalAmount>30.00</totalAmount>
      <paymentDescription>test</paymentDescription>
      <fiscalCodePA>77777777777</fiscalCodePA>
      <companyName>company EC</companyName>
      <officeName>office EC</officeName>
      <paymentToken>c110729d258c4ab1b765fe902aae41d6</paymentToken>
      <transferList>
        <transfer>
          <idTransfer>1</idTransfer>
          <transferAmount>20.00</transferAmount>
          <fiscalCodePA>77777777777</fiscalCodePA>
          <IBAN>IT0000000000000000000000000</IBAN>
          <remittanceInformation>remittanceInformation1</remittanceInformation>
          <metadata>
            <mapEntry>
              <key>keytest</key>
              <value>1</value>
            </mapEntry>
          </metadata>        
        </transfer>
        <transfer>
          <idTransfer>2</idTransfer>
          <transferAmount>10.00</transferAmount>
          <fiscalCodePA>77777777778</fiscalCodePA>
          <IBAN>IT0000000000000000000000001</IBAN>
          <remittanceInformation>remittanceInformation2</remittanceInformation>
        </transfer>
      </transferList>
      <creditorReferenceId>11111111112222222</creditorReferenceId>
    </nfpsp:activatePaymentNoticeRes>
  </soapenv:Body>
</soapenv:Envelope>
  • outcome﹡: il risultato dell'operazione che può contenere i seguenti codici

    • OK : operazione eseguita con successo

    • KO : operazione terminata con errore

  • totalAmount: rappresenta la somma degli importi dei singoli transfer, dato valorizzato solo in caso di outcome OK

  • paymentDescription: testo libero per descrivere l'oggetto del pagamento, dato valorizzato solo in caso di outcome OK

  • fiscalCodePA: codice fiscale dell'EC, dato valorizzato solo in caso di outcome OK

  • companyName: nome completo dell'EC, dato valorizzato solo in caso di outcome OK

  • officeName: nome completo dell'ufficio dell'EC

  • paymentToken: viene generato dal sistema durante la fase di attivazione del pagamento, è l'identificatore di correlazione da abbinare all'attivazione e all'esito del pagamento, dato valorizzato solo in caso di outcome OK

  • transferList: struttura che contiene i dettagli dei transfer pagamento, al momento i transfer possono essere al massimo 5, dato valorizzato solo in caso di outcome OK

    • transfer﹡

      • idTransfer﹡: valori ammessi da 1 a 5

      • transferAmount﹡: importo in euro

      • fiscalCodePA﹡: al momento è valorizzato con EQ

      • IBAN﹡: IBAN sul quale verra riversata l'importo

      • remittanceInformation﹡: testo libero per descrivere l'oggetto del pagamento

      • metadata: è un campo di archiviazione chiave/valore.

        • mapEntry﹡

          • key﹡

          • value﹡

  • creditorReferenceId: IUV Identificativo Univoco Versamento, dato valorizzato solo in caso di outcome OK

sendPaymentOutcome

sendPaymentOutcome versione 1

POST

Request Body

Name
Type
Description

idPSP*

String

identificativo del PSP, assegnato da PagoPA.

Il codice è generalmente rappresentato dal codice BIC (Bank Identifier Code) del PSP.

In assenza del codice BIC, o per gestire situazioni particolari, può essere utilizzato un altro codice, purché identifichi in modo univoco il PSP.

details

String

Dettagli del risultato dell'operazione, da inserire obbligatoriamente in caso di outcome OK

outcome*

String

Il risultato dell'operazione che può contenere i seguenti codici

OK : operazione eseguita con successo

KO : operazione terminata con errore

paymentToken*

String

Viene generato dal sistema durante la fase di attivazione del pagamento, è l'identificatore di correlazione da abbinare all'attivazione e all'esito del pagamento.

password*

String

Password del canale, assegnata da PagoPA.

idChannel*

String

identificativo del canale, identifica una categoria di servizio di pagamento e attraverso la quale viene effettuata la transazione.

Un identificatore di canale appartiene a un solo intermediario/broker PSP e di conseguenza deve essere univoco rispetto al PSP.

idBrokerPSP*

String

identificativo dell'intermediario, assegnato da PagoPA.

Identificazione dell'intermediario/broker del PSP che fornisce l'accesso (canale) al PSP per l'erogazione del servizio.

Nota: l'intermediario/broker può coincidere con il PSP stesso.

payer

String

individua il pagatore

fee*

String

importo della commissione pagata in euro

paymentChannel

String

canale di pagamento

enum: "frontOffice" "atm" "onLine" "app" "other"

paymentMethod*

String

metodo di pagamento

enum: "cash" "creditCard" "bancomat" "other"

transferDate*

String

data del riversamento verso l'EC

applicationDate*

String

data applicativa del pagamento

e-mail

String

country

String

stateProvinceRegion

String

city

String

postalCode

String

civicNumber

String

streetName

String

fullName*

String

nome completo del pagatore

uniqueIdentifier*

String

entityUniqueIdentifierValue*

String

codice fiscale o partita IVA

entityUniqueIdentifierType*

String

F : Persona fisica

G : Persona giuridica

idempotencyKey

String

Chiave di idempotenza.

  <soapenv:Envelope>
    <soapenv:Body>
        <nod:sendPaymentOutcomeReq>
          <idPSP>88888888888</idPSP>
          <idBrokerPSP>88888888888</idBrokerPSP>
          <idChannel>88888888888_01</idChannel>
          <password>**********</password>
          <idempotencyKey>70000000001_100149bdWB</idempotencyKe
          <paymentToken>c110729d258c4ab1b765fe902aae41d6</paymentToken>
          <outcome>OK</outcome>
          <details>
              <paymentMethod>creditCard</paymentMethod>
              <paymentChannel>app</paymentChannel>
              <fee>2.00</fee>
              <payer>
                <uniqueIdentifier>
                    <entityUniqueIdentifierType>F</entityUniqueIdentifierType>
                    <entityUniqueIdentifierValue>JHNDOE00A01F205N</entityUniqueIdentifierValue>
                </uniqueIdentifier>
                <fullName>John Doe</fullName>
                <streetName>street</streetName>
                <civicNumber>12</civicNumber>
                <postalCode>89020</postalCode>
                <city>city</city>
                <stateProvinceRegion>MI</stateProvinceRegion>
                <country>IT</country>
                <e-mail>john.doe@test.it</e-mail>
              </payer>
              <applicationDate>2021-10-01</applicationDate>
              <transferDate>2021-10-02</transferDate>
          </details>
        </nod:sendPaymentOutcomeReq>
    </soapenv:Body>
  </soapenv:Envelope>
<soapenv:Envelope>
  <soapenv:Body>
    <nfpsp:sendPaymentOutcomeRes>
      <outcome>OK</outcome>
    </nfpsp:sendPaymentOutcomeRes>
  </soapenv:Body>
</soapenv:Envelope>
  • outcome﹡: il risultato dell'operazione che può contenere i seguenti codici

    • OK : operazione eseguita con successo

    • KO : operazione terminata con errore

sendPaymentOutcome versione 2

POST

Utilizzata per il pagamento attivato presso il frontend dell'EC, rispetto alla versione 1 permette di inviare l'outcome di più payment tokens contemporaneamente.

Request Body

Name
Type
Description

idPSP*

String

Identificativo del PSP, assegnato da PagoPA.

Il codice è generalmente rappresentato dal codice BIC (Bank Identifier Code) del PSP.

In assenza del codice BIC, o per gestire situazioni particolari, può essere utilizzato un altro codice, purché identifichi in modo univoco il PSP.

details

String

dettagli del risultato dell'operazione, da inserire obbligatoriamente in caso di outcome OK

outcome*

String

il risultato dell'operazione che può contenere i seguenti codici

OK : operazione eseguita con successo

KO : operazione terminata con errore

paymentToken*

String

viene generato dal sistema durante la fase di attivazione del pagamento, è l'identificatore di correlazione da abbinare all'attivazione e all'esito del pagamento

password*

String

Password del canale, assegnata da PagoPA.

idChannel*

String

Identificativo del canale, identifica una categoria di servizio di pagamento e attraverso la quale viene effettuata la transazione.

Un identificatore di canale appartiene a un solo intermediario/broker PSP e di conseguenza deve essere univoco rispetto al PSP.

idBrokerPSP*

String

Identificativo dell'intermediario, assegnato da PagoPA.

Identificazione dell'intermediario/broker del PSP che fornisce l'accesso (canale) al PSP per l'erogazione del servizio.

Nota: l'intermediario/broker può coincidere con il PSP stesso.

payer

String

individua il pagatore

fee*

String

importo della commissione pagata in euro

paymentChannel

String

canale di pagamento

enum: "frontOffice" "atm" "onLine" "app" "other"

paymentMethod*

String

metodo di pagamento

enum: "cash" "creditCard" "bancomat" "other"

transferDate*

String

data del riversamento verso l'EC

applicationDate*

String

data applicativa del pagamento

e-mail

String

country

String

stateProvinceRegion

String

city

String

postalCode

String

civicNumber

String

streetName

String

fullName*

String

nome completo del pagatore

uniqueIdentifier*

String

entityUniqueIdentifierValue*

String

codice fiscale o partita IVA

entityUniqueIdentifierType*

String

F : Persona fisica

G : Persona giuridica

paymentTokens*

String

sequence che contiene tutti i tokens

idempotencyKey

String

Chiave di idempotenza

  <soapenv:Envelope>
    <soapenv:Body>
        <nod:sendPaymentOutcomeReq>
          <idPSP>88888888888</idPSP>
          <idBrokerPSP>88888888888</idBrokerPSP>
          <idChannel>88888888888_01</idChannel>
          <password>**********</password>
          <idempotencyKey>70000000001_100149bdWB</idempotencyKe
          <paymentTokens>
              <paymentToken>d221820d258c4ab1b765fe902aae6d14</paymentToken>
              <paymentToken>c110729d258c4ab1b765fe902aae41d6</paymentToken>
          </paymentTokens>
          <outcome>OK</outcome>
          <details>
              <paymentMethod>creditCard</paymentMethod>
              <paymentChannel>app</paymentChannel>
              <fee>2.00</fee>
              <payer>
                <uniqueIdentifier>
                    <entityUniqueIdentifierType>F</entityUniqueIdentifierType>
                    <entityUniqueIdentifierValue>JHNDOE00A01F205N</entityUniqueIdentifierValue>
                </uniqueIdentifier>
                <fullName>John Doe</fullName>
                <streetName>street</streetName>
                <civicNumber>12</civicNumber>
                <postalCode>89020</postalCode>
                <city>city</city>
                <stateProvinceRegion>MI</stateProvinceRegion>
                <country>IT</country>
                <e-mail>john.doe@test.it</e-mail>
              </payer>
              <applicationDate>2021-10-01</applicationDate>
              <transferDate>2021-10-02</transferDate>
          </details>
        </nod:sendPaymentOutcomeReq>
    </soapenv:Body>
  </soapenv:Envelope>
<soapenv:Envelope>
  <soapenv:Body>
    <nfpsp:sendPaymentOutcomeRes>
      <outcome>OK</outcome>
    </nfpsp:sendPaymentOutcomeRes>
  </soapenv:Body>
</soapenv:Envelope>
  • outcome﹡: il risultato dell'operazione che può contenere i seguenti codici

    • OK : operazione eseguita con successo

    • KO : operazione terminata con errore

pspNotifyPayment

pspNotifyPayment versione 1

POST

Request Body

Name
Type
Description

fiscalCodePA

String

Codice fiscale dell'EC.

paymentToken*

String

Viene generato dal sistema durante la fase di attivazione del pagamento, è l'identificatore di correlazione da abbinare all'attivazione e all'esito del pagamento.

idPSP*

String

Identificativo del PSP, assegnato da PagoPA.

Il codice è generalmente rappresentato dal codice BIC (Bank Identifier Code) del PSP.

In assenza del codice BIC, o per gestire situazioni particolari, può essere utilizzato un altro codice, purché identifichi in modo univoco il PSP.

idChannel*

String

Identificativo del canale, identifica una categoria di servizio di pagamento e attraverso la quale viene effettuata la transazione.

Un identificatore di canale appartiene a un solo intermediario/broker PSP e di conseguenza deve essere univoco rispetto al PSP.

creditorReferenceId*

String

IUV Identificativo Univoco Versamento.

companyName*

String

Nome completo dell'EC.

officeName

String

Nome completo dell'ufficio dell'EC.

idBrokerPSP*

String

Identificativo dell'intermediario, assegnato da PagoPA.

Identificazione dell'intermediario/broker del PSP che fornisce l'accesso (canale) al PSP per l'erogazione del servizio.

Nota: l'intermediario/broker può coincidere con il PSP stesso.

debtAmount*

String

Rappresenta la somma degli importi dei singoli transfer.

paymentDescription*

String

Testo libero per descrivere l'oggetto del pagamento.

remittanceInformation*

String

Motivo del pagamento.

IBAN*

String

IBAN sul quale sarà effettuato il riversamento

fiscalCodePA*

String

Codice fiscale dell'EC.

transferAmount*

String

Importo

idTransfer*

String

Indice della lista (da 1 a 5).

transfer*

String

transferList*

String

Struttura che contiene i dettagli dei transfer pagamento, al momento i transfer possono essere al massimo 5.

dati specifici del canale di pagamento

String

Struttura dati specifica del canale di pagamento utilizzato.

    <soapenv:Envelope>
      <soapenv:Body>
          <pspfn:pspNotifyPaymentReq>
            <idPSP>88888888888</idPSP>
            <idBrokerPSP>88888888888</idBrokerPSP>
            <idChannel>88888888888_01</idChannel>
            <paymentDescription>test</paymentDescription>
            <fiscalCodePA>77777777777</fiscalCodePA>
            <companyName>company EC</companyName>
            <officeName>office EC</officeName>                        
            <paymentToken>ac6536ab9967401fb6cfa98bef88ccf0</paymentToken>
            <creditorReferenceId>11111111112222222</creditorReferenceId>
            <debtAmount>30.00</debtAmount>
            <transferList>
                <transfer>
                  <idTransfer>1</idTransfer>
                  <transferAmount>20.00</transferAmount>
                  <fiscalCodePA>77777777777</fiscalCodePA>
                  <IBAN>IT0000000000000000000000000</IBAN>
                  <remittanceInformation>info remittance</remittanceInformation>
                </transfer>
                <transfer>
                  <idTransfer>2</idTransfer>
                  <transferAmount>10.00</transferAmount>
                  <fiscalCodePA>77777777778</fiscalCodePA>
                  <IBAN>IT0000000000000000000000001</IBAN>
                  <remittanceInformation>info remittance</remittanceInformation>
                </transfer>
            </transferList>
            
            <!-- dati specifici del canale di pagamento -->
            
          </pspfn:pspNotifyPaymentReq>
      </soapenv:Body>
    </soapenv:Envelope>
<soapenv:Envelope>
  <soapenv:Body>
      <psp:pspNotifyPaymentRes>
        <outcome>OK</outcome>
      </psp:pspNotifyPaymentRes>
  </soapenv:Body>
</soapenv:Envelope>
  • outcome﹡: il risultato dell'operazione che può contenere i seguenti codici

    • OK : operazione eseguita con successo

    • KO : operazione terminata con errore

Carta di credito

<creditCardPayment>
    <rrn>11223344</rrn>
    <outcomePaymentGateway>00</outcomePaymentGateway>
    <totalAmount>31.00</totalAmount>
    <fee>1.00</fee>
    <timestampOperation>2021-07-09T17:06:03</timestampOperation>
    <authorizationCode>123456</authorizationCode>
</creditCardPayment>

Paypal

<paypalPayment> 
    <transactionId>11223344</transactionId>
    <pspTransactionId>00</pspTransactionId>
    <totalAmount>31.00</totalAmount>
    <fee>1.00</fee>
    <timestampOperation>2021-07-09T17:06:03</timestampOperation>
</paypalPayment>

Bancomat Pay

<bancomatpayPayment> 
    <transactionId>11223344</transactionId>
    <outcomePaymentGateway>00</outcomePaymentGateway>
    <totalAmount>31.00</totalAmount>
    <fee>1.00</fee>
    <timestampOperation>2021-07-09T17:06:03</timestampOperation>
    <authorizationCode>123456</authorizationCode>
    <paymentGateway></paymentGateway>
</bancomatpayPayment>

Altri canali di pagamento

<additionalPaymentInformations> 
    <metadata>
        <mapEntry>
            <key>keytest</key>
            <value>1</value>
        </mapEntry>
    </metadata> 
</additionalPaymentInformations>

pspNotifyPayment versione 2

POST

Utilizzata per il pagamento attivato presso il frontend dell'EC, rispetto alla precedente versione della pspNotifyPayment permette di inviare al PSP una lista di payment, inoltre, le informazioni specifiche del pagamento utilizzato sono inserite nella sezione additionalPaymentInformations che contiene una lista di metadata.

Request Body

Name
Type
Description

fiscalCodePA

String

Codice fiscale dell'EC.

paymentToken*

String

Viene generato dal sistema durante la fase di attivazione del pagamento, è l'identificatore di correlazione da abbinare all'attivazione e all'esito del pagamento.

idPSP*

String

Identificativo del PSP, assegnato da PagoPA.

Il codice è generalmente rappresentato dal codice BIC (Bank Identifier Code) del PSP.

In assenza del codice BIC, o per gestire situazioni particolari, può essere utilizzato un altro codice, purché identifichi in modo univoco il PSP.

idChannel*

String

Identificativo del canale, identifica una categoria di servizio di pagamento e attraverso la quale viene effettuata la transazione.

Un identificatore di canale appartiene a un solo intermediario/broker PSP e di conseguenza deve essere univoco rispetto al PSP.

creditorReferenceId*

String

IUV Identificativo Univoco Versamento.

companyName*

String

Nome completo dell'EC.

officeName

String

Nome completo dell'ufficio dell'EC.

idBrokerPSP*

String

Identificativo dell'intermediario, assegnato da PagoPA.

Identificazione dell'intermediario/broker del PSP che fornisce l'accesso (canale) al PSP per l'erogazione del servizio.

Nota: l'intermediario/broker può coincidere con il PSP stesso.

debtAmount*

String

Rappresenta la somma degli importi dei singoli transfer.

paymentDescription*

String

Testo libero per descrivere l'oggetto del pagamento.

remittanceInformation*

String

Motivo del pagamento.

IBAN*

String

IBAN sul quale sarà effettuato il riversamento

fiscalCodePA*

String

Codice fiscale dell'EC.

transferAmount*

String

Importo

idTransfer*

String

Indice della lista (da 1 a 5).

transfer*

String

transferList*

String

Struttura che contiene i dettagli dei transfer pagamento, al momento i transfer possono essere al massimo 5.

payment

String

paymentList

String

Lista dei pagamenti.

additionalPaymentInformations

String

Struttura che contiene i dati specifici del canale di pagamento utilizzato.

metadata*

String

mapEntry*

String

key*

String

value*

String

<soapenv:Envelope>
      <soapenv:Body>
          <pspfn:pspNotifyPaymentReq>
            <idPSP>CIPBITMM</idPSP>
            <idBrokerPSP>13212880150</idBrokerPSP>
            <idChannel>13212880150_02</idChannel>
            <paymentList>
              <payment>
                <paymentDescription>test</paymentDescription>
                <fiscalCodePA>77777777777</fiscalCodePA>
                <companyName>company EC</companyName>
                <officeName>office EC</officeName>                        
                <paymentToken>ac6536ab9967401fb6cfa98bef88ccf0</paymentToken>
                <creditorReferenceId>11111111112222222</creditorReferenceId>
                <debtAmount>30.00</debtAmount>
                <transferList>
                  <transfer>
                    <idTransfer>1</idTransfer>
                    <transferAmount>20.00</transferAmount>
                    <fiscalCodePA>77777777777</fiscalCodePA>
                    <IBAN>IT0000000000000000000000000</IBAN>
                    <remittanceInformation>info remittance</remittanceInformation>
                  </transfer>
                  <transfer>
                    <idTransfer>2</idTransfer>
                    <transferAmount>10.00</transferAmount>
                    <fiscalCodePA>77777777778</fiscalCodePA>
                    <IBAN>IT0000000000000000000000001</IBAN>
                    <remittanceInformation>info remittance</remittanceInformation>
                  </transfer>
                </transferList> 
              </payment>
            </paymentList>                       
            <additionalPaymentInformations>
              <metadata>
                <mapEntry>
                  <key>xxxx</key>
                  <value>1234546</value>
                </mapEntry> 
              </metadata>
            </additionalPaymentInformations>
          </pspfn:pspNotifyPaymentReq>
      </soapenv:Body>
    </soapenv:Envelope>    
<soapenv:Envelope>
  <soapenv:Body>
      <psp:pspNotifyPaymentRes>
        <outcome>OK</outcome>
      </psp:pspNotifyPaymentRes>
  </soapenv:Body>
</soapenv:Envelope>
  • outcome﹡: il risultato dell'operazione che può contenere i seguenti codici

    • OK : operazione eseguita con successo

    • KO : operazione terminata con errore

demandPaymentNotice

POST

Request Body

Name
Type
Description

idPSP*

String

Identificativo del PSP, assegnato da PagoPA.

Il codice è generalmente rappresentato dal codice BIC (Bank Identifier Code) del PSP.

In assenza del codice BIC, o per gestire situazioni particolari, può essere utilizzato un altro codice, purché identifichi in modo univoco il PSP.

datiSpecificiServizio*

String

Sono censiti nel Catalogo dei Servizi, che è il repository che contiene l’elenco dei servizi generalizzati attivati dagli EC, inviati in formato base64.

idServizio*

String

Identificativo del servizio per cui si vuole attivare il pagamento.

password*

String

Password del canale, assegnata da PagoPA.

idChannel*

String

Identificativo del canale, identifica una categoria di servizio di pagamento e attraverso la quale viene effettuata la transazione.

Un identificatore di canale appartiene a un solo intermediario/broker PSP e di conseguenza deve essere univoco rispetto al PSP.

idBrokerPSP*

String

Identificativo dell'intermediario, assegnato da PagoPA.

Identificazione dell'intermediario/broker del PSP che fornisce l'accesso (canale) al PSP per l'erogazione del servizio.

Nota: l'intermediario/broker può coincidere con il PSP stesso.

<soap:Envelope>
  <soap:Body>
    <ns3:demandPaymentNoticeReq>
      <idPSP>88888888888</idPSP>
      <idBrokerPSP>88888888888</idBrokerPSP>
      <idChannel>88888888888_01</idChannel>
      <password>**********</password>
      <idServizio>001001002</idServizio> //identifica la codifica sul DB pagoPA per poter estrarre il destinatario
      <datiSpecificiServizio>Dati del servizio base64 encoded</datiSpecificiServizio>
    </ns3:demandPaymentNoticeReq>
  </soap:Body>
</soap:Envelope>
<soapenv:Envelope>
  <soapenv:Body>
    <ppt:demandPaymentNoticeRes>
      <outcome>OK</outcome>
      <qrCode>
        <fiscalCode>77777777778</fiscalCode>
        <noticeNumber>311111111112222222</noticeNumber>
      </qrCode>
      <paymentList>
        <paymentOptionDescription>
          <amount>30.00</amount>
          <options>EQ</options>
          <paymentNote>test</paymentNote>
        </paymentOptionDescription>
      </paymentList>
      <paymentDescription>payment</paymentDescription>
      <fiscalCodePA>77777777777</fiscalCodePA>
      <companyName>company EC</companyName>
      <officeName>office EC</officeName>
    </ppt:demandPaymentNoticeRes>
  </soapenv:Body>
</soapenv:Envelope>
  • outcome﹡: il risultato dell'operazione che può contenere i seguenti codici

    • OK : operazione eseguita con successo

    • KO : operazione terminata con errore

  • qrCode: è composto da fiscalCode e noticeNumber, dato valorizzato solo in caso di outcome OK

    • fiscalCode: codice fiscale dell'EC

    • noticeNumber: [auxDigit][segregationCode][IUVBase][IUVCheckDigit]

  • paymentList: struttura che contiene i dettagli del pagamento, al momento può contenere una sola paymentOptionDescription, dato valorizzato solo in caso di outcome OK

    • paymentOptionDescription﹡

      • amount﹡: importo in euro

      • options﹡: al momento è valorizzato con EQ

      • dueDate: data di scadenza del pagamento secondo il formato ISO 8601 [AAAA]-[MM]-[GG]

      • paymentNote: testo libero per descrivere l'oggetto del pagamento

  • paymentDescription: testo libero per descrivere l'oggetto del pagamento, dato valorizzato solo in caso di outcome OK

  • fiscalCodePA: codice fiscale dell'EC, dato valorizzato solo in caso di outcome OK

  • companyName: nome completo dell'EC, dato valorizzato solo in caso di outcome OK

  • officeName: nome completo dell'ufficio dell'EC

paDemandPaymentNotice

POST

Request Body

Name
Type
Description

idPA*

String

Codice fiscale della struttura che invia la richiesta di pagamento.

datiSpecificiServizio*

String

Sono censiti nel Catalogo dei Servizi, che è il repository che contiene l’elenco dei servizi generalizzati attivati dagli EC, inviati in formato base64.

idServizio*

String

Identificativo del servizio per cui si vuole attivare il pagamento.

idStation*

String

Identificativo della stazione dell'EC nel sistema pagoPa.

idBrokerPA*

String

Identificativo del soggetto che opera come intermediario per l'EC.

<soapenv:Envelope>
  <soapenv:Body>
    <ppt:paDemandPaymentNoticeReq>
      <idPA>77777777777</idPA>
      <idBrokerPA>77777777777</idBrokerPA>
      <idStation>77777777777_01</idStation>
      <idServizio>001001002</idServizio>       
      <datiSpecificiServizio>Dati del servizio base64 encoded</datiSpecificiServizio>
    </ppt:paDemandPaymentNoticeReq>
  </soapenv:Body>
</soapenv:Envelope>
  <soapenv:Body>
    <ns5:paDemandPaymentNoticeRes">
      <outcome>OK</outcome>
      <qrCode>
        <fiscalCode>77777777778</fiscalCode>
        <noticeNumber>311111111112222222</noticeNumber>
      </qrCode>
      <paymentList>
        <paymentOptionDescription>
          <amount>30.00</amount>
          <options>EQ</options>
          <paymentNote>test</paymentNote>
        </paymentOptionDescription>
      </paymentList>
      <paymentDescription>payment</paymentDescription>
      <fiscalCodePA>77777777777</fiscalCodePA>
      <companyName>company EC</companyName>
      <officeName>office EC</officeName>
    </ns5:paDemandPaymentNoticeRes>
  </soapenv:Body>
</soapenv:Envelope>
  • outcome﹡: il risultato dell'operazione che può contenere i seguenti codici

    • OK : operazione eseguita con successo

    • KO : operazione terminata con errore

  • qrCode: è composto da fiscalCode e noticeNumber, dato valorizzato solo in caso di outcome OK

    • fiscalCode: codice fiscale dell'EC

    • noticeNumber: [auxDigit][segregationCode][IUVBase][IUVCheckDigit]

  • paymentList: struttura che contiene i dettagli del pagamento, al momento può contenere una sola paymentOptionDescription, dato valorizzato solo in caso di outcome OK

    • paymentOptionDescription﹡

      • amount﹡: importo in euro

      • options﹡: al momento è valorizzato con EQ

      • dueDate: data di scadenza del pagamento secondo il formato ISO 8601 [AAAA]-[MM]-[GG]

      • paymentNote: testo libero per descrivere l'oggetto del pagamento

  • paymentDescription: testo libero per descrivere l'oggetto del pagamento, dato valorizzato solo in caso di outcome OK

  • fiscalCodePA: codice fiscale dell'EC, dato valorizzato solo in caso di outcome OK

  • companyName: nome completo dell'EC, dato valorizzato solo in caso di outcome OK

  • officeName: nome completo dell'ufficio dell'EC

nodoInviaFlussoRendicontazione

POST

Request Body

Name
Type
Description

identificativoPSP*

String

Identificativo del PSP, assegnato da PagoPA.

Il codice è generalmente rappresentato dal codice BIC (Bank Identifier Code) del PSP.

In assenza del codice BIC, o per gestire situazioni particolari, può essere utilizzato un altro codice, purché identifichi in modo univoco il PSP.

xmlRendicontazione*

String

Contenuto del Flusso di riversamento in formato base64.

dataOraFlusso*

String

Data e ora del Flusso di Rendicontazione.

identificativoFlusso*

String

Identificativo del Flusso di Rendicontazione.

identificativoDominio*

String

Codice fiscale dell'EC.

password*

String

Password del canale, assegnata da PagoPA.

identificativoCanale*

String

Identificativo del canale, identifica una categoria di servizio di pagamento e attraverso la quale viene effettuata la transazione.

Un identificatore di canale appartiene a un solo intermediario/broker PSP e di conseguenza deve essere univoco rispetto al PSP.

identificativoIntermediarioPSP*

String

Identificativo dell'intermediario, assegnato da PagoPA.

Identificazione dell'intermediario/broker del PSP che fornisce l'accesso (canale) al PSP per l'erogazione del servizio.

Nota: l'intermediario/broker può coincidere con il PSP stesso.

<soap:Envelope>
    <soap:Body>
        <ns5:nodoInviaFlussoRendicontazione>
            <identificativoPSP>88888888888</identificativoPSP>
            <identificativoIntermediarioPSP>88888888888</identificativoIntermediarioPSP>
            <identificativoCanale>88888888888_01</identificativoCanale>
            <password>**********</password>
            <identificativoDominio>77777777777</identificativoDominio>
            <identificativoFlusso>2021-11-2188888888888-AABB648200001295</identificativoFlusso>
            <dataOraFlusso>2021-11-22T00:37:32</dataOraFlusso>
            <xmlRendicontazione>Flusso di riversamento base64 encoded</xmlRendicontazione>
        </ns5:nodoInviaFlussoRendicontazione>
    </soap:Body>
</soap:Envelope>
<soapenv:Envelope>
    <soapenv:Body>
        <ppt:nodoInviaFlussoRendicontazioneRisposta>
            <esito>OK</esito>
        </ppt:nodoInviaFlussoRendicontazioneRisposta>
    </soapenv:Body>
</soapenv:Envelope>
  • esito﹡: il risultato dell'operazione che può contenere i seguenti codici

    • OK : operazione eseguita con successo

    • KO : operazione terminata con errore

nodoChiediElencoFlussiRendicontazione

POST

Request Body

Name
Type
Description

identificativoIntermediarioPA*

String

Identificativo del soggetto che opera come intermediario per l'EC.

identificativoPSP*

String

Identificativo del PSP, assegnato da PagoPA.

Il codice è generalmente rappresentato dal codice BIC (Bank Identifier Code) del PSP.

In assenza del codice BIC, o per gestire situazioni particolari, può essere utilizzato un altro codice, purché identifichi in modo univoco il PSP.

identificativoDominio*

String

Codice fiscale dell'EC.

password*

String

Password della stazione, assegnata da PagoPA.

identificativoStazioneIntermediarioPA*

String

Identificativo della stazione dell'EC nel sistema pagoPa.

<soap:Envelope>
    <soap:Body>
        <ns5:nodoChiediElencoFlussiRendicontazione>
            <identificativoIntermediarioPA>77777777777</identificativoIntermediarioPA>
            <identificativoStazioneIntermediarioPA>77777777777_01</identificativoStazioneIntermediarioPA>
            <password>**********</password>
            <identificativoDominio>77777777777</identificativoDominio>
            <identificativoPSP>88888888888</identificativoPSP>
        </ns5:nodoChiediElencoFlussiRendicontazione>
    </soap:Body>
</soap:Envelope>
<soapenv:Envelope>
    <soapenv:Body>
        <nodoChiediElencoFlussiRendicontazioneResponse>
            <esito>OK</esito>
            <elencoFlussiRendicontazione>
                <totRestituiti>1</totRestituiti>
                <idRendicontazione>
                    <identificativoFlusso>2021-11-2188888888888-AABB648200001295</identificativoFlusso>
                    <dataOraFlusso>2021-11-22T00:37:32</dataOraFlusso>
                </idRendicontazione>
            </elencoFlussiRendicontazione>
        </nodoChiediElencoFlussiRendicontazioneResponse>
    </soapenv:Body>
</soapenv:Envelope>
  • esito﹡: il risultato dell'operazione che può contenere i seguenti codici

    • OK : operazione eseguita con successo

    • KO : operazione terminata con errore

  • elencoFlussiRendicontazione: elenco dei flussi di riversamento, dato valorizzato solo in caso di esito OK

    • totRestituiti: numero dei flussi presenti nell'elenco

    • idRendicontazione

      • identificativoFlusso: identificativo del Flusso di Rendicontazione

      • dataOraFlusso: data e ora del Flusso di Rendicontazione

nodoChiediFlussoRendicontazione

POST

Request Body

Name
Type
Description

identificativoIntermediarioPA*

String

Identificativo del soggetto che opera come intermediario per l'EC.

identificativoFlusso*

String

Identificativo del Flusso di Rendicontazione.

identificativoPSP*

String

Identificativo del PSP, assegnato da PagoPA.

Il codice è generalmente rappresentato dal codice BIC (Bank Identifier Code) del PSP.

In assenza del codice BIC, o per gestire situazioni particolari, può essere utilizzato un altro codice, purché identifichi in modo univoco il PSP.

identificativoDominio*

String

Codice fiscale dell'EC.

password*

String

Password della stazione, assegnata da PagoPA.

identificativoStazioneIntermediarioPA*

String

Identificativo della stazione dell'EC nel sistema pagoPa.

<soap:Envelope>
    <soap:Body>
        <nodoChiediElencoFlussiRendicontazione>
            <identificativoIntermediarioPA>77777777777</identificativoIntermediarioPA>
            <identificativoStazioneIntermediarioPA>77777777777_01</identificativoStazioneIntermediarioPA>
            <password>**********</password>
            <identificativoDominio>77777777777</identificativoDominio>
            <identificativoPSP>88888888888</identificativoPSP>
            <identificativoFlusso>2021-11-2188888888888-AABB648200001295</identificativoFlusso>
        </nodoChiediElencoFlussiRendicontazione>
    </soap:Body>
</soap:Envelope>
<soapenv:Envelope>
    <soapenv:Body>
        <nodoChiediFlussoRendicontazioneResponse>
            <esito>OK</esito>
            <xmlRendicontazione>Flusso di riversamento base64 encoded</xmlRendicontazione>
        </nodoChiediFlussoRendicontazioneResponse>
    </soapenv:Body>
</soapenv:Envelope>
  • esito﹡: il risultato dell'operazione che può contenere i seguenti codici

    • OK : operazione eseguita con successo

    • KO : operazione terminata con errore

  • xmlRendicontazione: contenuto del flusso di riversamento in formato base64, dato valorizzato solo in caso di esito OK

nodoChiediInformativaPA

POST

Request Body

Name
Type
Description

identificativoPSP*

String

Identificativo del PSP, assegnato da PagoPA.

Il codice è generalmente rappresentato dal codice BIC (Bank Identifier Code) del PSP.

In assenza del codice BIC, o per gestire situazioni particolari, può essere utilizzato un altro codice, purché identifichi in modo univoco il PSP.

identificativoDominio*

String

Codice fiscale dell'EC.

password*

String

Password del canale, assegnata da PagoPA.

identificativoCanale*

String

Identificativo del canale, identifica una categoria di servizio di pagamento e attraverso la quale viene effettuata la transazione.

Un identificatore di canale appartiene a un solo intermediario/broker PSP e di conseguenza deve essere univoco rispetto al PSP.

identificativoIntermediarioPSP*

String

Identificativo dell'intermediario, assegnato da PagoPA.

Identificazione dell'intermediario/broker del PSP che fornisce l'accesso (canale) al PSP per l'erogazione del servizio.

Nota: l'intermediario/broker può coincidere con il PSP stesso.

<soap:Envelope>
    <soap:Body>
        <ns5:nodoChiediInformativaPA>
            <identificativoPSP>88888888888</identificativoPSP>
            <identificativoIntermediarioPSP>88888888888</identificativoIntermediarioPSP>
            <identificativoCanale>88888888888_01</identificativoCanale>
            <password>**********</password>
            <identificativoDominio>77777777777</identificativoDominio>
        </ns5:nodoChiediInformativaPA>
    </soap:Body>
</soap:Envelope>
<soapenv:Envelope>
    <soapenv:Body>
        <ppt:nodoChiediInformativaPARisposta>
            <esito>OK</esito>
            <xmlInformativa>Informativa base64 encoded</xmlInformativa>
        </ppt:nodoChiediInformativaPARisposta>
    </soapenv:Body>
</soapenv:Envelope>
  • esito﹡: il risultato dell'operazione che può contenere i seguenti codici

    • OK : operazione eseguita con successo

    • KO : operazione terminata con errore

  • xmlInformativa: contenuto dell'informativa in formato base64, dato valorizzato solo in caso di esito OK

nodoChiediCatalogoServizi

POST

Request Body

Name
Type
Description

identificativoPSP*

String

Identificativo del PSP, assegnato da PagoPA.

Il codice è generalmente rappresentato dal codice BIC (Bank Identifier Code) del PSP.

In assenza del codice BIC, o per gestire situazioni particolari, può essere utilizzato un altro codice, purché identifichi in modo univoco il PSP.

identificativoDominio*

String

Codice fiscale dell'EC.

password*

String

Password del canale, assegnata da PagoPA.

identificativoCanale*

String

Identificativo del canale, identifica una categoria di servizio di pagamento e attraverso la quale viene effettuata la transazione.

Un identificatore di canale appartiene a un solo intermediario/broker PSP e di conseguenza deve essere univoco rispetto al PSP.

identificativoIntermediarioPSP*

String

Identificativo dell'intermediario, assegnato da PagoPA.

Identificazione dell'intermediario/broker del PSP che fornisce l'accesso (canale) al PSP per l'erogazione del servizio.

Nota: l'intermediario/broker può coincidere con il PSP stesso.

<soap:Envelope>
    <soap:Body>
        <ns5:nodoChiediCatalogoServizi>
            <identificativoPSP>88888888888</identificativoPSP>
            <identificativoIntermediarioPSP>88888888888</identificativoIntermediarioPSP>
            <identificativoCanale>88888888888_01</identificativoCanale>
            <password>**********</password>
            <identificativoDominio>77777777777</identificativoDominio>
        </ns5:nodoChiediCatalogoServizi>
    </soap:Body>
</soap:Envelope>
<soapenv:Envelope>
    <soapenv:Body>
        <nodoChiediCatalogoServizi>
            <esito>OK</esito>
            <xmlCatalogoServizi>Catalogo dei servizi base64 encoded</xmlCatalogoServizi>
        </nodoChiediCatalogoServizi>
    </soapenv:Body>
</soapenv:Envelope>
  • esito﹡: il risultato dell'operazione che può contenere i seguenti codici

    • OK : operazione eseguita con successo

    • KO : operazione terminata con errore

  • xmlCatalogoServizi: contenuto del catalogo dei servizi in formato base64, dato valorizzato solo in caso di esito OK

nodoChiediTemplateInformativaPSP

POST

Request Body

Name
Type
Description

identificativoPSP*

String

Identificativo del PSP, assegnato da PagoPA.

Il codice è generalmente rappresentato dal codice BIC (Bank Identifier Code) del PSP.

In assenza del codice BIC, o per gestire situazioni particolari, può essere utilizzato un altro codice, purché identifichi in modo univoco il PSP.

identificativoIntermediarioPSP*

String

Identificativo dell'intermediario, assegnato da PagoPA.

Identificazione dell'intermediario/broker del PSP che fornisce l'accesso (canale) al PSP per l'erogazione del servizio.

Nota: l'intermediario/broker può coincidere con il PSP stesso.

identificativoCanale*

String

Identificativo del canale, identifica una categoria di servizio di pagamento e attraverso la quale viene effettuata la transazione.

Un identificatore di canale appartiene a un solo intermediario/broker PSP e di conseguenza deve essere univoco rispetto al PSP.

password*

String

Password del canale, assegnata da PagoPA.

<soap:Envelope>
    <soap:Body>
        <ns5:nodoChiediTemplateInformativaPSP>
            <identificativoPSP>88888888888</identificativoPSP>
            <identificativoIntermediarioPSP>88888888888</identificativoIntermediarioPSP>
            <identificativoCanale>88888888888_01</identificativoCanale>
            <password>**********</password>
        </ns5:nodoChiediTemplateInformativaPSP>
    </soap:Body>
</soap:Envelope>
<soapenv:Envelope>
    <soapenv:Body>
        <nodoChiediTemplateInformativaPSP>
            <esito>OK</esito>
            <xmlTemplateInformativa>Template informativa base64 encoded</xmlTemplateInformativa>
        </nodoChiediTemplateInformativaPSP>
    </soapenv:Body>
</soapenv:Envelope>
  • esito﹡: il risultato dell'operazione che può contenere i seguenti codici

    • OK : operazione eseguita con successo

    • KO : operazione terminata con errore

  • xmlTemplateInformativa: template dell'informativa in formato base64, dato valorizzato solo in caso di esito OK

fault: tutti i dettagli dell'errore, da inserire obbligatoriamente in caso di outcome KO

-

fault: tutti i dettagli dell'errore, da inserire obbligatoriamente in caso di outcome KO

-

fault: tutti i dettagli dell'errore, da inserire obbligatoriamente in caso di outcome KO

-

fault: tutti i dettagli dell'errore, da inserire obbligatoriamente in caso di outcome KO

-

fault: tutti i dettagli dell'errore, da inserire obbligatoriamente in caso di outcome KO

-

fault: tutti i dettagli dell'errore, dato valorizzato solo in caso di outcome KO

-

fault: tutti i dettagli dell'errore, dato valorizzato solo in caso di outcome KO

-

fault: tutti i dettagli dell'errore, dato valorizzato solo in caso di outcome KO

-

fault: tutti i dettagli dell'errore, dato valorizzato solo in caso di outcome KO

-

fault: tutti i dettagli dell'errore, da inserire obbligatoriamente in caso di outcome KO

-

fault: tutti i dettagli dell'errore, da inserire obbligatoriamente in caso di outcome KO

-

fault: tutti i dettagli dell'errore, da inserire obbligatoriamente in caso di outcome KO

-

fault: tutti i dettagli dell'errore, da inserire obbligatoriamente in caso di outcome KO

WSDL -

fault: tutti i dettagli dell'errore, dato valorizzato solo in caso di outcome KO

-

fault: tutti i dettagli dell'errore, dato valorizzato solo in caso di outcome KO

-

fault: tutti i dettagli dell'errore, dato valorizzato solo in caso di esito KO

-

fault: tutti i dettagli dell'errore, dato valorizzato solo in caso di esito KO

-

fault: tutti i dettagli dell'errore, dato valorizzato solo in caso di esito KO

-

fault: tutti i dettagli dell'errore, dato valorizzato solo in caso di esito KO

-

fault: tutti i dettagli dell'errore, dato valorizzato solo in caso di esito KO

-

fault: tutti i dettagli dell'errore, dato valorizzato solo in caso di esito KO

XSD
WSDL
XSD
XSD
WSDL
XSD
XSD
WSDL
XSD
XSD
WSDL
XSD
XSD
WSDL
XSD
XSD
WSDL
XSD
XSD
WSDL
XSD
XSD
WSDL
XSD
XSD
WSDL
XSD
XSD
WSDL
XSD
XSD
WSDL
XSD
XSD
WSDL
XSD
XSD
XSD
XSD
WSDL
XSD
XSD
WSDL
XSD
XSD
WSDL
XSD
XSD
WSDL
XSD
XSD
WSDL
XSD
XSD
WSDL
XSD
XSD
WSDL
XSD
XSD
https://github.com/pagopa/pagopa-api/tree/SANP3.0.0
WSDL
XSD
Gestione degli errori
Gestione degli errori
Gestione degli errori
Gestione degli errori
Gestione degli errori
Gestione degli errori
Gestione degli errori
Gestione degli errori
Gestione degli errori
Gestione degli errori
Gestione degli errori
Gestione degli errori
Gestione degli errori
Gestione degli errori
Gestione degli errori
Gestione degli errori
Gestione degli errori
Gestione degli errori
Gestione degli errori
Gestione degli errori
Gestione degli errori
Gestione degli errori