Android - Release Notes
If you are using an older version of the Android Hyper SDK for Express Checkout or Juspay Safe, please upgrade to the latest version to take advantage of new functionality and security upgrades.
Please reach out to support@juspay.in for any clarifications/queries.
For SDK versions greater than 2.0.4-rc.34, it is mandatory to integrate the Gradle Plugin as well
For SDK versions greater than 2.1.13, kindly update to the latest Gradle plugin - 2.0.7. In case you are on an older version, kindly refer to the migration doc
For SDK plugin versions above 2.0.x, kindly remove any 3rd party wallet dependencies (Eg., AmazonPay Hardened SDK dependencies, etc.,) as they’re internally handled by the plugin build-time
Version 2.2.5
Dated: 30-Sep-2025
Framework / Feature upgrades
Separated out Over-the-air functionality as a separate module in HyperSDK
Added support for Cred unbundle flows
Added support for PermissionRequest override in Juspay Safe
Support for custom QR generation - color and logo flexibility
UPI Updates - Updated GST functionality to use new encrypt / decrypt functions
Bug fixes for Memory leaks fixes
Dependency updates for sub SDKs (AmazonPay)
Version 2.2.4
Dated: 15-Aug-2025
Framework / Feature upgrades
Support for camera functionality invocation via Juspay Safe
Support for NB Intent flows
Support for WeChatpay and Alipay flows via SDK
UPI Updates
Support for handling lottie files
Added AndroidID based identifiers for improved security
Support for generic Intent functionality
Bug fixes for Memory leaks fixes and in accessibility modules
Dependency updates for sub SDKs
Version 2.2.3
Dated: 31-May-2025
Framework upgrades
Accessibility support in Android
Support for Android 15 behavioral changes - E2E UI changes, etc.,
Security updates - Removal of support for TLS v1.1 as mandated by Android
Support to remove files, if parsing fails
Improved task execution management by using a dedicated thread pool for process queueing
UPI Updates
Fetching Geocode/location details for risk check
Incorporated integrity token checks
Added functionality to retrieve contact list, geocode and location from user device
Added JWE encryption decryption and JWS signing and verification
Moved GetSessionToken handling to native for improving performance
Added support for biometric authentication by integrating biometric registration and authentication using CredentialManager API of Android
Bug fixes, Memory leak fixes and Improved logging for better analytics
Dependency updates for sub SDKs
Version 2.2.1
Dated: 15-Dec-2024
Framework upgrades
Support for faster adoption of OTA updates - even single-run
Name-spacing to support multi client ID use-cases for superApps
Multi-tenant and multi-region support
Removed webview dependency for file downloads
Logging optimizations and improvements
Flushing of logs on onPause
Performance improvements - ~10% reduction in initiate latency
Decrypting files during download rather than load time
Support for targetSDK 35
Bug fixes, Memory leak fixes, security and compliance fixes
Amazon SDK dependency updates
Client caching fixes during build update
Version 2.1.33
Dated: 29-Jul 2024
Update AGP version from 7.4.2 to 8.3.1
Integrate okhttp3 library and replaced android's default HttpsUrlConnection to enable support for HTTP/2
Migrated various micro SDKs to Kotlin
Removed READ_PHONE_STATE permission from Hyper SDK's AndroidManifest
Added support to recreate WebView on trigger of onRenderProcessGone
Upgraded Amazon Pay integrations to use Amazon Pay Super SDK
Added a fix to attempt to recreate WebView instance when it failed
Removed usage of subscriber ID for UPI flows
Reliability improvement and linting fixes
Note: If you are using AmazonPay tokenized flow on an older SDK, kindly upgrade to our most recent versions - 2.2.1
Version 2.1.25
Dated: 15-Mar 2024
Integrated Juspay’s in-house 3DS 2.0 SDK, Trident, as an opt-in module.
Added support for onBackPressedDispatcher to avoid integration construct for
HyperServices.onBackPressed()Updated appcompat library version from
1.0.0to1.1.0
Version 2.1.24
Dated: 13-Feb 2024
Minor bug fixes and enhancements.
Version 2.1.22
Dated: 19-Jan 2024
Removed fetching of device ID.
Improved reflection framework capabilities.
Version 2.1.21
Dated: 12-Jan 2024
Updated targetSdkVersion to 34 (Android 14)
Improvements to SDK analytics and logging framework refactor
Fixed an edge-case in cache clearing on SDK version upgrade
Added intent redirection support for UPI and similar schemes in Juspay Safe
Other minor bug fixes
Version 2.1.20 [Important]
Dated: 14-Nov 2023
Added NFC Module for providing enhanced user experience to read card numbers (Only available if opted-in)
Added RECEIVER_EXPORTED for BroadcastReceivers to comply with the latest Android guidelines for system broadcasts.
Fixed WebView issue of JavaScriptInterface not being attached for some cases in react-native.
Remove VSC Module as this feature has been suspended by RBI.
Version 2.1.19
Dated: 20-Oct 2023
Enabled bundle load retry for all micro-apps
Added more milestone and error analytic logs
Removed Safe Mode SDK from Hyper SDK
Handle edge cases for some of iFrame Bank Pages
Fixed rare instances of IllegalStateException in case of permission(s) being asked before fragment is attached
Version 2.1.18
Dated: 22-Sep 2023
Upgraded build to use AGP 7.4.2
Fixed a NullPointerException in setBundleParameters method.
Fixed a ClassCastException in Juspay Safe Browser flow.
Version 2.1.16
Dated: 20-Aug 2023
Added more capabilities in Reflection framework
Version 2.1.15
Dated: 9-Aug 2023
Improved SDK analytics framework and added support to ensure critical logs are sent in priority
Added iframe and POST support for bank Web pages to facilitate 3DS 2.0 browser based flow
Replaced the usage of Android ID with a uniquely generated UUID
Upgraded minSdkVersion to 21
Added retry for bundle load if it fails (EC, UPI Intent)
Version 2.1.14
Dated: 4-Jul 2023
Updated Amazon Pay dependencies to support SSO flow
Moved WebView instance creation to the constructor of HyperServices
Segregated third party dependent flows (AmazonPay Wallet, SIMPL, PayPal, Google Pay In-app) from the main HyperSDK into separate modules
Version 2.1.13
Dated: 5-May 2023
Refactored SMS Consent flow and fixed a crash which resulted in too many receivers being registered.
Corrected WebView availability check, and giving JP_020 in initiate as well.
Improved performance of UI rendering.
Version 2.1.12
Dated: 24-March 2023
Updated
targetSdkVersionto 33.Segregated Visa Safe Click code from
in.juspay:hypersdktoin.juspay:hypervsc. With this, the deprecated SafetyNet SDK is also removed from HyperSDK.Replaced
HttpUrlConnectionwithHttpsUrlConnection.Fixed ANRs in SMS Consent flow for certain edge cases.
Fixed the bug of Cancel button not clickable in certain bank pages.
Version 2.1.11
Dated: 25-January 2023
Decoupled Fragment Lifecycle from SDK boot up and Juspay Safe business code.
Annotated member variables with either @Nullable or @NonNull, based on its source; and it’s handled accordingly in code to avoid any NullPointerException.
Moved all analytics operations on a shared single thread executor.
Using application context as much as possible instead of Activity and/or Fragment.
Moved UPI InApp related code from HyperSDK module to HyperUPI module.
Added support for AmazonPayUPI flow via a new SDK.
Removed deprecated APIs from HyperServices.
Changed the signature of JuspayWebViewConfigurationCallback. The interface method has been changed from configureJuspayWebView(JuspayWebView juspayWebView) to configureJuspayWebView(WebView juspayWebView).
Version 2.1.7
Dated: 14-November 2022
Fixed an edge case on incorrect error being thrown if initiate, process, and terminate are called on separate threads consecutively.
Enhanced implementation of SDK Analytics Logger which was causing OutOfMemoryError in certain cases.
Crash fixes:
Occasional NullPointerException while trying to fetch MemoryInfo.
java.lang.NullPointerException: Attempt to invoke virtual method 'void in.juspay.hypersdk.core.DynamicUI.resetActivity()
java.lang.NullPointerException: Attempt to invoke virtual method 'int android.view.View.getId()' on a null object reference
Rare StackOverflowError in AnimationHandler.
Added Javadoc for all exposed APIs.
HyperServices.preFetch(context, clientId) is deprecated and will be removed in future SDK versions. Please use HyperServices.preFetch(context, payload) instead. Refer here
.
Version 2.1.4
Dated: 11-October 2022
Crash fixes:
java.lang.NullPointerException: Attempt to invoke virtual method 'java.lang.Boolean in.juspay.hypersdk.HyperFragment.isWebViewAvailable()' on a null object reference
Fatal Exception: java.lang.IllegalStateException: Fragment already added: HyperFragment
java.lang.NullPointerException: Attempt to invoke virtual method 'in.juspay.hypersdk.core.SdkTracker in.juspay.hypersdk.core.JuspayServices.getSdkTracker()' on a null object reference
java.lang.NullPointerException: Attempt to invoke virtual method 'void in.juspay.mystique.DynamicUI.setActivity(android.app
.Activity)' on a null object reference
Fixed memory leaks:
Context leak while initiating SimplFingerprint SDK
Activity leak in SMS User Consent Flow
Disabled Chromium logs from Android Logcat
Version 2.1.2 [Important & Mandatory]
Dated: 11-August 2022
Merged in.juspay:mystique into in.juspay:hypersdk, and made its core classes package-private.
Minimised the JavaScriptInterface added in the WebView of third party bank and wallet pages.
Version 2.0.4-rc.78 [Important]
Dated: 01-July 2022
Removed querying all installed apps on user’s device.
Throwing correct error if process is called before initiate.
Fixed ANR issue while creating log-line.
Fixed crash in SmsConsentHandler.
Removed fetching of user's device's MAC address.
Removed spamming of DUI Logs in Android logcat.
Version 2.0.4-rc.34
Dated: 14-Feb 2022
Updated targetSdkVersion to 31.
Integrated new S2S SDKs provided by AmazonPay compatible with API 31.
Added TLS Handshake to do a HEAD call to make network calls to server faster.
Fixed multiple NullPointerExceptions while referencing activity in Multi-activity integration.
Reduced OutOfMemory Exceptions while pushing logs to the analytics.
Added delegates for onActivityResult and onRequestPermissionResult. Refer here
Fixed a minor crash in an edge-case while calling HyperServices.terminate()
Added support to integrate Minkasu SDK.
Version 2.0.3-rc.78
Dated: 29-Sep 2021
Fix for Juspay Safe failing to load fragment, when multiple processes are run on the same instance
Removed onWebViewReady from HyperPaymentsCallback
Removal of unused network_security_config.xml
Process queuing logic, now supports more than one process.
Removed SMS permission from SDK manifest (This must be added manually)
Removed setRequestedOrientation from initiate. SDK will now use same orientation as the merchant app. Earlier sdk used to force the app to portrait on initiate
Improvements in SDK side Analytics
Version 2.0.3-rc.03
Dated: 22-June 2021
Improvement in speed of file downloads in the sdk.
Removal of non critical error logs, which were interpreted as errors during integration of the sdk.
Version 2.0.2-rc.83
Dated: 20-May 2021
Added new payment instruments cred pay, paytm all in one sdk.
Version 2.0.2-rc.67 [Important]
Dated: 26-April 2021
Android 11 ready version of Hyper SDK
Due to recent changes implement in Android 11 by Google, our merchant partners upgrading to API Level 30 were unable to fetch UPI app info from the user device. The relevant manifest file changes are added on this SDK version for eliminating this problem.

