Integrate Turbo UPI UI

1. Integration Steps

Follow these steps:

1. You need to link the customer's UPI account with your app. Use the code samples given below to fetch the UPI account.

   • If your customer has already linked the UPI account, use the following code to fetch it. If there are no linked UPI accounts, an empty list is returned.
   Kotlin

   copy

   razorpay.upiTurbo?.getLinkedUpiAccounts("<customerMobile>", object : UpiTurboResultListener {
       override fun onSuccess(accList: List<UpiAccount>) {
           if (accList.isNotEmpty()) {
               Log.d("UpiTurbo", "UpiAccount list")
           } else {
               // call linkNewAccount()
           }
       }
       override fun onError(error: Error) {
           Log.d("UpiTurbo", error.message)
       }
   })

2. If the customer has not linked any UPI account, there are two methods to link UPI accounts:

   • Link one UPI account at a time:
     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.

     Kotlin

     copy

     razorpay.upiTurbo?.linkNewUpiAccountWithUI("<customerMobile>",object: 
     UpiTurboLinkAccountResultListener{
         override fun onSuccess(upiAccount: List< UpiAccount>){
         }
         override fun onError(error: Error){
         }       
     }, "<color>")

   • Prefetch and Link multiple accounts together:
     Use the following code to prefetch and link multiple UPI accounts from popular banks. This function is versatile and can be called from anywhere in the application, offering customers multiple entry points to link their UPI accounts with your app.

     Kotlin

     copy

     razorpay.upiTurbo?.setCustomerMobile("<customerMobile>")
         .setColor("<color>")
         .prefetchAndLinkUpiAccountsWithUI(
             object: UpiTurboPrefetchLinkAccountsResultListener {
             override fun onResponse(accounts: AllAccounts) {
                 var accountsWithPinSet = accounts.accountsWithPinSet
                 var accountsWithPinNotSet = accounts.accountsWithPinNotSet
     
                 if (accountsWithPinSet[0] is BankAccount) {
                     when (accountsWithPinSet[0].state) {
                         LINKING_IN_PROGRESS -> {
                          // Show account is linking
                         }
                         LINKING_FAILED -> {
                          // Show account linking failed
                         }
                         else -> {
                          // Not possible in prefetch flow
                         }
                     }
                 } else if (accountsWithPinSet[0] is UpiAccount) {
                  // Continue payment
             } 
             // Display accountsWithPinNotSet in expandable section - with Set Pin button
             }
         }
     )

3. To accept payments, call Custom Checkout’s submit method with the following payload:

   Submit method

   copy

   val payload = JSONObject("""
   {
    "currency":"INR",
    "amount":"700",
    "email":"gaurav.kumar@example.com",
    "contact":"9999999999",
    "method":"upi",
    // the below upi block is specific for Turbo UPI Payment
    "upi":{ 
      "flow":"in_app"
    },
    "order_id":"order_L2MUBUOeFItcpU",//optional
    "customer_id":"cust_KQlMczYKcDIqmB"//optional
   }
   """.trimIndent())

4. Pass the upiAccount and payload objects as shown in the code below:

   Function call

   copy

   HashMap<String, Object> turboPayload = new HashMap<>();
   turboPayload.put("upiAccount", upiAccount);
   turboPayload.put("payload", payload);
   razorpay.submit(turboPayload, object : PaymentResultListener {
       override fun onPaymentSuccess(razorpay_payment_id: String?, data: PaymentData?) {
           // show appropriate status of the payment to user. 
       }
   
       override fun onPaymentError(code: Int, message: String?, data: PaymentData?) {
          // show appropriate status of the payment to user. 
       }
   })

Non-Transactional Flow

You can directly interact with the exposed methods of the Turbo Framework to perform the non-transactional flows listed below.

razorpay.upiTurbo?.manageUpiAccounts("9999999999",
    object : UpiTurboManageAccountListener {
        override fun onError(error: JSONObject)  {
            /*Throws error if UPI Turbo cannot be initialized or throws error*/}

        override fun onSuccess(data: Any) {/*Can be safely ignored*/}
})

razorpay.upiTurbo?.setUpiPinWithUI(accountsWithPinNotSet[0],
    object: UpiTurboSetPinResultListener {
        override fun onSuccess(upiAccount: UpiAccount) {
            // Continue payment
        }
        override fun onError(error: Error) {
            // Show error
        }
    }
)

Additional Features

1. The below function is triggered internally after integrating with the Razorpay Android Custom SDK.

   Initialise SDK

   copy

   import com.razorpay.Razorpay
   
   Razorpay razorpay = new Razorpay(activity);

2. The .onBackPressed() is triggered when a customer tries to exit the app or return to the previous page. The razorpay.upiTurbo.destroy() function clears that particular session. Therefore, when the customer returns, the payment process starts from the beginning.

   Kotlin

   copy

   override fun onBackPressed() {
   razorpay.onBackPressed()
   razorpay.upiTurbo.destroy()
   super.onBackPressed()
   }

Models Exposed from the SDKs

The SDKs given below provide access to exposed models for seamless integration.

2. Test Integration

We recommend the following:

• Complete the integration on UAT before using the prod builds.
• Perform the UAT using the Razorpay-provided API keys.

3. Go-live Checklist

Complete these steps to take your integration live:

• You should get your app id whitelisted by Razorpay to test on prod.

  Handy Tips

  Contact our

  integrations team

  to get your mobile number and app whitelisted.

• Import the prod library from the Github repository → https://github.com/upi-turbo/android-turbo-sample-app/tree/prod/app/libs prod branch.

• Add Proguard rules:

  • keepclassmembers,allowobfuscation class * { @com.google.gson.annotations.SerializedName <fields>; }
  • keepclassmembers enum * { *; }
  • keepclassmembers class * { @android.webkit.JavascriptInterface <methods>; }
  • dontwarn com.razorpay.**
  • keep class com.razorpay.** {*;}
  • keep class com.olivelib.** {*;}
  • keep class com.olive.** {*;}
  • keep class org.apache.xml.security.** {*;}
  • keep interface org.apache.xml.security.** {*;}
  • keep class org.npci.** {*;}
  • keep interface org.npci.** {*;}
  • keep class retrofit2.** { *; }
  • keep class okhttp3.** { *; }

• Replace the UAT credential with the

  Razorpay live keys

  for prod testing.