Additional Support for Payment Methods

Additional support features available for card, netbanking, wallets and more.


Use the Razorpay Android Standard SDK to integrate supported payment methods on the Checkout form of your Android app as per your business requirements. Here are some additional methods provided by the SDK for the integration and usage of payment methods:

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.

Copy<queries> <!-- List of apps which you want to support for Intent pay --> <package android:name="com.google.android.apps.nbu.paisa.user" /> <package android:name="com.phonepe.app"/> <!-- Specific intents you query for, eg: for a custom share UI --> <intent> <action android:name="android.intent.action.SEND" /> </intent> </queries>

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

Card Utilities🔗

You can use these methods for card payment method integration.

  • Fetch card network
  • Verify the validity of a 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, maestro16, amex, rupay, maestro, diners and unknown.
  • If it is not able to identify the network it returns unknown.
Copyrazorpay.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.

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

Copyrazorpay.getCardNetworkLength(cardNetworkName);

Logo🔗

Given below are the methods provided by the SDK to support netbanking and wallet payments. You can use these 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.

Copyrazorpay.getBankLogoUrl(bankCode);

Fetch Wallet Logo URL🔗

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

Copyrazorpay.getWalletLogoUrl(walletName);

Fetch Wallet Square Logo URL🔗

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

Copyrazorpay.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:

Copyrazorpay.validateFields(payload, new Razorpay.ValidationListener() { @Override public void onValidationSuccess() { try { razorpay.submit(payload); } catch (Exception exception){} } @Override public void onValidationError(Map<String, String> 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:

Copy/** * 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 don't 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 don't forget to call the super method super.onPageFinished(view, url); Log.d(TAG, "Custom client onPageFinished"); } });

Similarly, you can set your own WebChromeClient:

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

Save Customer Data🔗

You can associate the card details with a saved customer or create payments using tokens for saved cards. To use this functionality, you must use customer APIs at server-side.

Create a Payment With New Card🔗

While creating a payment with new card, you would need to pass the customer_id and save as extra fields, along with the other fields as shown below:

CopyJSONObject data = new JSONObject(); data.put("amount", 29935); data.put("customer_id", "cust_4lsdkfldlteskf"); data.put("save", 1); data.put("method", "card"); data.put("card[name]", "Gaurav Kumar"); data.put("card[number]", "4111111111111111"); data.put("card[expiry_month]", "12"); data.put("card[expiry_year]", "20"); data.put("card[cvv]", "100");

Create a Payment With Existing Saved Card🔗

To create a payment with an existing saved card, you have to pass the token instead of the card number, expiry and card holder's name fields as shown below:

CopyJSONObject data = new JSONObject(); data.put("amount", 29935); data.put("customer_id", "cust_4lsdkfldlteskf"); data.put("token", "token_4zwefDSCC829ma"); data.put("method", "card"); data.put("card[cvv]", "100");
×