PayTabs SDK makes the integration with the PayTabs payment gateway very easy by providing a ready-made payment screen that handles the card entry and, billing & shipping information and completes the missing details.


This function is depreciated and will be removed from the new SDK version in November 2024. For more details and workaround, please check out our solution article, Deprecated Payment via (SDK Saved Card)'s Workaround



This article is dedicated to walking you through how to initiate the payment/request payload using the configuration options and parameters that have already been clarified in the previous step, "Step 2 - Configure the integration method".


After making sure of configuring this SDK as you wish, you will need to import the SDK package Core Component in your code first to start, as shown below: 


import {RNPaymentSDKLibrary, PaymentSDKConfiguration, PaymentSDKBillingDetails, PaymentSDKTheme, PaymentSDKConstants, PaymentSDKSavedCardInfo} from '@paytabs/react-native-paytabs';
import {RNPaymentSDKLibrary, PaymentSDKConfiguration, PaymentSDKBillingDetails, PaymentSDKTheme, PaymentSDKConstants, PaymentSDKSavedCardInfo} from '@paytabs/react-native-paytabs';import {RNPaymentSDKLibrary, PaymentSDKConfiguration, PaymentSDKBillingDetails, PaymentSDKTheme, PaymentSDKConstants, PaymentSDKSavedCardInfo} from '@paytabs/react-native-paytabs';
Generic


Implementing this option will enable you to initiate payments targeted to be paid using the supported types of credit cards such as Visa, MasterCard, Amex, .. etc. To be able to do this, please follow the below instructions:


  1. Make sure you import PaymentSDKConfiguration Component.

  2. Configure the billing & shipping information for this payment, noting that the shipping information is optional. To know more about this, please check our 3.1 React Native SDK | Manage Shipping and Billing details and 2.1 React Native SDK | Configuration Options & Parameters solution articles. 
    let billingDetails = new PaymentSDKBillingDetails(
                   name= "John Smith",
                   email= "[email protected]",
                   phone= "+2011111111",
                   addressLine= "address line",
                   city= "Dubai",
                   state= "Dubai",
                   countryCode= "ae", // ISO alpha 2
                   zip= "1234");
    
    let shippingDetails = new PaymentSDKShippingDetails(
                   name= "John Smith",
                   email= "[email protected]",
                   phone= "+2011111111",
                   addressLine= "address line",
                   city= "Dubai",
                   state= "Dubai",
                   countryCode= "ae", // ISO alpha 2
                   zip= "1234");
    Generic



  3. Then create an object from PaymentSDKConfiguration  and fill it out with your credentials and payment details. To know more about what is the exact values that should be passed here, please check our 2.1 React Native SDK | Configuration Options & Parameters and 2.2 React Native SDK | The PaymentSDKConfiguration Object solution articles.

    let configuration = new PaymentSDKConfiguration();
        configuration.profileID = "*your profile id*"
        configuration.serverKey= "*server key*"
        configuration.clientKey = "*client key*"
        configuration.cartID = "545454"
        configuration.currency = "AED"
        configuration.cartDescription = "Flowers"
        configuration.merchantCountryCode = "ae"
        configuration.merchantName = "Flowers Store"
        configuration.amount = 20
        configuration.screenTitle = "Pay with Card"
        configuration.billingDetails = billingDetails
        configuration.forceShippingInfo = false
    Generic



  4. Only then you will be ready to start/initiate the payment with the previously saved card by passing your PaymentSdkConfiguration object to the startPaymentWithSavedCards function in which the then() function will catch the payment response. To know more about this please check our 2.2 React Native SDK | The PaymentSdkConfiguration Object and Step 5 - React Native SDK | Handle the payment response solution articles.
    RNPaymentSDKLibrary.startPaymentWithSavedCards(JSON.stringify(configuration),
    support3DsBool).then( result => {
          if(result["PaymentDetails"] != null) { // Handle transaction details
            let paymentDetails = result["PaymentDetails"]
            console.log(paymentDetails)
          } else if(result["Event"] == "CancelPayment") { // Handle events
            console.log("Cancel Payment Event")
          } 
         }, function(error) { // Handle error
          console.log(error)
    });
    Generic


    Only cards that has been saved through this startPaymentWithSavedCards function will be shown in the list.


    This would make the payment behavior like the one below, in which once your customers choose one of the saved cards.









⌂ To get familiar with the whole process and the other steps, kindly navigate to our "The React Native SDK Integration Manual" solution article. 

 And to navigate to the previous step in the integration process "Step 2 - Configure the integration method" click here  And to get familiar with the rest of the steps regarding the current step "Step 3 - Initiating the payment" click here.

⇨ Or you can navigate to the next step in the integration process "Step 4 - Accepting the payment" kindly click here.