Integrate with Turbo UPI

Onboarding Flow

Ensure your customers

Turbo UPI SDK Integration

Follow these steps to integrate with Razorpay Turbo UPI:

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

   Import Package

   copy

   import 'package:razorpay_flutter/razorpay_flutter.dart'; 
   // Create a Razorpay instance
   razorpay = Razorpay("YOUR_KEY_ID").initUpiTurbo();

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 UPI Account

   copy

   razorpay.upiTurbo.linkNewUpiAccount(customerMobile: mobileNumber,
       color: "#ffffff",
       onSuccess: (List<UpiAccount> upiAccounts) {
   
       },
       onFailure:(Error error) {    
       }
   );

   Request Parameters

   mobileNumber

   mandatory

   string Mobile number of the customer.

   color

   optional

   string Colour in hex format.

   Response Parameters

   Parameters	Description
   onSuccess	This function is triggered if the list is fetched successfully. upiAccounts can be empty to indicate that no accounts have been linked yet.
   onFailure	This function is triggered in case of an error, and the error object will be received.

   • Initialise the instance to handle the event using the code given below:
   Instantiate

   copy

   razorpay.on(Razorpay.EVENT_PAYMENT_ERROR, handlePaymentErrorResponse);
   razorpay.on(Razorpay.EVENT_PAYMENT_SUCCESS, handlePaymentSuccessResponse);

   • 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.
   Payment Failure Response Handling

   copy

   void handlePaymentErrorResponse(PaymentFailureResponse response) {
   
    /**
    * PaymentFailureResponse contains three values:
    * 1. Error Code
    * 2. Error Description
    * 3. Metadata
    **/
    print('Payment Error Response : $response');
    }

   • 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.
   Payment Success Response Handling

   copy

   void handlePaymentSuccessResponse(PaymentSuccessResponse response) {
   
    /**
    * Payment Success Response contains three values:
    * 1. Order ID
    * 2. Payment ID
    * 3. Signature
    **/
    print('Payment Success Response : $response');
   }

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

   Submit Payment Details

   copy

   Map<String, Object> payload = {
       'amount': 100
       'currency': 'INR',
       'prefill':{
           'contact':'8888888888',
            'email':'test@razorpay.com'
       },
       'theme':{
           'color':'#0CA72F'
       },
       'send_sms_hash':true,
       'retry':{
           'enabled':false,
           'max_count':4
       },
       'key': '$merchantKey',
       'disable_redesign_v15': false,
       'experiments.upi_turbo':true
   };
   
   razorpay.open(payload);

   Request Parameter

   payload

   mandatory

   Map<String, dynamic> Payload for initiating transaction.

Non-Transactional Flow

Razorpay provides a single exposed function that allows you to manage linked UPI accounts and access all non-transactional flows seamlessly.

razorpay.upiTurbo.manageUpiAccounts(customerMobile: mobileNumberValue,
color: "#ffffff",
onFailure:(Error error) {   
}
);

Models Exposed from the SDKs

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