# Upgrade your API version
source: https://developer.mastercard.com/mastercard-gateway/documentation/tutorials-and-guides/migration-guides/upg-api-version/index.md

## Why you should upgrade {#why-you-should-upgrade}

Following are the reasons for upgrading your API version:

* Mastercard is undertaking a strategic initiative to simplify interactions with Mastercard Gateway.
* As part of this initiative, the support for older versions of the Payment Gateway APIs will be discontinued.
* The oldest version of the API, dating back to 2010, is considered outdated.
* This version is no longer fit for purpose and in some cases, it is also no longer compliant with current standards.

## Migration toolkit {#migration-toolkit}

To support you through this Gateway APIs transition, we have prepared comprehensive resources to facilitate a smooth upgrade:

* Migration guides for upgrading from select API versions to version 100.
* [Postman examples](https://gateway.mastercard.com/api/documentation/downloads/index.html?locale=en_US#h2_Postman_Collection) for version 100 are now available to assist with the upgrade process.
* We have a detailed [Changelog](https://gateway.mastercard.com/api/documentation/apiDocumentation/nvp/version/latest/changelog.html?locale=en_US) documenting all modifications in the new API versions.
* Follow the steps on how to test your migrated API versions.

## Before you begin {#before-you-begin}

![](https://static.developer.mastercard.com/content/mastercard-gateway/uploads/upgradeYourAPIVersion.png)

## Choose your integration type {#choose-your-integration-type}

To migrate from a legacy version of the Gateway API, follow the guide that most closely represents your current integration and features.

Warning: These Migration guides are intended to serve as **high-level overviews** of the key differences and potential issues when transitioning between API versions. However, due to the complexity and variability of real-world implementations, **they cannot account for every possible integration scenario** .  
Developers should treat these guides as a starting point and perform thorough testing and validation against their specific use cases, data flows, and business logic. Always consult the API references and changelog for the most accurate and complete information.

<br />

|                                                       If your current integration is...                                                       |     Operation     | Integration is available from |                                                                                                       Upgrade to version 100                                                                                                       |
|-----------------------------------------------------------------------------------------------------------------------------------------------|-------------------|-------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| [Hosted checkout](https://developer.mastercard.com/mastercard-gateway/documentation/api-reference/v100/rest/api-ops/index.md#hosted-checkout) | Initiate Checkout | 63+                           | [This guide](https://developer.mastercard.com/mastercard-gateway/documentation/tutorials-and-guides/migration-guides/mig-hosted-checkout-v100/index.md) walks you through the latest changes to help you upgrade your integration. |

|                                                       If your current integration is...                                                       |                      Operation                       | Integration is available from |                                                                                                      Upgrade to version 100                                                                                                       |
|-----------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------|-------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| [Hosted session](https://developer.mastercard.com/mastercard-gateway/documentation/api-reference/v100/rest/api-ops/index.md#session): Session | Create a checkout session                            | 27 to 62                      | [This guide](https://developer.mastercard.com/mastercard-gateway/documentation/tutorials-and-guides/migration-guides/mig-hosted-session-v100/index.md) walks you through the latest changes to help you upgrade your integration. |
|                                                                                                                                               | Create a checkout session                            | 27 to 62                      |                                                                                                                                                                                                                                   |
|                                                                                                                                               | Retrieve session                                     | 18+                           |                                                                                                                                                                                                                                   |
|                                                                                                                                               | Update Session                                       | 18+                           |                                                                                                                                                                                                                                   |
|                                                                                                                                               | Create Payment Page Session                          | 17 to 26                      |                                                                                                                                                                                                                                   |
|                                                                                                                                               | Authorize with session                               | 2 to 3                        |                                                                                                                                                                                                                                   |
|                                                                                                                                               | Create Session                                       | 2+                            |                                                                                                                                                                                                                                   |
|                                                                                                                                               | Pay with session                                     | 2 to 3                        |                                                                                                                                                                                                                                   |
|                                                                                                                                               | Save Card (with system-generated token) with Session | 2 to 3                        |                                                                                                                                                                                                                                   |
|                                                                                                                                               | Save Card with Session                               | 2 to 3                        |                                                                                                                                                                                                                                   |

|                                                           If your current integration is...                                                           |               Operation                | Integration is available from |                                                                                                      Upgrade to version 100                                                                                                       |
|-------------------------------------------------------------------------------------------------------------------------------------------------------|----------------------------------------|-------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| [Direct payment](https://developer.mastercard.com/mastercard-gateway/documentation/api-reference/v100/rest/api-ops/index.md#transaction): Transaction | Authorize                              | All versions                  | [This guide](https://developer.mastercard.com/mastercard-gateway/documentation/tutorials-and-guides/migration-guides/mig-direct-payment-v100/index.md) walks you through the latest changes to help you upgrade your integration. |
|                                                                                                                                                       | Balance Inquiry                        | 46+                           |                                                                                                                                                                                                                                   |
|                                                                                                                                                       | Capture                                | All versions                  |                                                                                                                                                                                                                                   |
|                                                                                                                                                       | Disbursement                           | 62+                           |                                                                                                                                                                                                                                   |
|                                                                                                                                                       | Pay                                    | All versions                  |                                                                                                                                                                                                                                   |
|                                                                                                                                                       | Referral                               | 4+                            |                                                                                                                                                                                                                                   |
|                                                                                                                                                       | Refund                                 | All versions                  |                                                                                                                                                                                                                                   |
|                                                                                                                                                       | Retrieve order                         | 11+                           |                                                                                                                                                                                                                                   |
|                                                                                                                                                       | Retrieve Transaction                   | All versions                  |                                                                                                                                                                                                                                   |
|                                                                                                                                                       | Update Application Transaction Counter | 100                           |                                                                                                                                                                                                                                   |
|                                                                                                                                                       | Update Authorization                   | 11+                           |                                                                                                                                                                                                                                   |
|                                                                                                                                                       | Verify                                 | 7+                            |                                                                                                                                                                                                                                   |
|                                                                                                                                                       | Void                                   | 4+                            |                                                                                                                                                                                                                                   |

|                                                    If your current integration is...                                                    |  Operation  | Integration is available from |                                                                                                     Upgrade to version 100                                                                                                      |
|-----------------------------------------------------------------------------------------------------------------------------------------|-------------|-------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| [Hosted batch](https://developer.mastercard.com/mastercard-gateway/documentation/api-reference/v100/rest/api-ops/index.md#batch): Batch | Close Batch | 4+                            | [This guide](https://developer.mastercard.com/mastercard-gateway/documentation/tutorials-and-guides/migration-guides/mig-hosted-batch-v100/index.md) walks you through the latest changes to help you upgrade your integration. |

## Support {#support}

We understand that API migrations can be complex, and we are committed to supporting you throughout this process. Contact our dedicated support team if you have any questions or require additional assistance. If you need technical support during your migration to version 100, contact your Mastercard account manager or email the [support team](mailto:gateway_support@mastercard.com).