Configuration Options & Parameters

This article is dedicated to walking you through how to manage the React Native SDK configuration options.

You will get to know each parameter type and its usage of it so that you can easily configure the SDK to suit your business needs.

PaymentSdkConfigurationDetails

The PaymentSdkConfigurationDetails class can be instantiated using the PaymentSdkConfigBuilder, which follows the builder design pattern to facilitate structured and customizable configuration setup.

---

Sample Code:

Required configuration methods

 var configuration = PaymentSdkConfigurationDetails(
        profileId: profileId,
        serverKey: serverKey,
        clientKey: clientKey,
        cartId: cartId,
        cartDescription: cartDescription,
        amount: amount,
        currencyCode: currencyCode,
        merchantCountryCode: merchantCountryCode
    );

All including the optional methods

var configuration = PaymentSdkConfigurationDetails(
    profileId: profileId,
    serverKey: serverKey,
    clientKey: clientKey,
    cartId: "cartId,
    cartDescription: cartDescription,
    merchantName: "My Store",
    screentTitle: "Pay Now",
    amount: 100.0,
    currencyCode: "SAR",
    merchantCountryCode: "SA",
    transactionType: PaymentSdkTransactionType.SALE,
    transactionClass: PaymentSdkTransactionClass.ECOM,

    billingDetails: billingDetails,
    shippingDetails: shippingDetails,

    showBillingInfo: true,
    showShippingInfo: true,
    forceShippingInfo: false,

    locale: PaymentSdkLocale.EN,
  );

---

Methods used via this object:

• startCardPayment
• start3DSecureTokenizedCardPayment
• startTokenizedCardPayment
• startSamsungPayment
• startAlternativePaymentMethods

---

Properties:

Required Properties

Parameter	Data Type	Validation Rule		Required
profileID	INT	Accept only valid profile number.		✔
	The merchant Profile ID you can get from your PayTabs dashboard. For more information please check our How to get your account information from PT Dashboard? solution article..
	val profileId = "PROFILE_ID" var configuration = PaymentSdkConfigurationDetails( profileId: profileId, serverKey: serverKey, clientKey: clientKey, cartId: cartId, cartDescription: cartDescription, amount: amount, currencyCode: currencyCode, merchantCountryCode: merchantCountryCode );
serverKey	STRING	Accepts only a valid Server Key of your profile		✔
	This a unique identifiers, used to authenticate your integration.
	val serverKey = "SERVER_KEY" var configuration = PaymentSdkConfigurationDetails( profileId: profileId, serverKey: serverKey, clientKey: clientKey, cartId: cartId, cartDescription: cartDescription, amount: amount, currencyCode: currencyCode, merchantCountryCode: merchantCountryCode );
clientKey	STRING	Accepts only a valid client Key of your profile		✔
	This a unique identifiers, used to authenticate your integration.
	val clientKey = "CLIENT_KEY" var configuration = PaymentSdkConfigurationDetails( profileId: profileId, serverKey: serverKey, clientKey: clientKey, cartId: cartId, cartDescription: cartDescription, amount: amount, currencyCode: currencyCode, merchantCountryCode: merchantCountryCode );
amount	DOUBLE	Min: 0.01	Max: 9999999999.99	✔
	Indicates the amount of the transaction the customer is about to be charged. Both min and max values are subjected to the merchant transaction limits.
	val amount = 20.0 var configuration = PaymentSdkConfigurationDetails( profileId: profileId, serverKey: serverKey, clientKey: clientKey, cartId: cartId, cartDescription: cartDescription, amount: amount, currencyCode: currencyCode, merchantCountryCode: merchantCountryCode );
billingDetails	OBJECT			✔
	Indicates the customer details for this payment. If provided, the payment page will be prefilled with the provided data. To know more about this parameter please click here.
	var billingData = PaymentSdkBillingDetails( city = "Jeddah", countryCode = "sA", email = "[email protected]", name = "Technical Support", phone = "+966 55 xxxxxx6", state = "Makkah", addressLine = "address street", zip = "24211" ) var configuration = PaymentSdkConfigurationDetails( profileId: profileId, serverKey: serverKey, clientKey: clientKey, cartId: cartId, cartDescription: cartDescription, amount: amount, currencyCode: currencyCode, merchantCountryCode: merchantCountryCode );
