Android SDK

To integrate the PayKun Payment Gateway in your mobile app which can enable you to receive payments from your customers using the Android Devices you need to follow a few easy steps.
For the video tutorial to Integrate PayKun Payment Gateway in your Android App you may click here​
Get the demo app from here - Paykun Demo Android App​
Checkout Android SDK requires
1.
A registered PayKun Merchant Account​

How to install SDK in your app?
We have distributed our SDK via Maven Central Repositery. You can add our latest PayKun SDK directly to your build.gradle file in the dependency section using the below given line:
implementation 'com.paykun.sdk:paykun-checkout-lib:1.1.13'
How to implement SDK into your Android APP?
For testing purpose you need to login to the PayKun Dashboard using Sandbox Mode and also get your Merchant ID and Access Token from there.
Note: To get Merchant ID, go to the top-right corner “Profile drop-down”. Access Token can be generated from Settings > Security > Device API Key > Click On Generate API Key Button.
You need to pass merchant id, access token, customer name, customer email, customer phone, product name, order no and amount to SDK. Remember that order number should always be unique, duplicate order number will cause invalid request.
Create Json object with following key and values.
1
JSONObject object = new JSONObject();
2
try {
3
    object.put("merchant_id","183533025281039");
4
    object.put("access_token","76E4DCE9CDFBE2194AAA9417A47C8BCE");
5
    object.put("customer_name","Bhavik Makvana");
6
    object.put("customer_email","[email protected]");
7
    object.put("customer_phone","3624300677");
8
    object.put("product_name","PayKunProduct");
9
    object.put("order_no",System.currentTimeMillis()); // order no. should have 10 to 30 character in numeric format
10
    object.put("amount","10");  // minimum amount should be 10
11
    object.put("isLive",false); // need to send false if you are in sandbox mode
12
} catch (JSONException e) {
13
    e.printStackTrace();
14
}
Copied!
Send Json object to Paykun API
1
new PaykunApiCall.Builder(MainActivity.this).sendJsonObject(object); 
2
// Paykun api to initialize your payment and send info.
Copied!
After sending your data to Paykun, you will get the result in getResults() Method. But to get result, you have to register GlobalBus in your activity’s onStart() Method.
1
@Override
2
protected void onStart() {
3
    super.onStart();
4
    // Register this activity to listen to event.
5
    GlobalBus.getBus().register(this);
6
}
Copied!
Then, don’t forget to unregister GlobalBus in OnStop() method of activity.
1
@Override
2
protected void onStop() {
3
    super.onStop();
4
    // Unregister from activity
5
    GlobalBus.getBus().unregister(this);
6
}
Copied!
Implementation of getResults() method – get your success or failed result in getResults() method.
1
@Subscribe(sticky = true, threadMode = ThreadMode.MAIN)
2
public void getResults(Events.PaymentMessage message) {
3
    if(message.getResults().equalsIgnoreCase(PaykunHelper.MESSAGE_SUCCESS)){
4
        // do your stuff here
5
        // message.getTransactionId() will return your failed or succeed transaction id
6
        /* if you want to get your transaction detail call message.getTransactionDetail()
7
        *  getTransactionDetail return all the field from server and you can use it here as per your need
8
        *  For Example you want to get Order id from detail use message.getTransactionDetail().order.orderId */
9
        if(!TextUtils.isEmpty(message.getTransactionId())) {
10
            Toast.makeText(MainActivity.this, "Your Transaction is succeed with transaction id : "+message.getTransactionId() , Toast.LENGTH_SHORT).show();
11
            Log.v(" order id "," getting order id value : "+message.getTransactionDetail().order.orderId);
12
        }
13
    }
14
    else if(message.getResults().equalsIgnoreCase(PaykunHelper.MESSAGE_FAILED)){
15
        // do your stuff here
16
        Toast.makeText(MainActivity.this,"Your Transaction is failed",Toast.LENGTH_SHORT).show();
17
    }
18
    else if(message.getResults().equalsIgnoreCase(PaykunHelper.MESSAGE_SERVER_ISSUE)){
19
        // do your stuff here
20
        Toast.makeText(MainActivity.this,PaykunHelper.MESSAGE_SERVER_ISSUE,Toast.LENGTH_SHORT).show();
21
    }else if(message.getResults().equalsIgnoreCase(PaykunHelper.MESSAGE_ACCESS_TOKEN_MISSING)){
22
        // do your stuff here
23
        Toast.makeText(MainActivity.this,"Access Token missing",Toast.LENGTH_SHORT).show();
24
    }
25
    else if(message.getResults().equalsIgnoreCase(PaykunHelper.MESSAGE_MERCHANT_ID_MISSING)){
26
        // do your stuff here
27
        Toast.makeText(MainActivity.this,"Merchant Id is missing",Toast.LENGTH_SHORT).show();
28
    }
29
    else if(message.getResults().equalsIgnoreCase(PaykunHelper.MESSAGE_INVALID_REQUEST)){
30
        Toast.makeText(MainActivity.this,"Invalid Request",Toast.LENGTH_SHORT).show();
31
    }
32
    else if(message.getResults().equalsIgnoreCase(PaykunHelper.MESSAGE_NETWORK_NOT_AVAILABLE)){
33
        Toast.makeText(MainActivity.this,"Network is not available",Toast.LENGTH_SHORT).show();
34
    }
35
}
Copied!
Proguard rules
1
-keepattributes *Annotation*
2
-keepclassmembers class * {
3
    @org.greenrobot.eventbus.Subscribe <methods>;
4
}
5
-keep enum org.greenrobot.eventbus.ThreadMode { *; }
6
​
7
# Only required if you use AsyncExecutor
8
-keepclassmembers class * extends org.greenrobot.eventbus.util.ThrowableFailureEvent {
9
    <init>(java.lang.Throwable);
10
}
Copied!
For any Assistance :
In case of any query, please contact to [email protected]​
​
PayKun Developer’s Hub - Previous
Mobile Integration
iOS SDK
Last modified 2mo ago
Copy link
Contents
Checkout Android SDK requires
How to install SDK in your app?
How to implement SDK into your Android APP?