Checkout Reference for Android

This document is intended to help understand the integration process of your Native Android App with Jenga Payment Gateway Android SDK.

Pre-requisites

1. Sign up for an account on Jenga HQ{:target="_blank" rel="noopener"}.
2. Make sure you have at least one wallet added under Settings -> Wallets in the left navigation menu.
3. Navigate to Settings -> Subscriptions under the left navigation menu and add subscriptions for the payment
   methods you want to provide on the checkout screen.
4. Navigate to Settings -> Api Keys under left navigation menu and click on Generate New Keys, if the keys
   have not been generated yet.
5. On the above Settings -> Api Keys screen, click on View inside Your Public Key section, if the window which
   opens does not contains your public key, please generate and paste it there, and then click on the Update
   button to update the same on Jenga HQ.

Integration Steps

Follow the below steps to integrate Checkout Android SDK with your Android application:

1. Open your project-level build.gradle file and declare mavenCentral() repository inside repositories block inside
   buildscript block, if it does not already exists.

buildscript {
    repositories {
        mavenCentral()
    }
}

2. Open your app-level build.gradle file and add Jenga Checkout’s gradle dependency inside the dependencies
   block. For the latest version, please refer the Releases and Versions section.

dependencies {
    implementation 'io.jengapgw:jengapgw-android:1.0.2' 
}

3. Add Jenga API key and Consumer Secret as meta-data properties under the tag in your app-
   level AndroidManifest.xml file and replace the values with your Api key and consumer secret.

<application>

    <meta-data
        android:name="com.jenga.checkout.JengaCheckoutAPIKey"
android:value="<---Enter your Api key here--->" />

    <meta-data
        android:name="com.jenga.checkout.JengaCheckoutConsumerSecret"
        android:value="<---Enter your Consumer Secret here--->" />

</application>

Navigate to Settings -> Api Keys under the left navigation menu on Jenga HQ and click on View Keys button to find your Api Key and Consumer Secret. Refer below image for the same:

4. Include these import statements

import io.jengapgw.Checkout 
import io.jengapgw.CheckoutResultListener 
import io.jengapgw.models.CheckoutResult 
import io.jengapgw.models.Order

5. Create an order in your system and then create an order for the Jenga Android SDK by creating an object of the
   Order class.

val order = Order(
    merchantCode, walletId, amount, orderReference, productType,
    productDescription, extraInfo, paymentTimeLimit, currency,
    callbackUrl, signature, countryCode, customerFirstName,
    customerLastName, customerZipCode, customerAddress
)

Order class’s fields and their description are as follows:

6. Launch Checkout screen to initiate payment by calling start() method of the Checkout class and passing the
   order object created in the previous step and the FragmentManager class’s instance.

val checkout = Checkout()
checkout.start(order, supportFragmentManager)

7. Implement CheckoutResultListener interface and override its onResult method in the class where you are
   launching the checkout from, to receive a callback from the SDK once the checkouts gets successful or failed.
   Here you can show a relevant message to the customer, based on the checkout status.

class CheckoutActivity : AppCompatActivity(), CheckoutResultListener {

    override fun onResult(result: CheckoutResult) {
        Toast.makeText(this, result.message, Toast.LENGTH_SHORT).show()
        Log.i("Response Result", result.toString())
    }
}

CheckoutResult class’s fields and their description is as below: