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 initiate the payment/request payload using the configuration options and parameters that have already been clarified in the previous step, " Step 2 - Native IOS SDK | Configure the integration method".


After making sure of the "Prerequisites" for this SDK, you will need to import the PaymentSDK in your code first to start, as shown below:


import PaymentSDK


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. Furthermore, your SDK will save the card on your behalf to show it in a list of saved cards for any further payments. To be able to do this, please follow the below instructions:


  1. 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 Native IOS SDK | Manage Shipping and Billing details and 2.1.1 Native IOS SDK | Configuration Options & Parameters solution articles.

    let billingDetails = PaymentSDKBillingDetails(name: "John Smith",
                                               email: "[email protected]",
                                                phone: "+2011111111",
                                                addressLine: "address",
                                                city: "Dubai",
                                               state: "Dubai",
                                               countryCode: "ae", // ISO alpha 2
                                               zip: "12345")
                                                       
    let shippingDetails = PaymentSDKShippingDetails(name: "John Smith",
                                                email: "[email protected]",
                                                phone: "+2011111111",
                                                addressLine: "address",
                                                city: "Dubai",
                                               state: "Dubai",
                                               countryCode: "ae", // ISO alpha 2
                                               zip: "12345")



  2. 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.1 Native IOS SDK | Configuration Options & Parameters solution article. 

    let configuration = PaymentSDKConfiguration(profileID: profileID,
                                           serverKey: serverKey,
                                           clientKey: clientKey,
                                           currency: "AED",
                                           amount: 5.0,
                                           merchantCountryCode: "AE")
                .cartDescription("Flowers")
                .cartID("1234")
                .screenTitle("Pay with Card")
                .billingDetails(billingDetails)



  3. Only then you will be ready to start/initiate the payment with the previously saved card by passing your PaymentSDKConfiguration object along with the PaymentManagerDelegate object -in which you will handle the payment response- to the startPaymentWithSavedCards function. To know more about this please check our 2.2 Native IOS SDK | The PaymentSDKConfiguration Object, 2.1.2 Native IOS SDK | Delegates, and Step 5 - Native IOS SDK | Handle the payment responsesolution articles 

    PaymentManager.startPaymentWithSavedCards(on: self, 
                             configuration: configuration,
                             support3DS: true,
                             delegate: self)


    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, the payment will be performed directly if the support3DS was with false or will be directed to the 3DS phase if it was true.

 








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

 And to navigate to the previous step in the integration process "Step 2 - Configure the integration method" kindly click here.

 And to get familiar with the rest of the steps regarding the current step " Step 3 - Native IOS SDK | 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.