PAYSKY PAYBUTTON SDK ANDROID GUIDE

PaySky Button SDK – android #

Purpose of Document #

The purpose of this SDK to help programmers to use PaySky payment SDK for android.

Getting Started #

These instructions will get you a copy of the project up and running on your local machine for development and testing purposes

Prerequisites #

1. PaySky should provide you by merchant id and Terminal id & Secret ID
2. JDK installed on your machine with minimum version 1.7
3. Android Studio
4. Create new Android project in Android Studio to use SDK or if you have created a Project before with minSdkVersion api version 17

Installing #

1. Open your android project
2. In your project in build.gradle file in project level in allproject{} inside it you will find repositories{} inside it add : maven { url ‘https://jitpack.io’ }

Example:-

3. in your build.gradle file in app level in dependencies{} add :- implementation’com.github.payskyCompany:paybutton-sdk:2.0.4′

4. Sync your project.

Note:- version 2.0.4 may not be the last version check Releases tab in sdk github repository to get latest version

Sdk Path:- https://github.com/payskyCompany/paybutton-sdk

Note That:-

• You should keep your secure hash and merchant id and terminal id with encryption before save them in storage if you want.
• You need to set “PRODUCTION_Status” // set it PRODUCTION or TESTING_GREY or UPG_STAGGING or UPG_PRODUCTION
• If merchant id, terminal id, merchant secure hash, or transaction reference number is null or amount is 0 and you called createTransaction method, SDK will throw an IllegalArgumentException.

Example:-

payButton.setTransactionReferenceNumber(AppUtils.generateRandomNumber());

3. Before call createTransaction method you should pass all required data if you missing
merchantId , termialId , merchantSecureHash , terminalReferenceNumber , amount .
method will throw IllegalArgumentException.

4. In order to create transaction call:-

payButton.createTransaction(new PayButton.PaymentTransactionCallback() {

@Override

public void onCardTransactionSuccess(SuccessfulCardTransaction

cardTransaction) {

paymentStatusTextView.setText(cardTransaction.toString());

}

@Override

public void

onWalletTransactionSuccess(SuccessfulWalletTransaction walletTransaction) {

paymentStatusTextView.setText(walletTransaction.toString());

}

@Override

public void onError(Throwable error) {

paymentStatusTextView.setText(“failed by:- ” +

error.getMessage());

}

});

On Wallet Transaction Success Method #

This method will be called if customer make a wallet transaction with Successful Wallet Transaction object.

Successful Wallet Transaction object from create transaction listener contains:-

• Network Reference variable that is reference number of transaction.
• Amount variable.

Resolving Conflicts #

Because we use some of libraries like Ok http, retrofit , Event Bus and you may use them with different version number , in some cases this will make a conflict in build project to solve this problem you should force the library that has conflict with specific version number.

Example conflict in Gson library we use version

Reference for how to solve problem

(https://stackoverflow.com/questions/28444016/how-can-i-force-gradle-to-set-the-same-version-for-two-dependencies)

(https://stackoverflow.com/questions/28444016/how-can-i-force-gradle-to-set-the-same-version-for-two-dependencies/39292202)