Does ISO20022 support JSON?

No, ISO20022 is not a JSON format.

ISO20022 is based on XML, which means that it's a machine-readable format designed to be processed by program partially readable by humans. It's more similar to HTML than JSON.

XML information is based off tags. Here is a short example of an ISO20022 message:

<Document xmlns="urn:iso:std:iso:20022:tech:xsd:pain.001.001.03">
    <GrpHdr>...</GrpHdr>
    <PmtInf>...</PmtInf>
</Document>

Meanwhile, JSON (Javascript Object Notation) is based off keys. Here is a short example of a JSON message:

{
    "groupHeader": "...",
    "paymentInformation": "..."
}

ISO20022 files can be extremely large, making them difficult and unreliable to directly translate from JSON to ISO20022 XML.

iso20022.js was created to bridge the gap between Javascript and ISO20022 by providing a simple interface for creating and sending ISO20022 XML messages.

Check out a quick example:

const payment = iso20022.createSWIFTCreditPaymentInitiation({
    paymentInstructions: [{
        type: 'sepa',
        direction: 'credit',
        amount: 1000,
        currency: 'USD',
        creditor: {
            name: 'Jane Smith',
            account: {
                iban: 'DE89370400440532013000'
            },
            agent: {
                bic: 'CHASUS33'
            }
        },

For more information about how to use iso20022.js, check out our quickstart guide.