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 article is dedicated to walking you through how to perform tokenized/recurring transactions using this SDK. 


To enable tokenization (for recurring or any other services that depend on auto-detection from the customers instead of saving credit card details), please follow the below instructions:

  1. Request a token in creating any payment request by passing the "tokeniseType" along with the "tokenFormat" with the preferred type and format that suits your business needs within your PaymentSdkConfiguration, as shown below.  
    configuration.tokeniseType = PaymentSDKConstants.TokeniseType.userOptinoal;
configuration.tokenFormat = PaymentSDKConstants.TokeniseFormat.hex32; 


    To know more about these parameters and what are the available values you can pass please check the "2.3 React Native SDK | Enums" solution article.


  2. Make sure you import PaymentSdkConfiguration Component.

  3. 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


     

  4. 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
    configuration.tokeniseType = PaymentSDKConstants.TokeniseType.userOptinoal;
    configuration.tokenFormat = PaymentSDKConstants.TokeniseFormat.hex32;
    Generic



  5. Only then you will be ready to start/initiate the payment by passing your PaymentSDKConfiguration object to the startCardPayment 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.startCardPayment(JSON.stringify(configuration)).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



  6. After this, you will receive the token along with the transaction reference (that generated this token) within the payment response result. You will need to save them for future usage.


  7. Then perform any further recurring transaction according to your business needs by repeating steps 2 and 3 from this solution article, then directly start the tokenized card payment via the startTokenizedCardPayment function by passing the PaymentSdkConfiguration object along with the token and the transaction reference (saved from the previous step).

    RNPaymentSDKLibrary.startTokenizedCardPayment(JSON.stringify(configuration),
"Token",
"TransactionReference"
).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)
     });









⌂ 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.