The Italian version constitutes the only official and legally binding version of the document. The English-language version of this document is provided solely as a courtesy to facilitate consultation by users. In the event of any discrepancies, interpretive differences, or inconsistencies between the Italian-language version and any translated version, the Italian text alone shall prevail and be deemed authoritative.

Changelog

3.7.1 (April 2024)

Patch version issued to resolve some elements of ambiguity indicated below

Correction of field names in Fase di censimento
Clarifications regarding the use of code 8 in the Reporting Flows in Title text 1
Removal of Registration for services with a subscription key
Correction Nuove api gestione flussi di rendicontazione
Correction Pacreateposition
Correction https://github.com/pagopa/devportal-docs/blob/docs/from-gitbook/docs/DG2lpjf4Y5u7ZRFE7CyZ/appendices/debt-positions/massive-management/massive-loading.md#tracciato-fileto https://github.com/pagopa/devportal-docs/blob/docs/from-gitbook/docs/DG2lpjf4Y5u7ZRFE7CyZ/appendices/debt-positions/massive-management/massive-loading.md
Correction Creazione di una posizione debitoria
Correction Lettura di una lista di debt positions e di una singola posizione debitoria
Correction Aggiornamento di una posizione debitoria

3.7.0 (Mach 2024)

Update Richiesta flussi di rendicontazione da parte dellcreditor 1
Update Stand In
Removal of the Counterparty Table, Extended Counterparty Table and Credit Account Disclosure in Data model
Suitable references to the pagoPA back office in Registration
Update Archivio centralizzato avvisi
Suitable references to the pagoPA back office in Start-up process
Suitable description of the fault code PPT_TOKEN_SCADUTO_KO in Title text 1
Update Fase di invio dellesito del pagamento
Update Title text 2
Addition Quality Improvement
Update Api recupero url
Update Connectivity
Added https://github.com/pagopa/devportal-docs/blob/docs/from-gitbook/docs/DG2lpjf4Y5u7ZRFE7CyZ/appendices/debt-positions/massive-management/README.md of the outstanding payments
Updates APIs for the outstanding payments in Available operations
Addition of references to the new APIs provided by the pagoPA back office in Deprecated functions
Suitable references to the pagoPA back office in the FAQ in Creditor
Introduction in fdr_organization.yaml and fdr_psp.yaml of the code 4 = Payment managed in Stand In in PaymentStatusEnum

3.6.1 (January 2024)

Patch version issued to resolve some elements of ambiguity indicated below

Correction of Integration for a payment instrument via redirect
Correction of fdr_organization.yaml and fdr_psp.yaml
Added redirect.yaml
FAQ correction Un creditor puo censire sul sistema pagopa degli iban inerenti dei conti correnti a lui non in

3.6.0 (November 2023)

Update Richiesta flussi di rendicontazione da parte dellcreditor 1
Stand In
Update Payment at the EC’s frontend
Interazione con send
Update Archivio centralizzato avvisi
Update Fase invio ricevuta
Update for the file format related to Collection service taxonomy
Update Offering payment systems on PagoPA S.p.A. touchpointswith incorporation of the contents of the chapter Payment instrument management
Standard integration for payment instruments
Integration for a PayPal payment instrument
Integration for a payment instrument via redirect
Addition of the standin field in Pasendrt
Addition of the paymentNote field in Pasendrt versione 2
Addition of the companyName field in transfer of Pasendrt versione 2
Addition of the standin field in Verifypaymentnotice
Addition of the standin field in Verificabollettino
Addition of the standin field in Activatepaymentnotice
Addition of the standin field in Pspnotifypayment
Addition of the companyName field in transfer of Pspnotifypayment versione 2
Update Payments at the EC frontend in asynchronous mode
Update of Available operations

3.5.0 (July 2023)

Introduced Richiesta flussi di rendicontazione da parte dellcreditor 1
Specific updates related to Integration via asynchronous API
Specific updates related to Archivio centralizzato avvisi
New Primitive deprecate
Deprecation Tabella delle controparti
Deprecation Informativa conto accredito
Payments at the EC frontend in asynchronous mode
Specific openapi updates in Available operations
Compulsoriness of the tag companyName in data and in transfer of Pagetpayment versione 2
Addition of the companyName field in transfer of Activatepaymentnotice versione 2

3.4.1 (May 2023)

Correction of the sequence diagram in Payment at the EC’s frontend
Correction related to the use of the Bollettino postale pa
Correction related to the share of commissions to the creditor Advanced commission management
Tag correction in transferType of Pagetpayment versione 2 with the addition of the PAGOPA value
Openapi correction Getorganizationreceipt for mbdAttachment not required
Correction of the type of the amount tag in the primitives Paverifypaymentnotice, Verifypaymentnotice and Verificabollettino
Correction of the management of the organizationFiscalCode field in the transfers of the Outstanding Payments inAvailable operations

3.4.0 (March 2023)

