24 releases (8 stable)

1.0.8 Nov 21, 2024
1.0.7 Nov 9, 2024
1.0.2 Oct 25, 2024
0.2.15 Oct 22, 2024

#1582 in Parser implementations

Download history 578/week @ 2024-10-07 1191/week @ 2024-10-14 831/week @ 2024-10-21 22/week @ 2024-10-28 649/week @ 2024-11-04 26/week @ 2024-11-11 137/week @ 2024-11-18 39/week @ 2024-11-25

852 downloads per month
Used in open-payments-iso20022

Apache-2.0

2MB
34K SLoC

Messages Library

Apache License 2.0 Contributions welcome GitHub issues

The library provides tools for parsing, validating, and transforming financial messages, with support for ISO 20022 and FedNow message formats. The library is designed to help developers integrate financial message handling into their Rust applications, using serde for (de)serialization.


Features

  • ISO 20022 Support: Comprehensive support for key ISO 20022 payment message types.
  • FedNow Message: Full support for FedNow message formats.
  • (De)serialization: Using serde for easy conversion between XML and JSON.
  • Extensibility: Easily extendable to support additional message types or custom formats.

Getting Started

Prerequisites

You’ll need the following installed to build and use this library:

  • Rust (latest stable version)
  • Cargo (Rust package manager)

Installation

Add the following to your Cargo.toml to start using the library in your Rust project:

[dependencies]
# This dependency includes support for the entire ISO 20022 message formats.
# The "payments" feature enables various ISO 20022 message categories, such as pacs, pain, camt, etc.
# If you only need specific message types, you can enable just those features (e.g., "pacs", "pain").
open-payments-iso20022 = { version = "1.0.1", features = ["payments"] }

# This dependency provides support for the FedNow message formats.
# You get full support for parsing and serializing FedNow messages out of the box.
open-payments-fednow = "1.0.1"

Features

The ISO20022 message library open-payments-iso20022 provides several features to allow you to include only the message types relevant to your use case. Here’s a breakdown of the available features:

[features]
default = ["head"]  # Default feature, includes the basic header message.
iso20022 = ["payments"]  # Enables all payment-related ISO 20022 messages.
payments = ["acmt", "admi", "auth", "camt", "head", "pacs", "pain", "reda", "remt"]  # Includes all payments-related ISO 20022 message types.

# Individual ISO 20022 message modules:
acmt = ["open-payments-iso20022-acmt"]  # Account Management messages
admi = ["open-payments-iso20022-admi"]  # Administrative messages
auth = ["open-payments-iso20022-auth"]  # Authorization messages
camt = ["open-payments-iso20022-camt"]  # Cash Management messages
head = ["open-payments-iso20022-head"]  # Basic Header messages (default)
pacs = ["open-payments-iso20022-pacs"]  # Payment Clearing and Settlement messages
pain = ["open-payments-iso20022-pain"]  # Payment Initiation messages
reda = ["open-payments-iso20022-reda"]  # Reference Data messages
remt = ["open-payments-iso20022-remt"]  # Remittance Advice messages

By configuring the features, you can optimize the library for your specific message requirements, minimizing unnecessary dependencies.

Usage

Example: Creating an ISO 20022 Message Object

use open_payments_iso20022::document::Document;
use open_payments_iso20022_admi::admi_002_001_01::Admi00200101;

fn main() {
    let doc = Document::Admi00200101(Box::new(Admi00200101::default()));

    println!("{:?}", doc)
}

Example: Creating a FedNow Message Object

Similarly, here’s an example of how to create a FedNow message object:

use open_payments_fednow::document::Document;
use open_payments_fednow::iso::pacs_008_001_08::FIToFICustomerCreditTransferV08;

fn main() {
    let doc = Document::FIToFICustomerCreditTransferV08(Box::new(FIToFICustomerCreditTransferV08::default()));

    println!("{:?}", doc)
}

Supported Messages

The library supports a variety of financial message formats from both ISO 20022 and FedNow, covering key areas of the payment lifecycle.

ISO 20022 Messages

  • pacs: Payment Clearing and Settlement
  • pain: Payment Initiation
  • admi: Administrative messages
  • auth: Authorization messages
  • camt: Cash Management
  • reda: Reference Data
  • remt: Remittance Advice
  • acmt: Account Management
  • head: Header messages

FedNow Messages

  • Customer Credit Transfer
  • Payment Status Report
  • Payment Return

This extensive support for ISO 20022 messages enables comprehensive coverage of the payment message lifecycle, including administrative processes, investigations, status reports, and transaction instructions.

Contributing

We welcome contributions from developers to help improve the library. Whether you’re fixing a bug, improving documentation, or adding new message types, your help is appreciated!

  1. Fork the repository.
  2. Create a new branch with your feature or fix: git checkout -b feature-branch-name.
  3. Commit your changes: git commit -m 'Add some feature'.
  4. Push to the branch: git push origin feature-branch-name.
  5. Open a pull request.

Make sure to review our contributing guidelines before you start.


Roadmap

Here’s what’s coming up:

  • Add a Sophisticated Error Framework for XML Parsing and Validation
  • Add Support for Format Transformation (ISO20022 -> MT103)
  • Add Examples for Format Conversion
  • Performance optimizations for large message batches.
  • Expanded documentation and examples.

You can view the complete roadmap here.


License

This project is licensed under the Apache 2.0 License - see the LICENSE file for details.


Contact

For any questions or discussions, please reach out via GitHub Issues on our GitHub Issues page.

Dependencies

~2.3–3.5MB
~62K SLoC