{"id":15554,"date":"2024-03-28T11:33:59","date_gmt":"2024-03-28T06:03:59","guid":{"rendered":"https:\/\/razorpay.com\/blog\/?p=15554"},"modified":"2025-09-30T11:37:39","modified_gmt":"2025-09-30T06:07:39","slug":"razorpay-payments-sdk-upgrades-guide","status":"publish","type":"post","link":"https:\/\/razorpay.com\/blog\/razorpay-payments-sdk-upgrades-guide\/","title":{"rendered":"A Comprehensive Guide to Razorpay Payments SDK Upgrades"},"content":{"rendered":"

In our previous Razorpay Payments SDK upgrades blog post, we delved into the latest enhancements introduced to the Razorpay Payments SDK, highlighting the myriad of upgrades designed to elevate your payment integration experience. Now, armed with knowledge of these enhancements, it’s time to embark on the journey of upgrading your SDKs to leverage these cutting-edge features.<\/span><\/p>\n

This comprehensive guide serves as your roadmap, providing step-by-step instructions tailored to each platform\u2014Android, iOS, React Native, Capacitor, and Ionic\u2014ensuring a seamless transition to the latest versions of Razorpay SDKs.\u00a0<\/span><\/p>\n

So, without further ado, let’s dive into the world of SDK upgrades and unlock the full potential of Razorpay Payments for your applications.<\/span><\/p>\n

Read about our latest enhancements to Razorpay Payments SDK upgrades <\/span>here<\/span><\/a><\/strong>.<\/strong>\u00a0<\/span><\/span><\/p>\n

How to Check Your Razorpay SDK Version?<\/span><\/h2>\n

Note:<\/strong> Before diving into the upgrade process, check out our blog on Introducing Auto-Update for Razorpay\u2019s Native Android SDKs <\/a>to learn how the auto-update feature simplifies SDK management and keeps you up to date with the latest versions automatically.<\/p>\n

Android Native<\/span><\/h3>\n

1. Open your Android project in Android Studio.
\n2. Navigate to the `build.gradle` file of your app module (usually `app\/build.gradle`).
\n3. Look for the `dependencies` block in the file.
\n4. Find the line that includes the Razorpay SDK dependency.
\n5. The version number will be alongside the SDK name in the format`x.y.z`.<\/p>\n

iOS Native<\/span><\/h3>\n

1. Open your iOS project in Xcode.
\n2. In the project navigator, locate the `Podfile` in the root directory of your project.
\n3. Open the `Podfile` and look for the line that specifies the Razorpay SDK pod.
\n4. The version number is represented by `x.y.z`.<\/p>\n

Cordova<\/span><\/h3>\n

1. Open your Cordova project in your preferred code editor.
\n2. Navigate to the `config.xml` file in the root directory of your project.
\n3. Look for the `<plugin>` tag that includes the Razorpay SDK plugin.
\n4. The version number is represented by `x.y.z`.<\/p>\n

Ionic<\/span><\/h3>\n

1. Open your Ionic project in your preferred code editor.
\n2. Open the `package.json` file in the root directory of your project.
\n3. In the `dependencies` section, look for the razorpay entry.
\n4. The version number is specified next to the package name in the format `x.y.z`.<\/p>\n

Flutter<\/span><\/h3>\n

1. Open your Flutter project in your preferred code editor.
\n2. Open the `pubspec.yaml` file in the root directory of your project.
\n3. In the `dependencies` section, look for the razorpay entry.
\n4. The version number is specified next to the package name in the format x.y.z.<\/p>\n

Capacitor<\/span><\/h3>\n

1. Open your Capacitor project in your preferred code editor.
\n2. Open the `package.json` file in the root directory of your project.
\n3. In the `dependencies` section, look for the razorpay entry.
\n4. The version number is specified next to the package name in the format x.y.z.<\/p>\n

Note:<\/strong> Below are the minimum supported versions that meet compliance standards. Any version above these will also be compliant.<\/p>\n\n\n\n\n\n
<\/td>\nNative Android<\/span><\/td>\nNative iOS<\/span><\/td>\nReact Native<\/span><\/td>\nIonic<\/span><\/td>\nCordova<\/span><\/td>\nFlutter<\/span><\/td>\nCapacitor<\/span><\/td>\n<\/tr>\n
Standard Checkout<\/span><\/td>\n\n
\n
\n
1.6.41<\/div>\n<\/div>\n<\/div>\n<\/td>\n
\n
\n
\n
1.3.6<\/div>\n<\/div>\n<\/div>\n<\/td>\n
2.2.9<\/span><\/td>\nNA<\/span><\/td>\n\n
\n
\n
1.4.15<\/div>\n<\/div>\n<\/div>\n<\/td>\n
1.3.3<\/span><\/td>\n1.1.1<\/span><\/td>\n<\/tr>\n
Custom Checkout<\/span><\/td>\n3.8.7<\/span><\/td>\n2.0.10<\/span><\/td>\n2.2.2<\/span><\/td>\nNA<\/span><\/td>\nNA<\/span><\/td>\n1.3.0<\/span><\/td>\nNA<\/span><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

Razorpay Payments SDK Upgrades<\/span><\/h2>\n

Upgrading Android SDKs<\/span><\/h2>\n

Standard:<\/span><\/h3>\n

To upgrade the Standard Android SDK, follow these steps:<\/span><\/p>\n

Check the Latest Version<\/b>: Check the latest version of Standard Checkout <\/span>here<\/span><\/a>.
\n<\/span><\/p>\n

Update Gradle: <\/b>In the app-level Gradle build file, update the SDK version to the latest release.<\/span><\/p>\n\n\n\n
dependencies {<\/span>
\n<\/span>\/\/\u00a0 \u00a0 … other dependencies<\/span>
\n<\/span>\/\/\u00a0 For Razorpay checkout SDK<\/span>
\n<\/span>\u00a0 implementation <\/span>‘com.razorpay:checkout:<latest-version-number-goes-here>’<\/span>
\n<\/span>\/\/\u00a0 \u00a0 … other dependencies<\/span>
\n<\/span>\u00a0 <\/span>
\n<\/span>}<\/span><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

 <\/p>\n

Sync Gradle:<\/b> Once the Gradle syncs, inspect for compile-time errors and refactor the code to accommodate any newer changes.<\/span><\/p>\n

Sanity Check:<\/b> Perform a thorough check to ensure all changes are correctly implemented. If everything looks good, your upgrade is complete.<\/span><\/p>\n

Note- Minimum compliant version required.<\/p>\n

Custom:<\/span><\/h3>\n

To upgrade the Custom Android SDK, follow similar steps:<\/span><\/p>\n

Check the Latest Version:<\/b> Check the latest version of Custom Checkout <\/span>here<\/span><\/a>.\u00a0<\/span><\/p>\n

Update Gradle:<\/b> In the app-level build.gradle file, update the SDK version in the dependencies section.<\/span><\/p>\n\n\n\n
dependencies {<\/b>
\n<\/b>\/\/\u00a0 \u00a0 … other dependencies<\/b>
\n<\/b>\/\/\u00a0 For Razorpay checkout SDK<\/b>
\n<\/b>\u00a0 implementation <\/b>‘com.razorpay:customui:<\/b><latest-version-number-goes-here><\/span>‘<\/b>
\n<\/b>\/\/\u00a0 \u00a0 … other dependencies<\/b>
\n<\/b>\u00a0 <\/b>
\n<\/b>}<\/b><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

 <\/p>\n

Sync Gradle:<\/b> After updating, sync Gradle and check for any compile-time errors.<\/span><\/p>\n

Sanity Check:<\/b> Ensure all changes are correctly integrated and the application functions as expected.<\/span><\/p>\n

Upgrading iOS SDKs<\/span><\/h2>\n

Standard:<\/span><\/h3>\n

For upgrading the Standard iOS SDK, adhere to the following steps:<\/span><\/p>\n

Update Podfile:<\/b> In your project’s Podfile, specify the latest version of the SDK. Click <\/span>here<\/span><\/a> to learn more about the update. <\/span>
\n<\/span><\/p>\n

Note:<\/strong> Not mentioning any version will automatically pick the latest version from Cocoapods.<\/span><\/p>\n\n\n\n
platform :ios, ‘11.0’<\/span><\/p>\n

target ‘ProjectName’ do<\/span><\/p>\n

\u00a0\u00a0use_frameworks!<\/span><\/p>\n

\u00a0\u00a0pod <\/span>‘razorpay-pod’<\/span><\/p>\n

end<\/span><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

 <\/p>\n

Update Pods:<\/b> Run <\/span>pod repo update<\/span> to fetch the latest release versions of the pods.<\/span><\/p>\n

Sanity Check:<\/b> After updating, ensure that the integration is successful and there are no issues with the updated SDK.<\/span><\/p>\n

Custom:<\/span><\/h3>\n

For the Custom iOS SDK upgrade:<\/span><\/p>\n

Update Podfile: <\/b>Similar to the Standard SDK, update the Podfile with the latest version of the Custom SDK. Click <\/span>here<\/span><\/a> to learn more about the update.\u00a0<\/span><\/p>\n

Note:<\/strong> Not mentioning any version will automatically pick the latest version from Cocoapods.<\/span><\/p>\n\n\n\n
platform :ios, ‘11.0’<\/span><\/p>\n

target ‘ProjectName’ do<\/span><\/p>\n

\u00a0\u00a0use_frameworks!<\/span><\/p>\n

\u00a0\u00a0pod <\/span>‘razorpay-customui-pod’<\/span>\u00a0<\/span><\/p>\n

end<\/span><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

 <\/p>\n

Run Pod Update: <\/b>Execute <\/span>pod repo update<\/span> to fetch the latest release versions of the pods.<\/span><\/p>\n

Verify Integration:<\/b> Verify that the updated SDK integrates seamlessly with your project and doesn’t cause any disruptions.<\/span><\/p>\n

Upgrading React Native \/ Capacitor \/ Ionic Package with NPM<\/span><\/h2>\n

For upgrading these packages using npm:<\/span><\/p>\n

Navigate to Project Directory:<\/b> Open a terminal or command prompt and navigate to your project directory where the package.json file resides.<\/span><\/p>\n

Update Specific Package:<\/b> Use the npm update command followed by the package name to update a specific package to its latest version.<\/span><\/p>\n

Example:<\/b><\/p>\n

npm<\/span> update<\/span> <razorpay_package_name><\/span><\/p>\n