OPEN SOURCE
Prowide ISO 20022

Prowide ISO 20022

Complete Java Model for ISO 20022 MX Messages - All Business Domains

Prowide ISO 20022 is an open source Java library for managing MX messages.
Essential for banks transitioning from SWIFT MT to ISO 20022 MX as mandated by SWIFT's November 2025 migration deadline. Production-ready with commercial support available.

What's included?

  • Java model for ISO 20022 MX (for ex: MxPacs00800108 class, all MX categories)
  • Parser from XML into Java model
  • Builder API from Java to ISO 20022 XML
  • Back and forth conversion to JSON
  • JPA entities model for persistence
  • Support for multiple application headers: legacy, head.001.001.02, etc...
  • Multiple message versions: Historic versions retained, updated annually with SRU releases
  • Hybrid address support: Handles structured, unstructured, and mixed address formats (SRU2025+)
  • Performance optimized: JAXBContext caching for high-volume message parsing
  • All business domains: payments, cash management, securities, trade services, cards, foreign exchange
  • Jakarta EE 10 compatible
  • Source code and community support at Github
  • Online documentation resources and javadoc

A secure choice for in-house ISO 20022 software development.

Main Features

The library provides a simple and consistent API for all categories of the ISO 20022 standard.

Parsing a message

The parser takes a message in XML as input, and returns plain Java objects as output. The model provides a simple way to read any element without the hassle of processing the XML structure.

Creating a message

The creation of a message can be done entirely by populating Java objects. You can focus on the setting of business data without knowing the internal format of the XML message generated.

Download & Resources

Frequently Asked Questions

What is Prowide ISO 20022?

Open source Java library for parsing, building, and managing ISO 20022 MX messages. Comprehensive model for all MX types (pain, pacs, camt, etc.) with automatic XML handling.

What ISO 20022 message types are supported?

All MX categories: payments (pain, pacs), cash management (camt), securities (sese, semt, setr), trade services (tsmt, tsin), cards (caaa, cain), foreign exchange (fxtr), and all other ISO 20022 families.

Is Prowide ISO 20022 free to use?

Yes. Apache License 2.0 allows free commercial and non-commercial use without licensing fees.

How do I migrate from SWIFT MT to ISO 20022 MX?

Migration requires three capabilities: (1) parsing both MT and MX messages, (2) translating between formats, and (3) validating compliance. Prowide Core handles MT, Prowide ISO 20022 handles MX, and Prowide Integrator Translations provides SWIFT-compliant MT-MX conversions following official market practice guidelines (CBPR+, SIC). This accelerates migration by 6-12 months compared to building translations in-house.

What about hybrid addresses and structured/unstructured data?

The library supports all address formats mandated by SWIFT's transition timeline: unstructured (legacy), structured (required Nov 2026), and hybrid (Nov 2025-Nov 2026). The model handles mixed content, but automatic structuring of legacy address data requires custom heuristics based on your institution's data patterns.

How does the library handle multiple ISO 20022 versions?

All historic message versions are retained in the library (e.g., pacs.008.001.01 through pacs.008.001.11). This allows reading messages from counterparties using different versions and migrating your own messages gradually. New versions are added with each SWIFT SRU (Standards Release Update) annually.

Can I validate ISO 20022 messages for compliance?

Basic XML structure validation included. For full compliance (business rules, network requirements), use Prowide Integrator Validation.

Technical Specifications

Requirements
  • Java: 11 or higher (any distribution)
  • Build Tool: Gradle
  • Standards: ISO 20022 (all MX categories)
  • Compatibility: Jakarta EE 10
Distribution
  • License: Apache License 2.0
  • Repository: Maven Central
  • Source Code: GitHub
  • Group ID: com.prowidesoftware
  • Artifact ID: pw-iso20022
Key Features
  • Parse ISO 20022 XML messages
  • Build MX messages programmatically
  • Convert to JSON and from JSON
  • JPA entities for persistence
  • Support for multiple application headers
  • All MX message categories included
Support
Get it

Early release

Looking to begin early on with testing the new SWIFT Standard Release? Then subscribe to the early release update and begin testing already by the end of May, each year. Don't wait for the public release in October and save 5 months of waiting time.

Want to know more about it?
Contact Us