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.inlink icon for any clarifications/queries.


Note

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 doclink icon

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

  1. 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

  2. UPI Updates - Updated GST functionality to use new encrypt / decrypt functions

  3. Bug fixes for Memory leaks fixes

  4. Dependency updates for sub SDKs (AmazonPay)

Version 2.2.4

Dated: 15-Aug-2025

  1. Framework / Feature upgrades

    • Support for camera functionality invocation via Juspay Safe

    • Support for NB Intent flows

    • Support for WeChatpay and Alipay flows via SDK

  2. UPI Updates 

    • Support for handling lottie files

    • Added AndroidID based identifiers for improved security

    • Support for generic Intent functionality

  3. Bug fixes for Memory leaks fixes and in accessibility modules

  4. Dependency updates for sub SDKs

Version 2.2.3

Dated: 31-May-2025

  1. 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

  2. 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

  3. Added support for biometric authentication by integrating biometric registration and authentication using CredentialManager API of Android

  4. Bug fixes, Memory leak fixes and Improved logging for better analytics

  5. Dependency updates for sub SDKs

Version 2.2.1

Dated: 15-Dec-2024

  1. 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

  2. Performance improvements - ~10% reduction in initiate latency

    • Decrypting files during download rather than load time

  3. Support for targetSDK 35

  4. Bug fixes, Memory leak fixes, security and compliance fixes

  5. Amazon SDK dependency updates

  6. 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.0 to 1.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 targetSdkVersion to 33.

  • Segregated Visa Safe Click code from in.juspay:hypersdk to in.juspay:hypervsc. With this, the deprecated SafetyNet SDK is also removed from HyperSDK.

  • Replaced HttpUrlConnection with HttpsUrlConnection.

  • 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 herelink icon.

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.applink icon.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 herelink icon

  • 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.