Setting Up

Quicko SDK is a library designed to provide seamless integration with Quicko's services. With just a few lines of code, developers can set up the SDK and leverage its functionality.

Before utilizing the SDK, you need to ensure that you have integrated it into your project. Once that is complete, setting up is simple.

Configuration and Setup

1. Accessing the SDK Instance

For developers seeking to integrate Quicko Connect into their platforms, the primary point of interaction is through the QuickoSDK class. This class acts as the gateway to the plethora of features and functionalities that Quicko Connect offers.

The class is designed as a singleton. This ensures that there's only one instance of the class throughout the application's lifecycle, maintaining data consistency and preventing potential issues that could arise from having multiple instances.

Here are the ways you can access the SDK on difference platforms:

Java

final QuickoSDK sdk = QuickoSDK.INSTANCE;

Kotlin

val sdk = QuickoSDK;

Swift

let sdk = QuickoSDK.instance

2. Configuring the API Key (in case of intent connect)

Overview

To ensure proper initialization and functioning of the SDK, it's imperative to configure the API key using the setAPIKey method. This step must be completed prior to invoking any other operations.

Java

QuickoSDK.INSTANCE.setAPIKey("YOUR_API_KEY");

Kotlin

QuickoSDK.setAPIKey("YOUR_API_KEY")

Swift

QuickoSDK.instance.setAPIKey("YOUR_API_KEY")

Parameters

• apiKey: A string parameter that represents the API key you've been provided with.

Handling Exceptions

IllegalArgumentException

An exception will be raised if the API key supplied to the SDK is invalid or does not adhere to the expected format.

Sample:

Java

try {
    QuickoSDK.INSTANCE.setAPIKey("invalidKey");
} catch (IllegalArgumentException e) {
    System.out.println("Error encountered: Invalid API Key.");
}

Kotlin

try {
    QuickoSDK.setAPIKey("invalidKey")
} catch (IllegalArgumentException e) {
    println("Error encountered: Invalid API Key.")
}

Swift

do {
    try QuickoSDK.instance.setAPIKey("invalidKey")
} catch let error as IllegalArgumentException {
    print("Error encountered: Invalid API Key.")
}

In this sample, an invalid API key ("invalidKey") is purposely used. Consequently, IllegalArgumentException is triggered, and the error message "Error encountered: Invalid API Key." gets displayed.

Best Practices

• Implementing a try-catch mechanism around the setAPIKey function is advisable. This allows for efficient exception handling, ensuring users receive pertinent feedback or assisting developers during the debugging process.