Downloads

Swift Microgateway Packages

Download our latest Microgateway versions. For more information, check the changelog.

Microgateway
Microgateway Front-End
Microgateway BaaS

Changelog

February, 20 2026

v3.21.0-22Latest version

Added

Migrate verticals such as Alliance File or MQ Connectors to the new installation.
Additional security for sensitive data stored.
Spring Boot 3.2 to Spring Boot 3.5.
Support for WebSocket connectivity.
Swift Microgateway as a service with Windows OS.

October, 23 2025

v3.21.0-18

Added

Automate data migration from Swift Microgateway 2.17.8-6 to Swift Microgateway 3.21.x
Configuration enhancement to the Docker image containing an upgraded Java runtime version
Enhanced management of HTTP headers for processing inbound messages
Swift Personal Token support for Alliance Cloud customers connected to Swift via Internet

May, 30 2025

v3.21.0-14

Added

Dynamic Configuration: Modify runtime configurations via REST API without manual encryption/decryption
Vertical Capabilities: Introduces modular sub-components (verticals) for business-specific functions. The first available vertical enables seamless integration with Alliance Cloud MQ/File Connector.
Docker Support: Deploy quickly using a pre-packaged Docker image for cloud or on-premises environments.
Centralized Cluster Management: Manage configurations centrally across distributed systems, leveraging Kubernetes or OpenShift.
Advanced API to Messaging Orchestration: REST over Apache Kafka and IBM MQ enables more efficient message routing for Incoming Webhook processing over MV-SIPN network.
Embedded Resources: Bundled Java 21 runtime and Key Management Service (KMS) for secure authentication and encryption.
Enhanced Logging & Troubleshooting: Simplified system monitoring with improved REST API access to logs and support data.

February, 12 2025

v2.17.8-6

Added

Validation to inbound API calls, incoming Webhooks, and push notifications against OpenAPI specifications
Inbound API calls, Webhooks and push notification error handling inline with the error code structure and semantic of Swift APIs.
Enables configurable HTTP status code handling for the JMS back-end simulator.
Enables dynamic configuration of the {endpoint} during the subscription phase to listen for push notifications.

January, 16 2025

v2.17.8-4

Added

Improved handling of SAG connections in application service profiles

Removed

Case sensitivity when using X-SWIFT-Signature header.

October, 28 2024

v2.17.8

Added

Performance increases upwards of 200% by improving concurrency, reducing wait times and better resource usage.
Better handling of conversion to the format of the data type, no scientific format for type ‘double’.
Improvements to SAG DN configuration behaviour.

Patching

Unpackage the Swift Microgateway package to a new directory. Migrate the contents of the “db” folder and “config” folder to the new installation.

September, 11 2024

v2.17.7

Added

Now permits PUT calls with an empty body in order to support Webhooks and Domain Registration APIs.
Allow the usage of the DELETE verb in order to comply with the Open API specification for Domain Registration and Notification Subscription APIs.
HTTP headers whitelist configuration is possible in the bootstrap configuration YAML file. You can specify which headers are allowed in addition to the default headers.
Providing Heartbeat service in case of activating inbound API calls processing.
Fixing enabledAuth = false logic for inbound API calls processing.
Ability to receive inbound API calls to both /swift/mgw and contexts.

Patching

Unpackage the Swift Microgateway package to a new directory. Migrate the contents of the “db” folder and “config” folder to the new installation.

June, 13 2024

v2.17.5

Added

Ensure that only incoming and outgoing HTTP headers that are specified in the OAS specification are allowed to pass through the Swift Microgateway.

Patching

Unpackage the Swift Microgateway package to a new directory. Migrate the contents of the “db” folder and “config” folder to the new installation.

April, 1 2024

v2.17.4

Added

Process any inbound API calls with delivery to dedicated JMS queues.
Supports mediation between REST and JMS (and vise versa) for inbound and outbound API calls.
Enables inbound processing of all API facilitating Payment Pre-validation (BAV), Instant Cash Reporting, Bank Guarantee along with all Swift and community APIs.

Patching

Unpackage the Swift Microgateway package to a new directory. Migrate the contents of the “db” folder and “config” folder to the new installation.

March, 1 2024

v2.17.3

Added

Support for OAuth 2.0 password grant type for Internet APIs.
Support for Bank of England Community APIs
Support for inbound API call processing using Java Messaging Service (JMS) queues.
Support for outbound API call processing using Java Messaging Service (JMS) queues.
Additional configuration features to customize log compression and log roll over.

Security

