Mobile SDKs
Android SDK

6min
Overview
This guide will walk you through a straightforward solution to accept payments within your Android application. The Moyasar Android SDK helps you accept multiple payment methods in your app including Mada, Visa, and MasterCard.
Dependencies
Before we can use the SDK, we have to add a couple of things within the app module build.gradle file.
We need to enable the data binding feature, so we have to add the kotlin-kapt plugin and add the following within android block:
build.gradle
android {
    // Other config

    buildFeatures {
        dataBinding true
    }
}
android {
    // Other config

    buildFeatures {
        dataBinding true
    }
}
﻿
Now, we can add the SDK dependency in the dependencies block:
bulid.gradle
dependencies {
    // Other dependencies

    implementation 'com.moyasar:android-sdk:0.5.1'
}
dependencies {
    // Other dependencies

    implementation 'com.moyasar:android-sdk:0.5.1'
}
﻿
Adding permissions
Make sure you have the following permissions in your Android manifest.
XML
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
﻿
Credit Card Payments
The SDK currently only provides Credit Card payment integration. We can use that by first preparing our payment config object as follows:
Here is a sample Activity that shows the payment sheet:
Kotlin
class MainActivity : AppCompatActivity() {
    var paymentSheet: PaymentSheet? = null
    val config = PaymentConfig(
        amount = 100,
        currency = "SAR",
        description = "Sample Android SDK Payment",
        apiKey = "pk_test_vcFUHJDBwiyjsh73khFuPpTnRPY4gp2aaYdNddY3",
        metadata = mapOf(
          "order_id" to "order_id_123"
        ),
        manual = false,
        saveCard = false
    )

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)

        paymentSheet = PaymentSheet(this, { handlePaymentResult(it) }, config)

        val donateBtn = findViewById<Button>(R.id.button)
        donateBtn.setOnClickListener {
            paymentSheet!!.present()
        }
    }

    fun handlePaymentResult(result: PaymentResult) {
        when (result) {
            is PaymentResult.Completed -> {
                handleCompletedPayment(result.payment);
            }
            is PaymentResult.Failed -> {
                // Handle error
                var error = result.error;
            }
            PaymentResult.Canceled -> {
                // User has canceled the payment
            }
        }
    }

    fun handleCompletedPayment(payment: Payment) {
        when (payment.status) {
            "paid" -> { /* Handle successful payment */ }
            "failed" -> {
                var errorMessage = payment.source["message"]
                /* Handle failed payment */
            }
            else -> { /* Handle other statuses */ }
        }
    }
}
class MainActivity : AppCompatActivity() {
    var paymentSheet: PaymentSheet? = null
    val config = PaymentConfig(
        amount = 100,
        currency = "SAR",
        description = "Sample Android SDK Payment",
        apiKey = "pk_test_vcFUHJDBwiyjsh73khFuPpTnRPY4gp2aaYdNddY3",
        metadata = mapOf(
          "order_id" to "order_id_123"
        ),
        manual = false,
        saveCard = false
    )

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)

        paymentSheet = PaymentSheet(this, { handlePaymentResult(it) }, config)

        val donateBtn = findViewById<Button>(R.id.button)
        donateBtn.setOnClickListener {
            paymentSheet!!.present()
        }
    }

    fun handlePaymentResult(result: PaymentResult) {
        when (result) {
            is PaymentResult.Completed -> {
                handleCompletedPayment(result.payment);
            }
            is PaymentResult.Failed -> {
                // Handle error
                var error = result.error;
            }
            PaymentResult.Canceled -> {
                // User has canceled the payment
            }
        }
    }

    fun handleCompletedPayment(payment: Payment) {
        when (payment.status) {
            "paid" -> { /* Handle successful payment */ }
            "failed" -> {
                var errorMessage = payment.source["message"]
                /* Handle failed payment */
            }
            else -> { /* Handle other statuses */ }
        }
    }
}
﻿
When the user taps the button, they should see the payment sheet as follows.
﻿
Android SDK Dark ar
﻿
Android SDK Light en
﻿
Java interoperability
The SDK is built with Kotlin and allows interoperability with Java
Updated 23 Nov 2023
Did this page help you?
iOS SDK
Flutter SDK
Docs powered by Archbee
TABLE OF CONTENTS
Java interoperability