Archivio centralizzato avvisi in the case of Integration via synchronous API
Ricezione sincrona della ricevuta in the case of Integration via asynchronous API
Addition of idCart and allCCP in _om57nyt5rga1 for Integration of the EC touch point with Checkout
Clarifications about the paymentNote tag in Fase di attivazione
Use of the Bollettino postale pa in the case of Payment at the EC’s frontend
Clarifications about @e.bollo service
Addition Backoffice pagopa in Registration of the PSP
Removed references to the whitelist in Nodo dei pagamenti client
Updated the definition of the paymentNote tag in Pagetpayment
Addition of the allCCP tag in Activatepaymentnotice versione 2 request
Addition of the transferCategory tag in Activatepaymentnotice versione 2 response
Tags added for Advanced commission management in Pspnotifypayment versione 2 request
Addition of idSoggettoServizio tag in Pademandpaymentnoticerequest
Corrected identificativoDominio tag in Nodochiedielencoflussirendicontazione
Added idCart and allCCP tags in Ec checkout api
Definition of the service for creating an ad-hoc payment option in Pagamento spontaneo
Updated FSM in Posizione debitoria
Updated the publication methods in Creazione di una posizione debitoria
Updated filter management in Lettura di una lista di debt positions e di una singola posizione debitoria
Added operations for the Ricevute di pagamento of outstanding payments
Clarifications about the use of the touchPoint in tag Physical POS

3.3.1 (February 2023)

Corrected the link for the Generation and printing of notices
Corrected the wsdl/xsd in https://github.com/pagopa/pagopa-api/tree/SANP3.3.1
Corrected the Event journal with inclusion of the storage times

3.3.0 (January 2023)

Updated the flow in Life cycle of a payment
Inserted a new page Component overview that represents the macro application architecture of the pagoPA platform
Expanded the description of the Service catalog
Update of the amount in Title text 2
Distinction between the integration methods for the creditors in Integration via synchronous API and Integration via asynchronous API
Correct the links to the guidelines in Generation of the Univocal Payment Identifier
Added the section Dati canale pagamentoin the Dizionario dei metadata
New method for selecting the PSP for amounts below 50 euros in Offering payment systems on PagoPA S.p.A. touchpoints
Added details regarding the non-modifiability of the outcome sent by the PSP in Fase di invio dellesito del pagamento
Updated the procedure in Nodo dei pagamenti server
Updated the procedure in Nodo dei pagamenti client
Event journal
Printing pagoPA notices
https://github.com/pagopa/devportal-docs/blob/docs/from-gitbook/docs/DG2lpjf4Y5u7ZRFE7CyZ/implementary-specifications-for-the-SPC-payment-node/broken-reference/README.md
Recupero receipt per enti creditori
Physical POS

3.2.2 (December 2022)

Corrected the references to entities that can connect directly to the pagoPA platform in the section Connectivity
Corrected the denominazioneRicevente tag in FlussoRiversamento_1_0_4.xsd

3.2.1 (November 2022)

Added details for the correct use of the transferCategory tag regarding the @e.bollo service
Updated the swagger Ec checkout api
Updated the swaggers in Available operations

3.2.0 (October 2022)

Updated the specifications for Payment at the EC’s frontendand Integration of the EC touch point with Checkout
@e.bollo service
Added details for the correct use of the Title text in regard to the multiple invocation of the sendPaymentOutcome
Modification of the Primitive for Advanced Commission Management

3.1.0 (July 2022)

Integration via asynchronous API
Clarifications regarding management of the idempotency key can be found in Title text 2
Clarifications regarding management of the payment session can be found in Title text
Addition of a reporting flow data structure example in Reporting and cashflow
Advanced commission management
Connectivity
Clarifications regarding spontaneous-payment-via-a-psp
Addition of a data structure example in Service catalog
Addition of a data structure example in Car property tax
Specific use cases in Multi-beneficiary taxes
Account reconciliation
Title text 1

3.0.0 (May 2022)

Major Release
Complete revision of the layout
Introduction of a new connection method
Evolution of the payment at the creditor
Evolution of the spontaneous payment at the PSP
Evolution of the payment from the PagoPA Touchpoint
Details on the method of publication of the commissions applied by the PSPs
New quality indicators for registered entities

2.5.1 (January 2022)

Changes to the support -email
Revision of the download of the reporting flow

2.5.0 (October 2021)

Clarifications regarding cumulative repayments

2.4.3 (September 2021)

pspInviaCarrelloRPTCarte deprecated
Introduction of the pspNotifyPayment primitive for payments from the PagoPA Touchpoint.

2.4.2 (May 2021)

Additional clarifications regarding the new payment process at the PSP
Clarifications regarding the method of use of postal current accounts
Revision of the payment options.
Clarifications regarding the reporting flows

2.4.1 (April 2021)

Some clarifications regarding the new payment process at the PSP
PagoPA SpA single fee solution as a technological partner

2.4.0 (March 2021)

New payment process at the PSP
Deprecated functions eliminated

2.3.0 (November 2020)

Data catalog request (deprecated) asynchronous RT push , revoke and cancel (deprecated);
On-line payment with agreement code

2.2.0 (January 2020)

Major release

Need help?

Open a ticket using the dedicated function within your Reserved Area

Tell us what you think

For clarifications on implementation specifications, such as SACI and SANP, you can open an issue on GitHub

Table of contents