PayTabs Support Portal

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

Implementing this option will enable you to apply a discount for a specific bank card/s via giving card prefixes from 4 to 10 digits. 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= "First Last Name",
                  email= "[email protected]",
                  phone= "+966 56 808 ####",
                  addressLine= "address line",
                  city= "city",
                  state= "state",
                  countryCode= "SA", // country ISO alpha 2
                  zip= "22333");
   
   let shippingDetails = new PaymentSDKShippingDetails(
                  name= "First Last Name",
                  email= "[email protected]",
                  phone= "+966 56 808 ####",
                  addressLine= "address line",
                  city= "city",
                  state= "state",
                  countryCode= "SA", // ISO alpha 2
                  zip= "22333");

   Generic

3. Now configure the discount, note that you can apply one or more discounts via implementing the discount PaymentSDKCardDiscount object:
   
   

   export default class PaymentSDKCardDiscount { constructor(discountCards, discountValue, discountTitle, isPercentage) { this.discountCards = discountCards; this.discountValue = discountValue; this.discountTitle = discountTitle; this.isPercentage = isPercentage; } }
   discountCards	{string[]} - An array of strings representing the cards that the discount can be applied to. A list of Strings, each string must have between 4 and 10 digits, and can't be empty. ['4111', '40001']
   discountValue	{number} - The value of the discount. This could be a flat amount or a percentage depending on the value of 'isPercentage'.
   discountTitle	String title/name that will be displayed to the customer.
   isPercentage	A boolean indicates whether the discount value is a percentage (true) or a flat amount (false).

   
   

   let cardDiscount1 = new PaymentSDKCardDiscount();
   cardDiscount1.discountCards = ['4111', '40001'];
   cardDiscount1.discountValue = 10;
   cardDiscount1.discountTitle = 'Discount 10% on 4111,40001 cards';
   cardDiscount1.isPercentage = true;
   
   let cardDiscount2 = new PaymentSDKCardDiscount();
   cardDiscount2.discountCards = ['42222', '40002'];
   cardDiscount2.discountValue = 5;
   cardDiscount2.discountTitle = 'Discount 5 EGP on 42222,40002 cards';
   cardDiscount2.isPercentage = false;

   
   

4. Then create an object from PaymentSDKConfiguration  and fill it out with your credentials and payment details. don't forget to set the discount via "cardDiscounts" parameters using the array created in the previous step. 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 = "SAR"
       configuration.cartDescription = "Flowers"
       configuration.merchantCountryCode = "SA" // Country ISO alpha 2
       configuration.merchantName = "Flowers Store"
       configuration.amount = 20
       configuration.screenTitle = "Pay with Card"
       configuration.billingDetails = billingDetails
       configuration.forceShippingInfo = false
       configuration.cardDiscounts = Array.of(cardDiscount1, cardDiscount2);
   

   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

   
   

      

   Discount title dialog, will show onle two titles, if you have set more than two then you will have to select the "See All" to display the full list:
       Once you press the See All, a sheet will display showing all applied discounts configured.

       

   

        

   If the customer uses a bank card that does not match any of the discount filters, the discount will not applied and the customer will pay the full amount. 

   
   

   
   
   
   

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