Additional Support for Payment Methods

UPI Intent support on Target SDK Version 30 and above
UPI Intent on Recurring Payments
Card Utilities
Fetch Logo
Validate Data
Custom WebViewClient and WebChromeClient

UPI Intent Support: Target SDK Version 30+

If your application targetSdkVersion is 30 or above, add the following code in your app’s manifest file to support the UPI Intent flow.

AndroidManifest.xml

Handy Tips

Refer to the list of supported UPI apps.
Additionally, we recommend you to create 2 sections - Primary and Others. Under Primary, display the following 4 apps:
GPay
PhonePe
Paytm
BHIM

UPI Intent on Recurring Payments

Configure and initiate a recurring payment transaction on UPI Intent:

Watch Out!This is an on-demand feature. Please raise a request with our Support team to get it enabled on your Razorpay account.

Java

JSONObject options = new JSONObject();
options.put("name", "Gaurav Kumar");
options.put("description", "Reference No. #123456");
options.put("image", "http://example.com/image/rzp.jpg");
options.put("order_id", "order_DBJOWzybf0XXXX"); // from response of order creation step
options.put("theme.color", "#3399cc");
options.put("currency", "INR");
options.put("amount", "50000"); // pass amount in currency subunits
options.put("prefill.email", "gaurav.kumar@example.com");
options.put("prefill.contact", "9000090000");

JSONObject retryObj = new JSONObject();
retryObj.put("enabled", true);
retryObj.put("max_count", 4);
options.put("retry", retryObj);

options.put("recurring", 1);
options.put("customer_id", "cust_xxxxxxxxx");

options.put("method", new JSONObject().put("upi", true));
```kotlin: Kotlin
val options = JSONObject()

options.put("name", "Gaurav Kumar")
options.put("description", "Reference No. #123456")
options.put("image", "http://example.com/image/rzp.jpg")
options.put("order_id", "order_DBJOWzybf0XXXX") // from response of order creation step
options.put("theme.color", "#3399cc")
options.put("currency", "INR")
options.put("amount", "50000") // pass amount in currency subunits
options.put("prefill.email", "gaurav.kumar@example.com")
options.put("prefill.contact", "9000090000")

val retryObj = JSONObject()
retryObj.put("enabled", true)
retryObj.put("max_count", 4)
options.put("retry", retryObj)

options.put("recurring", 1)
options.put("customer_id", "cust_xxxxxxxxx")
options.put("method", JSONObject().put("upi", true))

Card Utilities

You can use these methods for card payment method integration.

Fetch card network
Validate card number
Fetch card number length of a card network

Fetch Card Network

The SDK provides a method to get the card network name of the provided card number.

At least 6 digits of the card number are required to identify the network.
Possible values returned by this method are visa, mastercard and unknown.
If it is not able to identify the network it returns unknown.

Fetch Card Network

razorpay.getCardNetwork(cardNumber);

Validate Card Number

You can determine the validity of the card number entered using the isValidCardNumber method. This is a checksum-based method to determine if the entered card number is valid or not.

Card Number Validation

razorpay.isValidCardNumber(cardNumber);

Fetch Card Number Length for Card Network

You can fetch the length of a card number for a specific card network using the getCardNetworkLength method.

Fetch Length for Card Network

razorpay.getCardNetworkLength(cardNetworkName);

Logo

You can use the respective methods to fetch:

Bank Logo URL
Wallet Logo URL
Square-shaped Wallet Logo URL

Fetch Bank Logo URL

The SDK provides a method to fetch the bank logo’s URL, here bankCode is the code of bank, you will be able to get it from the response received in onPaymentMethodsReceived callback.

Fetch Bank Logo URL

razorpay.getBankLogoUrl(bankCode);

Fetch Wallet Logo URL

The SDK provides a method to get the wallet logo’s URL.

Fetch Wallet Logo URL

razorpay.getWalletLogoUrl(walletName);

Fetch Wallet Square Logo URL

The SDK provides a method to get the wallet’s square-shaped logo’s URL.

Fetch Wallet Square Logo URL

razorpay.getWalletSqLogoUrl(walletName);

Data Validation

The SDK provides basic validation for the payment data JSONObject. In case of a validation error, the SDK returns an error map in the onValidationError callback function.

Sample Code

The sample code shown below describes a validation error on the contact field:

Data Validation

razorpay.validateFields(payload, new Razorpay.ValidationListener() {
	@Override
	public void onValidationSuccess() {
		try {
		  razorpay.submit(payload);
		} catch (Exception exception){}
	}

	@Override
	public void onValidationError(Map error) {
		/**
		 * The format for returned map is:
		 *   "field" : "contact"
		 *   "description" : "Descriptive error message"
		 */
		Toast.makeText(activity, "Validation: " + error.get("field") + " " + error.get("description"), Toast.LENGTH_SHORT).show();
	}
});

Custom `WebViewClient` and `WebChromeClient`

Our SDK sets an instance of RazorpayWebViewClient and RazorpayWebChromeClient to the Webview passed to facilitate bank page optimizations. If you want to set your own custom WebViewClient you have to extend RazorpayWebViewClient and pass it to our SDK.

Watch Out!This step is optional and is only required when you want to set a custom WebViewClient/WebChromeClient

Sample Code

The sample code given below shows how to customize the RazorpayWebViewClient:

Customize RazorpayWebViewClient

/**
 * Extend the RazorpayWebViewClient for your custom hooks
 */
razorpay.setWebviewClient(new RazorpayWebViewClient(razorpay){

  @Override
  public void onPageStarted(WebView view, String url, Bitmap favicon) {
      // Make sure you do not forget to call the super method
      super.onPageStarted(view, url, favicon);
      Log.d(TAG, "Custom client onPageStarted");
  }

  @Override
  public void onPageFinished(WebView view, String url) {
      // Make sure you do not forget to call the super method
      super.onPageFinished(view, url);
      Log.d(TAG, "Custom client onPageFinished");
  }
});

Similarly, you can set your own WebChromeClient:

Set WebChromeClient

/**
 * Extend the RazorpayWebChromeClient for your custom hooks
 */
razorpay.setWebChromeClient(new RazorpayWebChromeClient() {
	@Override
	public void onProgressChanged(WebView view, int newProgress) {
		// Make sure you do not forget to call the super method
		super.onProgressChanged(view, newProgress);
		customProgressBar.setProgress(newProgress);
	}
});

​UPI Intent Support: Target SDK Version 30+

​UPI Intent on Recurring Payments

​Card Utilities

​Fetch Card Network

​Validate Card Number

​Fetch Card Number Length for Card Network

​Logo

​Fetch Bank Logo URL

​Fetch Wallet Logo URL

​Fetch Wallet Square Logo URL

​Data Validation

​Sample Code

​Custom WebViewClient and WebChromeClient

​Sample Code

UPI Intent Support: Target SDK Version 30+

UPI Intent on Recurring Payments

Card Utilities

Fetch Card Network

Validate Card Number

Fetch Card Number Length for Card Network

Logo

Fetch Bank Logo URL

Fetch Wallet Logo URL

Fetch Wallet Square Logo URL

Data Validation

Sample Code

Custom `WebViewClient` and `WebChromeClient`

Sample Code