# Release History
source: https://developer.mastercard.com/mdes-token-connect/documentation/pre-release-notes/index.md

## Background {#background}

MDES Token Connect API allows issuers, vendors and processors to push account details to digital wallets, merchants and commerce platforms to create tokens.
The latest API version is fully documented on Mastercard Developers, which provides the definitive specification, and is updated in synchronization with the MDES platform update releases.

MDES and its supporting APIs are developed according to an agile methodology, with new releases deployed to production at regular intervals throughout the year. Plans and features evolve continually, getting locked down shortly in advance of each update.

It is virtually impossible to accurately define and communicate all changes significantly in advance of production availability. However, it is recognized that there needs to be as much warning as possible so that impact to client systems can be managed. This has led to the introduction of the pre-release notification process.

## Pre-Release Notification Process {#pre-release-notification-process}

This page contains Pre-release Notes for the MDES Token Connect Application Programming Interface (API), providing early warning of intended changes and additions to the APIs. Only once the API update has been released to Mastercard Test Facility (MTF) will the specification be updated in the main Mastercard Developers documentation. So the pre-release notes are the only place where coming changes are documented in advance of each MDES platform release.

* If one MDES Platform release impacts MDES Token Connect API, one Token Connect API Pre-release Notification document will be published according to the MDES release calendar. Each document provides up-to-date details of the changes expected, and should be considered accurate at the point of publication.
* If one MDES Platform release doesn't impact MDES Token Connect API, no Pre-release Notification is published.

Note: The MDES Token Connect API is developed in an agile manner and is updated regularly with the MDES Platform Updates. Every effort is made to retain backwards-compatibility as changes occur. To ensure forward-compatibility, all Token Connect API client integrations must be resilient to the addition of new optional elements being added to requests and responses. Existing implementations should strive to keep updated to the latest API version available with each new MDES Platform Update release.

Every effort will be made to provide as much warning of change as possible, with a target of providing at least 3 months' notice.

Changes that are expected to impact client systems will be called out in the Pre-release Notification. Changes that are more informational and not expected to impact client systems may also be included. The latter may only be published a short period before the production release date.

## MDES Token Connect API v2.0 {#mdes-token-connect-api-v20}

This site provides the reference implementation of the MDES Token Connect API v2.0.

|                                                                                    Token Connect API Version                                                                                    | MDES Release  |                                                                              Type of Note                                                                              | Date of Upgrading |
|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------|
| [Release Note June 26](https://developer.mastercard.com/mdes-token-connect/documentation/pre-release-notes/prereleasenote_june2026/index.md)                                                    | 2026 June     | Enhanced the pushMultipleAccounts API by adding new fields and updating existing parameter to support AES Galois/Counter Mode (GCM) cipher mode for enhanced security. | 27 April 2026     |
| [Release Note June 25](https://developer.mastercard.com/mdes-token-connect/documentation/pre-release-notes/prereleasenote_june2025/index.md)                                                    | 2025 June     | New parameters `authenticationCode` and `tokenRequestorSessionId` have been introduced for issuers to support pull provisioning in the pushMultipleAccounts API.       | 1 August 2025     |
| [Release Note Feb 23](https://developer.mastercard.com/mdes-token-connect/documentation/pre-release-notes/prereleasenote_feb2023/index.md)                                                      | 2023 February | Platform Update Notice                                                                                                                                                 | 19 January 2022   |
| [Amendment of Release Note Nov 21](https://developer.mastercard.com/mdes-token-connect/documentation/pre-release-notes/prereleasenote_nov2021_amendment/index.md)                               | 2021 February | Platform Update Notice                                                                                                                                                 | 13 December 2022  |
| [Release Note Jan 23](https://developer.mastercard.com/mdes-token-connect/documentation/pre-release-notes/prereleasenote_jan2023/index.md)                                                      | 2023 Jan      | Platform Update Notice                                                                                                                                                 | 25 Oct 2022       |
| [Release Note April 22](https://developer.mastercard.com/mdes-token-connect/documentation/pre-release-notes/prereleasenote_april2022/index.md)                                                  | 2022 April    | Platform Update Notice                                                                                                                                                 | 10 March 2022     |
| [Release Note Nov 21](https://developer.mastercard.com/mdes-token-connect/documentation/pre-release-notes/prereleasenote_nov2021/index.md)                                                      | 2021 February | Platform Update Notice                                                                                                                                                 | 9 September 2021  |
| [Release Note Feb 21](https://developer.mastercard.com/mdes-token-connect/documentation/pre-release-notes/prereleasenote_feb2021/index.md)                                                      | 2021 February | Platform Update Notice                                                                                                                                                 | 3 December 2021   |
| [Release Note Jan 21](https://developer.mastercard.com/mdes-token-connect/documentation/pre-release-notes/prereleasenote_jan2021/index.md)                                                      | 2021 January  | Platform Update Notice                                                                                                                                                 | 18 November 2021  |
| [mdes-token-connect-api-platform-update-v2019-may.pdf](https://static.developer.mastercard.com/content/mdes-token-connect/uploads/mdes-token-connect-api-platform-update-v2019-may.pdf) (737KB) | 2019 May (Q2) | Platform Update Notice                                                                                                                                                 | 16 May 2019       |

