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 - Configure the integration method".


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


using PaymentSDKBinding;
using PaymentSDKBinding;
Generic


Implementing this option will enable you to initiate payments targeted to be paid using the ApplePay payment method. To be able to do this, please follow the below instructions:


  1. First, start by following the guide steps to configure ApplePay, to know how you can configure ApplePay with PayTabs, and passing the "merchantName" and "merchantApplePayIndentifier" parameters within your PaymentSdkConfigurationDetails, as shown below.  
    configuration.MerchantName = "Flowers Store";
    configuration.MerchantApplePayIdentifier = "merchant.com.bundleID";


  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 Xamarin SDK | Manage Shipping and Billing details and 2.1 Xamarin SDK | Configuration Options & Parameters solution articles.

    PaymentBillingDetails billingDetails = new PaymentBillingDetails
            {
                Name = "FirstName LastName",
                Email = "[email protected]",
                Phone = "+971111111111",
                AddressLine = "Address line",
                City = "Dubai",
                State = "Dubai",
                CountryCode = "AE",  // ISO alpha 2
                Zip = "12345"
            };
    
    PaymentShippingDetails shippingDetails = new PaymentShippingDetails
            {
                Name = "FirstName LastName",
                Email = "[email protected]",
                Phone = "+971111111111",
                AddressLine = "Address line",
                City = "Dubai",
                State = "Dubai",
                CountryCode = "AE",  // ISO alpha 2
                Zip = "12345"
            };                                         
    HTML



  3. Then create an object from PaymentConfiguration and fill it out with your credentials and payment details, You should know that it's required to pass the merchant name and merchant identifier parameters. To know more about what is the exact values that should be passed here, please check our 2.1 Xamarin SDK | Configuration Options & Parameters and 2.2 Xamarin SDK | The Payment Configuration Object solution articles.

    PaymentConfiguration configuration = new PaymentConfiguration
    {
                ProfileID = "*Profile Id*",
                ServerKey = "*Server key*",
                ClientKey = "*Client Key*",
                MerchantCountryCode = "2 chars iso country code",
                Currency = "USD",
                Amount = 130,
                CartID = "123456",
                CartDescription = "Buy 2 Flowers",
                MerchantName = "Flowers Store",
                ScreenTitle = "Pay with Card",
                merchantName: "merchant name",
                merchantApplePayIndentifier: "merchant.com.bundleID",
    };
    Generic

     

  4. As an additional step, you can simplify ApplePay validation on all users' billing information to validate only the name, phone, and email by passing the simplifyApplePayValidation configuration parameter with true.

    onfiguration.SimplifyApplePayValidation = true;
    Generic


  5. Only then you will be ready to start/initiate the payment by passing your PaymentConfiguration  to the StartApplePayPaymentWithConfiguration function in which the callback event will handle/alter the payment response. To know more about this please check our 2.1 Xamarin SDK | Configuration Options & Parameters and Step 5 - Xamarin SDK | Handle the payment response solution articles. 

    _proxy.StartApplePayPaymentWithConfiguration(configuration, this);
    Generic

     









⌂ To get familiar with the whole process and the other steps, kindly navigate to our "The Xamarin (Bridge) 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.