billingDetails's Nested Parameters
Nested Parameter	Data Type	Min	Max	Required
city	STRING	3	128	✔
countryCode	STRING	N/A	N/A	✔
email	STRING	N/A	N/A	✔
name	STRING	3	128	✔
phone	STRING	N/A	N/A	✔
state	STRING	2	2	✔
addressLine	STRING	3	128	✔
zip	STRING	N/A	N/A	✔
shippingDetails	OBJECT			✔
	Indicates the customer shipping details for this payment. If provided, the payment page will be prefilled with the provided data..
	var billingData = PaymentSdkShippingDetails( city = "Jeddah", countryCode = "sA", email = "[email protected]", name = "Technical Support", phone = "+966 55 xxxxxx6", state = "Makkah", addressLine = "address street", zip = "24211" ) var configuration = PaymentSdkConfigurationDetails( profileId: profileId, serverKey: serverKey, clientKey: clientKey, cartId: cartId, cartDescription: cartDescription, amount: amount, currencyCode: currencyCode, merchantCountryCode: merchantCountryCode );
shippingDetails's Nested Parameters
Nested Parameter	Data Type	Min	Max	Required
city	STRING	3	128	✔
countryCode	STRING	N/A	N/A	✔
email	STRING	N/A	N/A	✔
name	STRING	3	128	✔
phone	STRING	N/A	N/A	✔
state	STRING	2	2	✔
addressLine	STRING	3	128	✔
zip	STRING	N/A	N/A	✔

Optional Properties

Parameter	Data Type	Validation Rule		Required
screenTitle	STRING			✘
	The title that'll be shown on the payment form screen under the logo.
	merchantName	STRING			✘
The name of the merchant will be shown to the customer on the SamsungPay wallet screen.
hideCardScanner	Boolean			✘
	Indicates whether to show the camera card scanner button from the payment form screen or not.
	isDigitalProduct	Boolean			✘
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. using only the customer name and email in case your products/services are not physical and don't need to be shipped to the customers. Note that the digital product mode is not universally compatible with all processors. Therefore, it is advisable to seek guidance from your Relationship Manager (RM) to determine if it is suitable for your specific processor.
showBillingInfo	BOOLEAN			✘
	Indicates whether to hide billing information or not from the payment form screen. Noting that the customer details are still required and must be passed, in case any of the details are missing or passed with invalid values; the request will fail and the SDK will throw an exception.
	cardApproval	PaymentSdkCardApproval			✘
Allow you to collects approval of the customer card details via an API, before proceed with payment process.
val cardApproval = PaymentSdkCardApproval( validationUrl = "https://yourdomain.com/validate", binLength = 8, blockIfNoResponse = false ) var configuration = PaymentSdkConfigurationDetails( profileId: profileId, serverKey: serverKey, clientKey: clientKey, cartId: cartId, cartDescription: cartDescription, amount: amount, currencyCode: currencyCode, merchantCountryCode: merchantCountryCode );
cardApproval's Nested Parameters
Nested Parameter	Data Type	Min	Max	Required
validationUrl	String	N/A	N/A	✔
	Provide a list of card prefixes strings (usually first 4, can be up to first 10 prefixes digits) that will be used to determine if the discount should be applied to the transaction.).
binLength	INTEGER	0.01	9999999999.99	✔
	The actual discount should be deducted from the amount, could be a value or percentage according to the isPercentage value
blockIfNoResponse	Boolean	N/A	N/A	✔
	Description of the discount that will be displayed for the customer on the hosted payment page.
showShippingInfo	BOOLEAN			✘
	Indicates whether to show the shipping information or not from the payment form screen.
	tokeniseType	TokeniseType			✘
The tokenization format the generated token should follow.
tokenFormat	TokenFormat			✘
	This indicates the type of tokenization used.
	alternativePaymentMethods	AlternativePaymentMethod			✘
Used to add another payment method in the payment form screen (such as Aman, StcPay, OmanNet, .. etc) or not. For more information please check the related section on this from here.
token	STRING			✘
	The customer's saved card token which has to be passed within the transaction. This field is required for creating tokenized (recurring) transactions.
	samsungToken	STRING			✘
Pass Samsung Pay token to the configuration and call startSamsungPayPayment method to start the payment process.
transactionReference	STRING			✘
	Indicates the Transaction Reference on the PayTabs side check details on [Response Parameters | tran_ref]
	var configuration = PaymentSdkConfigurationDetails( profileId: profileId, serverKey: serverKey, clientKey: clientKey, cartId: cartId, cartDescription: cartDescription, amount: amount, currencyCode: currencyCode, merchantCountryCode: merchantCountryCode );