Latest security setting applied to embedded Jetty server.

Patching

Unpackage the Swift Microgateway package to a new directory. Migrate the contents of the “db” folder and “config” folder to the new installation.

March, 1 2024

v2.0.17

Security

Repackaging with updated signature and checksum.

Patching

Unpackage the Swift Microgateway package to a new directory. Migrate the contents of the “db” folder and “config” folder to the new installation.

September, 1 2023

v2.17.2

Security

Upgrades to frameworks and third-party software to reduce the potential vulnerabilities reported by security tools and software scanners.

Patching

Unpackage the Swift Microgateway package to a new directory. Migrate the contents of the “db” folder and “config” folder to the new installation.

August, 8 2023

v2.17.1-4

Fixed

Included Swift Microgateway examples on how to use Microservices in the Postman collection.

August, 8 2023

v2.0.16

Fixed

Included Swift Microgateway examples on how to use Microservices in the Postman collection.

June, 23 2023

v2.17.1

Added

Ability to add new APIs to the existing Postman Collection of Swift Microgateway (code re-generation)
Supportinfo scripts to gather configuration information from the H2 database (1 way TLS only)
Software integrity checks on start-up of Swift Microgateway
Sample script for command line configuration of Swift Microgateway
Swift Microgateway logging in Common Event Format. Please use setting below under mgw config logging: cef-format-enabled: true

Security

Remove information exposure about of third party COTS/libs versions in request and responses

Fixed

Instant Cash Reporting (ICR) - Account path parameter support for slashes: /
Warning when pilot calls are made in Live and vice versa
Improved loading of Local OAS Specifications

Patching

Please note, the patching procedure documented in the Getting Started Guide (chapter Applying SWIFT Microgateway Patch Releases) cannot be applied for going from SWIFT Microgateway 1.0.6.x to SWIFT Microgateway 2.17.0-11. The same is applicable for SWIFT Microgateway 2.x to SWIFT Microgateway 2.17.0-11

Migration

See Migration section of release Swift Microgateway 2.17.0-7

March, 03 2023

v2.17.0-7

Added

Ability to disable interactions with Central API Repository
Ability to dynamically change log levels in log files via Swift Microgateway Management Microservice
Supporting connectivity with Swift API Sandbox available on Internet
Ability to purge API contracts from Configuration Management database imported via Local and/or Central API Repositories. This feature can be used to refresh API contracts from Local/Central API Repositories using Swift Microgateway Management Microservice
Updated Postman Collection triggering the above action

Security

Providing an ability to communicate with Swift API Platform via HTTP Forward Proxy not mandating a password to be specified - built-in HTTP Forward Proxy available with Alliance Web Platfrom

Fixed

Fixing the logic of API session establishment process in case multiple Business Application profiles are used

Patching

Please note, the patching procedure documented in the Getting Started Guide (chapter Applying SWIFT Microgateway Patch Releases) cannot be applied for going from SWIFT Microgateway 1.0.6.x to SWIFT Microgateway 2.17.0-1

Migration

You cannot migrate from SWIFT Microgateway 1.0.6.x to SWIFT Microgateway 2.17.0-7 automatically. You will have to install and configure SWIFT Microgateway 2.17.0-7 from scratch using either SWIFT Microgateway Microservices, curl script calling SWIFT Microgateway Microservices or SWIFT Microgateway Front-End 2.0.2. You also cannot patch SWIFT Microgateway 2.0.6 to the SWIFT Microgateway 2.17.0-7 following the procedure outlined in the Getting Started Guide (chapter Applying SWIFT Microgateway Patch Releases) as SWIFT Microgateway 2.17.0-7 is leveraging the new version of configuration database engine which is not compatible with the one used in SWIFT Microgateway 2.0.6

January, 5 2023

v2.17.0-6

Added

Support for mgw_supportinfo scripts that collect iformation about the customer environment. It should be run and the output attacheched when opening a support case with Swift.
Software name and version of the Microgateway in logfiles and http headers

Removed

This version is not available anymore for download. See https://www2.swift.com/knowledgecentre/kb_articles/5025935

October, 20 2022

v2.17.0-2

Added

Supporting the new versioning scheme
Supporting Java 17 LTS
Supporting retries logic in SWIFT Microgateway

Changed

Relying on Spring Boot 2.6.6
Adopting Swagger codegen 3.0.34 for interacting with Central API Repository
The new layout of SWIFT Security SDK not dependent on Swagger codegen is used for establishing a secure API session

Removed

Support for AIX
This version is not available anymore for download. See https://www2.swift.com/knowledgecentre/kb_articles/5025935

