Web Application

To list external wallet on your web application, you need to first integrate our

1. Add a key external to checkout.js options.

2. Set wallets with wallet name array in external as the first parameter.

   JavaScript

   copy

   external: {
     wallets: ['paytm']
   }

3. Set handler with a callback function in external as second parameter. This is where you receive a callback from which you can handle external wallets based on the parameters:

external: {
  wallets: ['paytm'],
  handler: function (data) {
    console.log(data)
  }
}

The external wallet sent in options will be shown in the wallets section.

If the customer selects external wallet and clicks Submit, our checkout.js library will return the control to you in the external.handler method. You will get the selected wallet name as an argument. You will now have to handle the external payment method.

Android

To list external wallets on your Android app, you need to first integrate our

1. Implement ExternalWalletListener in your activity.

   copy

   public class PaymentActivity extends Activity implements PaymentResultListener, ExternalWalletListener {
       //..
   
       @Override
   	public void onExternalWalletSelected(String walletName, PaymentData paymentData){
   		// add your logic here to handle external wallet payments like
   		if(walletName.equals("paytm"){
   		    //handle paytm payment
   		}
   
   	}
   
   }

2. Send external wallet information to checkout in options. You can send it in the following way:

   copy

   JSONArray wallets = new JSONArray();
   wallets.put("paytm");
   JSONObject externals = new JSONObject();
   externals.put("wallets", wallets);
   options.put("external", externals);

The external wallet sent in options will be shown in the wallets section. If the customer selects an external wallet and submits it, our SDK will return control to you in the onExternalWalletSelected method. You will get the selected wallet name as an argument. You will now have to handle your payment.

iOS

To list external wallet on your iOS app, you need to first set up your framework. Know more about

1. Implement ExternalWalletSelectionProtocol in your view controller.

   objectivec

   copy

   @interface ViewController () <RazorpayPaymentCompletionProtocol,
                             ExternalWalletSelectionProtocol> {

2. Set ExternalWalletSelectionDelegate to get callback in delegate method.

   objectivec

   copy

   [razorpay setExternalWalletSelectionDelegate:self];

3. Send external wallet information to Checkout in options. You can send it in the following way:

   objectivec

   copy

   NSDictionary *options = @{
   @"amount" : @"20000",
   @"currency" : @"INR",
   @"description" : @"A Wild Sheep Chase is the third novel by Japanese author Haruki Murakami",
   @"image" : http://example.com/your_logo.jpg,
   @"name" : @"Gaurav Kumar",
   @"external" : @{@"wallets" : @[ @"paytm" ]},
   @"prefill" :
       @{@"email" : @"gaurav.kumar@example.com", @"contact" : @"9000090000"},
   @"theme" : @{@"color" : @"#3594E2"}
   };

4. Implement onExternalWalletSelected:WithPaymentData: delegate method to receive callback and get control back.

The external wallet sent in options will be shown in the wallets section. If the customer selects an external wallet and clicks Submit, our SDK will return control to you in the onExternalWalletSelected method. You will get the selected wallet name as an argument. You will now have to handle the external payment method.