Integrate with Turbo UPI

• Turbo UPI Cordova Standard SDK: Discover new features, updates and deprecations related to Turbo UPI on Cordova Standard Checkout (since Jan 2024).

​

Prerequisites

1. Integrate with Razorpay Cordova Standard SDK.
2. Import the following frameworks:
   • Razorpay Cordova Standard SDK
   • Razorpay Turbo Wrapper Plugin SDK (maven)
   • Razorpay Turbo Core SDK
   • Razorpay Turbo UI SDK
   • Razorpay SecureComponent SDK
   • Bank SDK
3. Enable data binding in your app.gradle.
   Data binding

   {
    "android": {
        // Containing other settings
        "buildFeatures": {
            "dataBinding": true
        }
     }
   }
   

​

Onboarding Flow

​

Turbo UPI SDK Integration

1. Use the code given below to initialise the SDK.
   Initialise

   RazorpayCheckout.initUpiTurbo("rzp_test_0wFRWIZnH65uny")
   
2. Use the following code to link the newly created UPI account with your app. This function can be called from anywhere in the application, providing multiple entry points for customers to link their UPI account with your app.
   Link New UPI Account

   RazorpayCheckout.upiTurbo.linkNewUpiAccount("mobileNo", "color", function (upiAccounts) {
       // handle data
   }, function(error) {
       // handle error
   });
   

​

Request Parameters

​

Response Parameters

​

Parameters | Description

​

function(upiAccounts) | This function is triggered if the list is fetched successfully. The upiAccounts can be empty to indicate that no accounts have been linked yet.

• Handle payment failure responses, displaying important details such as error codes, error descriptions, and metadata. This function is responsible for handling and logging information in the event of a payment error.

var cancelCallback = function(error) {
    /**
     * error contains two values:
     * 1. Error Code
     * 2. Error Description
    **/

    // handle failure
};

• Handle successful payment responses, displaying key information like order id, payment id, and signature. This code manages and logs details when a payment transaction is successful.

var successCallback = function(response) {
    /**
     * response contains three values:
     * 1. Order ID
     * 2. Payment ID
     * 3. Signature
    **/

    // handle success
};

3. To accept payments, call Standard Checkout’s submit method with the following payload:
   Submit Payment Details

   var rzpOptions = {
       amount: 2000,
       currency: "INR",
       prefill: {
           contact: "1234567890",
           email: "gaurav.kumar@example.com"
       },
       theme: {
           color: "#063970"
       },
       send_sms_hash: true,
       retry: {
           enabled: false,
           max_count: 4
       }
   };
   
   RazorpayCheckout.open(rzpOptions, successCallback, cancelCallback);
   

​

Request Parameter

​

Response Parameters

​

Parameters | Description

​

successCallback | It is triggered upon successful completion of the payment, providing access to a response object.

​

Non-Transactional Flow

​

Manage UPI Accounts

• Fetch balance: Check the customer’s account balance.
• Change UPI PIN: Provide the customer the ability to change their UPI PIN.
• Reset UPI PIN: Let your customers reset the PIN for their account.
• Delete the account from the application: Let your customers delink, that is, remove a selected UPI account from your application.

RazorpayCheckout.upiTurbo.manageUpiAccounts("mobileNo", "color", function(error) {
    // handle error
});

​

Response Parameter

​

Parameters | Description

​

Models Exposed from the SDKs

​

Error

​

Error | Description

• GATEWAY_ERROR: Failure either from the Secure Component or the Bank.
• SERVER_ERROR: Failure at PSP.

  ---

  ​

  errorDescription | Brief description of the error.

  ​

  errorReason | Specifies the specific reason for the error.

  ​

  errorSource | Indicates the origin of the error.

  errorStep | Highlights the stage where the error occurred. Refer to the list of possible error reasons.

​

UpiAccount

​

Fields | Return Type | Description

​

accountNumber | String | Masked account number.

​

ifsc | String | IFSC of the bank.

​

bankLogoUrl | String | Image URL of the bank logo.

​

bankName | String | Name of the bank.

​

Response

​

Fields | Return Type | Description

​

paymentId | String | Payment id.

​

orderId | String | Order id.