Fixed

Fixing the logic used for payloads digest calculation on API responses
Fix SWIFT Microgateway 2.x for processing API responses with Unicode characters
Improved auto SAG switch over logic in SWIFT Microgateway 2.17.0-1

Patching

Please note, the patching procedure documented in the Getting Started Guide (chapter Applying SWIFT Microgateway Patch Releases) cannot be applied for going from SWIFT Microgateway 1.0.6.x to SWIFT Microgateway 2.17.0-1

Migration

You cannot migrate from SWIFT Microgateway 1.0.6.x to SWIFT Microgateway 2.17.0-1 automatically. You will have to install and configure SWIFT Microgateway 2.17.0-1 from scratch using either SWIFT Microgateway Microservices, curl script calling SWIFT Microgateway Microservices or SWIFT Microgateway Front-End 2.0.2. You also cannot patch SWIFT Microgateway 2.0.6 to the SWIFT Microgateway 2.17.0-1 following the procedure outlined in the Getting Started Guide (chapter Applying SWIFT Microgateway Patch Releases) as SWIFT Microgateway 2.17.0.1 is leveraging the new version of configuration database engine which is not compatible with the one used in SWIFT Microgateway 2.0.6

March, 15 2022

v2.0.6

Added

Automatically identifying the version of SWIFT Microgateway running in the field
Automatically identifyig the version of SWIFT Security SDK, SWIFT Microigateway is based upon, running in the field

Patching

Please note, the patching procedure documented in the Getting Started Guide (chapter Applying SWIFT Microgateway Patch Releases) cannot be applied for going from SWIFT Microgateway 1.0.6.x to SWIFT Microgateway 2.0.2

Migration

You cannot migrate from SWIFT Microgateway 1.0.6.x to SWIFT Microgateway 2.0.2 automatically. You will have to install and configure SWIFT Microgateway 2.0.6 from scratch using either SWIFT Microgateway Microservices, curl script calling SWIFT Microgateway Microservices or SWIFT Microgateway Front-End 2.0.2

December, 9 2021

v2.0.2

Added

Positioning the software for processing inbound API calls
Validating outbound API calls according OpenAPI specifications based on ISO 20022 data components
Validating inbound API calls according to OpenAPI specifications based on ISO 20022 data components
Supporting Open and Automatic SAG switch-over architectures
Providing solution for running SWIFT Microgateway nodes in a cluster
Providing Business Continuity and Business Consistency through the use of In-Memory Data Grid technology
Providing a single interface to a back-office for interfacing with a cluster as a whole
Positioning SWIFT SDK on top of the cluster for resolving load balancing and fault-tolerance automatically
Extending SWIFT APIs reach toward Message-oriented middleware (MOM) customers base – providing productized AMQP Connector for making and receiving API calls
Providing Local KMS for storing software certificates and shared secrets in AES encrypted form accessed via secure local API
Providing Reference Implementation based on SWIFT SDK for integrating inbound API calls with Core Banking Systems
Ability to enable/disable Configuration
Management and Monitoring Microservices
Microservice for validating the software and configuration data integrity
Providing configurable HTTP timeouts for connecting, calling, writing, and reading
Providing X-SWIFT-Signature in API response to a back-office application in the form of a signed JWT (software and hardware certificate based) so it can be stored in an archive managed by a customer
New SWIFT Microgateway Front-End 2.0.2 for configuring SWIFT Microgateway 2.0.2
SWIFT Microgateway Front-End 2.0.2 not being dependent Java

Security

Anonymizing security artefacts (consumerSecret, sharedSecret) returned by Configuration Microservice
Password protected command line utility used for decrypting the YAML bootstrap configuration file

Changed

Fix performance issue observed when used from more than 10 business applications at the same time. This fix has been applied since the version 1.0.6.7

Patching

Please note, the patching procedure documented in the Getting Started Guide (chapter Applying SWIFT Microgateway Patch Releases) cannot be applied for going from SWIFT Microgateway 1.0.6.x to SWIFT Microgateway 2.0.2

Migration

You cannot migrate from SWIFT Microgateway 1.0.6.x to SWIFT Microgateway 2.0.2 automatically. You will have to install and configure SWIFT Microgateway 2.0.2 from scratch using either SWIFT Microgateway Microservices, curl script calling SWIFT Microgateway Microservices or SWIFT Microgateway Front-End 2.0.2

Downloads | Swift Developer Portal

Downloads

Swift Microgateway Packages

Changelog

Validate your download