JavaScript is disabled. Some features may not work. You can also read the static version: View text version

WebView SDK for Intent flows

Merchants integrating payment page via Juspay and rendering the same on webviews run into a restriction of not having UPI Intent support. This is because Android’s webview, by default, doesn’t provide intent support and hence we would not be able to either check for intent apps in the user’s device or make an intent switch to the corresponding app.

To work around this inherent restriction from Android and to have a near-native experience on WebView, we have made a lightweight SDK solution, which adds a JavaScriptInterface to register functionalities to fetch available UPI apps, and make payment with them natively, instead of handling the Intent URI. These functions are then called from the our existing code running in hyper-sdk-web. Listing below the steps to integrate the same

Step 1.1

Getting the SDK

Android

Add the SDK maven repository to the allprojects repository in the root build.gradle file:
Add the SDK dependency in your app’s build.gradle:

iOS

Add the SDK dependency in Podfile:
Add URI Schemes for required UPI Apps in Info.plist

Step 1.2

Integrating the SDK

Android

Create an object of HyperWebViewServices, which takes activity and webview as parameters when WebView object is created.
Call attach method of HyperWebViewServices when URL is loaded in the WebView:
Pass the activity result to SDK by overriding the onActivityResult method in the activity passed in Step-1:

iOS

Create instance of HyperWebViewServices in didCommit callback of WebView, initialise the instance with following arguments and call attach method on it.

webview : Reference to your webview
isIframeIntegration : Send true if integrationType is iFrame (Juspay payment page is rendered inside an iFrame) otherwise send false.

Note: Ideally hyper.attach should be called on the page where Juspay’s payment page is loaded.

Have questions?
Need help? Contact support
LLM? Read llms.txt