Qattah Pay Android SDK Library

Qattah Pay Android SDK Library is a payment integration library that allows merchants to accept payments in their Android applications.

Getting Started

To include the Qattah Pay Android SDK Library in your Android application, follow these steps:

1. Add the following to your project-level build.gradlefile:

allprojects {
    repositories {
        ...
        maven { url 'https://jitpack.io' }
    }
}

or add this to your project settings.gradle:

dependencyResolutionManagement {
    ...
    repositories {
        ...
        maven { url 'https://jitpack.io' }
    }
}

1. Add the following to your app-level build.gradle file:

dependencies {
    implementation 'com.github.QattahPay:qattahpay-android-sdk:3.2.0@aar'
}

Usage

To use the QattahPay Android SDK Library, you need to initialize it in your application's onCreate() method:

QattahPay.initialize(context, "YOUR_MERCHANT_API_KEY");

To make a payment request, you need to create a PaymentRequest object and call the startPayment() method:

// Create a new payment request
val paymentRequest: PaymentRequest = PaymentRequest.Builder()
    .setAmount(120.00) // amount in Saudi Riyals (SAR)
    .setCurrency(Currency.SAR)
    .setOrderId("ORDER_ID")
    .setDescription("PRODUCT_DESCRIPTION")
    .setCustomerEmail("CUSTOMER_EMAIL")
    .setCustomerMobileNumber("CUSTOMER_MOBILE_NUMBER")
    .setLanguage(Language.EN)
    .setTheme(Theme.DARK)
    .isSandbox(true)
    .build()

 // start a new payment session
 QattahPay.startPayment(paymentRequest, paymentCallbacks)

You can handle all callbacks by creating a local object for the Qattah Pay Callback Service in your activity by following the below steps

private val paymentCallbacks = object : PaymentCallback {
        override fun onStarted(paymentId: String) {
            // Handle payment creation
            Toast.makeText(this@MainActivity, "Payment ID: $paymentId", Toast.LENGTH_SHORT)
                .show()
        }

        override fun onSuccess(paymentId: String) {
            // Handle payment success
            Toast.makeText(this@MainActivity, "Payment Success", Toast.LENGTH_SHORT).show()
        }

        override fun onError(errorMessage: String) {
            // Handle payment error
            Toast.makeText(
                this@MainActivity,
                "Payment Failed: $errorMessage",
                Toast.LENGTH_SHORT
            ).show()
        }

        override fun onCancel() {
            // Handle payment cancel
            Toast.makeText(this@MainActivity, "Payment canceled", Toast.LENGTH_LONG).show()
        }
    }

GitHub - QattahPay/qattahpay-android-sdkGitHub

License

This library is licensed under the MIT License.