Genesis Android SDK

Requirements

JDK >= 1.8
Gradle >= 4.1
Android >= 5.0 Lollipop
Android Studio >= 3.0

Installation and Setup

clone or download this repo

git clone http://github.com/GenesisGateway/android_sdk GenesisAndroid
cd GenesisAndroid

Gradle

Add the dependency in your build.gradle:

dependencies {
  implementation 'com.emerchantpay.gateway:genesis-android:1.3.94'
}

Basic Usage

AndroidManifest.xml

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="YOUR_PACKAGE">

    <uses-permission android:name="android.permission.INTERNET" />
    <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />

    <uses-sdk android:minSdkVersion="19" android:targetSdkVersion="27" />

    <application
        android:allowBackup="true"
        android:icon="@mipmap/ic_launcher"
        android:label="@string/app_name"
        android:roundIcon="@mipmap/ic_launcher_round"
        android:supportsRtl="true"
        android:theme="@style/AppTheme">
        <activity android:name=".MainActivity">
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />

                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>
        <activity android:name="com.emerchantpay.gateway.genesisandroid.api.ui.GenesisWebViewActivity"/>
    </application>
</manifest>

MainActivity.kt

import android.R
import android.app.Activity
import android.os.Bundle
import android.view.View

import com.emerchantpay.gateway.androidgenesissample.R
import com.emerchantpay.gateway.genesisandroid.api.ui.AlertDialogHandler
import com.emerchantpay.gateway.genesisandroid.api.constants.Endpoints
import com.emerchantpay.gateway.genesisandroid.api.constants.Environments
import com.emerchantpay.gateway.genesisandroid.api.constants.ErrorMessages
import com.emerchantpay.gateway.genesisandroid.api.constants.Locales
import com.emerchantpay.gateway.genesisandroid.api.internal.Genesis
import com.emerchantpay.gateway.genesisandroid.api.internal.request.PaymentRequest
import com.emerchantpay.gateway.genesisandroid.api.internal.request.TransactionTypesRequest
import com.emerchantpay.gateway.genesisandroid.api.internal.response.Response
import com.emerchantpay.gateway.genesisandroid.api.models.Country
import com.emerchantpay.gateway.genesisandroid.api.models.Currency
import com.emerchantpay.gateway.genesisandroid.api.models.GenesisError
import com.emerchantpay.gateway.genesisandroid.api.models.PaymentAddress
import com.emerchantpay.gateway.genesisandroid.api.models.WPFTransactionTypes
import com.emerchantpay.gateway.genesisandroid.api.util.Configuration

import java.math.BigDecimal
import java.util.UUID

class MainActivity : Activity() {

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

    @Throws(IllegalAccessException::class)
    fun loadPaymentPage(view: View) {

        // Generate unique Id
        val uniqueId = UUID.randomUUID().toString()

        // Create configuration
        val configuration = Configuration("SET_YOUR_USERNAME",
                "SET_YOUR_PASSWORD",
                Environments.STAGING, Endpoints.EMERCHANTPAY, Locales.EN)

        // Enable Debug mode
        configuration.setDebugMode(true)

        // Alert dialog
        var dialogHandler: AlertDialogHandler

        // Create Billing PaymentAddress
        val billingAddress = PaymentAddress("John", "Doe",
                "Fifth avenue 1", "Fifth avenue 1", "10000", "New York",
                "Washington", Country.UnitedStates)

        // Create Transaction types
        val transactionTypes = TransactionTypesRequest()
        transactionTypes.addTransaction(WPFTransactionTypes.SALE)

        // Init WPF API request
        val paymentRequest = PaymentRequest(this, uniqueId,
                BigDecimal("2.00"), Currency.USD,
                "john@example.com", "+555555555", billingAddress,
                "https://example.com", transactionTypes)

        val genesis = Genesis(this, configuration, paymentRequest)

        // Genesis Error handler
        var error: GenesisError?// Get Error Handler

        when {
            genesis.isConnected(this)!! -> {
                dialogHandler = AlertDialogHandler(this, "Error",
                        ErrorMessages.CONNECTION_ERROR)
                dialogHandler.show()
            }
        }

        when {
            genesis.isConnected(this)!! && genesis.isValidData!! -> {
                //Execute WPF API request
                genesis.push()

                // Get response
                val response = genesis.response

                // Check if response isSuccess
                when {
                    response!!.isSuccess!! -> {
                        // Get Error Handler
                        error = response!!.error

                        dialogHandler = AlertDialogHandler(this, "Failure",
                                "Code: " + error!!.code + "\nMessage: "
                                        + error!!.message)
                        dialogHandler.show()
                    }
                }
            }
        }

        when {
            genesis.isValidData!! -> {
                // Get Error Handler
                error = genesis.error

                val message = error!!.message
                val technicalMessage: String?

                when {
                    error!!.technicalMessage != null && !error!!.technicalMessage!!.isEmpty() -> technicalMessage = error!!.technicalMessage
                    else -> technicalMessage = ""
                }

                dialogHandler = AlertDialogHandler(this, "Invalid",
                        "$technicalMessage $message")

                dialogHandler.show()
            }
        }
    }
}

MainActivity.java

import android.app.Activity;
import android.os.Bundle;
import android.view.View;

import com.emerchantpay.gateway.androidgenesissample.R;
import com.emerchantpay.gateway.genesisandroid.api.ui.AlertDialogHandler;
import com.emerchantpay.gateway.genesisandroid.api.constants.Endpoints;
import com.emerchantpay.gateway.genesisandroid.api.constants.Environments;
import com.emerchantpay.gateway.genesisandroid.api.constants.ErrorMessages;
import com.emerchantpay.gateway.genesisandroid.api.constants.Locales;
import com.emerchantpay.gateway.genesisandroid.api.internal.Genesis;
import com.emerchantpay.gateway.genesisandroid.api.internal.request.PaymentRequest;
import com.emerchantpay.gateway.genesisandroid.api.internal.request.TransactionTypesRequest;
import com.emerchantpay.gateway.genesisandroid.api.internal.response.Response;
import com.emerchantpay.gateway.genesisandroid.api.models.Country;
import com.emerchantpay.gateway.genesisandroid.api.models.Currency;
import com.emerchantpay.gateway.genesisandroid.api.models.GenesisError;
import com.emerchantpay.gateway.genesisandroid.api.models.PaymentAddress;
import com.emerchantpay.gateway.genesisandroid.api.models.WPFTransactionTypes;
import com.emerchantpay.gateway.genesisandroid.api.util.Configuration;

import java.math.BigDecimal;
import java.util.UUID;

public class MainActivity extends Activity {

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
    }

    public void loadPaymentPage(View view) throws IllegalAccessException {
        // Generate unique Id
        String uniqueId = UUID.randomUUID().toString();

        // Create configuration
        Configuration configuration = new Configuration("SET_YOUR_USERNAME",
                "SET_YOUR_PASSWORD",
                Environments.Companion.getSTAGING(),
                Endpoints.Companion.getEMERCHANTPAY(),
                Locales.getEN());

        // Enable Debug mode
        configuration.setDebugMode(true);

        // Alert dialog
        AlertDialogHandler dialogHandler;

        // Create Billing PaymentAddress
        PaymentAddress billingAddress = new PaymentAddress("John", "Doe",
                "Fifth avenue 1", "Fifth avenue 1", "10000", "New York",
                "Washington", new Country().Companion.getUnitedStates());

        // Create Transaction types
        TransactionTypesRequest transactionTypes = new TransactionTypesRequest();
        transactionTypes.addTransaction(WPFTransactionTypes.SALE);

        // Init WPF API request
        PaymentRequest paymentRequest = new PaymentRequest(this, uniqueId,
                new BigDecimal("2.00"), new Currency().Companion.getUSD(),
                "john@example.com", "+555555555", billingAddress,
                "https://example.com", transactionTypes);

        Genesis genesis = new Genesis(this, configuration, paymentRequest);

        // Genesis Error handler
        GenesisError error;

        if (!genesis.isConnected(this)) {
            dialogHandler = new AlertDialogHandler(this, "Error",
                    ErrorMessages.CONNECTION_ERROR);
            dialogHandler.show();
        }

        if (genesis.isConnected(this) && genesis.isValidData()) {
            //Execute WPF API request
            genesis.push();

            // Get response
            Response response = genesis.getResponse();

            // Check if response isSuccess
            if (!response.isSuccess()) {
                // Get Error Handler
                error = response.getError();

                dialogHandler = new AlertDialogHandler(this, "Failure",
                        "Code: " + error.getCode() + "\nMessage: "
                                + error.getMessage());
                dialogHandler.show();
            }
        }

        if (!genesis.isValidData()) {
            // Get Error Handler
            error = genesis.getError();

            String message = error.getMessage();
            String technicalMessage;

            if (error.getTechnicalMessage() != null && !error.getTechnicalMessage().isEmpty()) {
                technicalMessage = error.getTechnicalMessage();
            } else {
                technicalMessage = "";
            }

            dialogHandler = new AlertDialogHandler(this, "Invalid",
                    technicalMessage + " " + message);

            dialogHandler.show();
        }
    }
}

Additional Usage

Set usage, description, lifetime

paymentRequest.setUsage("TICKETS")
paymentRequest.setDescription("Description")
paymentRequest.setLifetime(60)

paymentRequest.setUsage("TICKETS");
paymentRequest.setDescription("Description");
paymentRequest.setLifetime(60);

Set shipping address

val shippingAddress = PaymentAddress("John", "Doe", 
    "Fifth avenue 1", "Fifth avenue 1", "10000", "New York",
    "Washington", Country.UnitedStates)

paymentRequest.setShippingAddress(shippingAddress)

PaymentAddress shippingAddress = nnew PaymentAddress("John", "Doe",
        "Fifth avenue 1", "Fifth avenue 1", "10000", "New York",
        "Washington", new Country().Companion.getUnitedStates());

paymentRequest.setShippingAddress(shippingAddress);

Set Risk Params

// Risk params
val riskParams = RiskParams("1002547", "1DA53551-5C60-498C-9C18-8456BDBA74A9",
    "987-65-4320", "12-34-56-78-9A-BC", "123456",
    "emil@example.com", "+49301234567", "245.253.2.12",
    "10000000000", "1234", "100000000", "John",
    "Doe", "US", "test", "245.25 3.2.12",
    "test", "test123456", "Bin name",
    "+49301234567")

paymentRequest.setRiskParams(riskParams)

// Risk params
RiskParams riskParams = new RiskParams("1002547", "1DA53551-5C60-498C-9C18-8456BDBA74A9",
        "987-65-4320", "12-34-56-78-9A-BC", "123456",
        "emil@example.com", "+49301234567", "245.253.2.12",
        "10000000000", "1234", "100000000", "John",
        "Doe", "US", "test", "245.25 3.2.12",
        "test", "test123456", "Bin name",
        "+49301234567");

paymentRequest.setRiskParams(riskParams);

Set 3DSv2 Params

val threeDsV2Params = ThreeDsV2Params.build {
    purchaseCategory = ThreeDsV2PurchaseCategory.GOODS

    val merchantRiskPreorderDate = SimpleDateFormat("dd-MM-yyyy").calendar.apply {
        time = Date()
        add(Calendar.DATE, 5)
    }.time

    merchantRisk = ThreeDsV2MerchantRiskParams(
        ThreeDsV2MerchantRiskShippingIndicator.DIGITAL_GOODS,
        ThreeDsV2MerchantRiskDeliveryTimeframe.SAME_DAY,
        ThreeDsV2MerchantRiskReorderItemsIndicator.REORDERED,
        ThreeDsV2MerchantRiskPreorderPurchaseIndicator.MERCHANDISE_AVAILABLE,
        merchantRiskPreorderDate,
        true, 3
    )

    cardHolderAccount = ThreeDsV2CardHolderAccountParams(
        SimpleDateFormat("dd-MM-yyyy").parse("11-02-2021"),
        ThreeDsV2CardHolderAccountUpdateIndicator.UPDATE_30_TO_60_DAYS,
        SimpleDateFormat("dd-MM-yyyy").parse("13-02-2021"),
        ThreeDsV2CardHolderAccountPasswordChangeIndicator.PASSWORD_CHANGE_NO_CHANGE,
        SimpleDateFormat("dd-MM-yyyy").parse("10-01-2021"),
        ThreeDsV2CardHolderAccountShippingAddressUsageIndicator.ADDRESS_USAGE_MORE_THAN_60DAYS,
        SimpleDateFormat("dd-MM-yyyy").parse("10-01-2021"),
        2, 129, 1, 31,
        ThreeDsV2CardHolderAccountSuspiciousActivityIndicator.NO_SUSPICIOUS_OBSERVED,
        ThreeDsV2CardHolderAccountRegistrationIndicator.REGISTRATION_30_TO_60_DAYS,
        SimpleDateFormat("dd-MM-yyyy").parse("03-01-2021")
    )

    recurring = ThreeDsV2RecurringParams()
}

paymentRequest?.setThreeDsV2Params(threeDsV2Params)

Calendar calendar = Calendar.getInstance();
calendar.setTime(new Date());
calendar.add(Calendar.DATE, 5);
Date merchantRiskPreorderDate=calendar.getTime();

// Create a builder
ThreeDsV2Params.Builder threeDsV2ParamsBuilder=new ThreeDsV2Params.Builder();

// Set 3DSv2 purchase params
threeDsV2ParamsBuilder.setPurchaseCategory(ThreeDsV2PurchaseCategory.GOODS);

// Set 3DSv2 merchant risk params
ThreeDsV2MerchantRiskShippingIndicator.DIGITAL_GOODS,
ThreeDsV2MerchantRiskParams merchantRisk=new ThreeDsV2MerchantRiskParams(
        ThreeDsV2MerchantRiskDeliveryTimeframe.SAME_DAY,
        ThreeDsV2MerchantRiskReorderItemsIndicator.REORDERED,
        ThreeDsV2MerchantRiskPreorderPurchaseIndicator.MERCHANDISE_AVAILABLE,
        merchantRiskPreorderDate,
        true,3);
threeDsV2ParamsBuilder.setMerchantRisk(merchantRisk);

// Set 3DSv2 card holder account params
ThreeDsV2CardHolderAccountParams cardHolderAccount=new ThreeDsV2CardHolderAccountParams(
        new SimpleDateFormat("dd-MM-yyyy").parse("11-02-2021"),
        ThreeDsV2CardHolderAccountUpdateIndicator.UPDATE_30_TO_60_DAYS,
        new SimpleDateFormat("dd-MM-yyyy").parse("13-02-2021"),
        ThreeDsV2CardHolderAccountPasswordChangeIndicator.PASSWORD_CHANGE_NO_CHANGE,
        new SimpleDateFormat("dd-MM-yyyy").parse("10-01-2021"),
        ThreeDsV2CardHolderAccountShippingAddressUsageIndicator.ADDRESS_USAGE_MORE_THAN_60DAYS,
        new SimpleDateFormat("dd-MM-yyyy").parse("10-01-2021"),
        2,129,1,31,
        ThreeDsV2CardHolderAccountSuspiciousActivityIndicator.NO_SUSPICIOUS_OBSERVED,
        ThreeDsV2CardHolderAccountRegistrationIndicator.REGISTRATION_30_TO_60_DAYS,
        new SimpleDateFormat("dd-MM-yyyy").parse("03-01-2021"));
threeDsV2ParamsBuilder.setCardHolderAccount(cardHolderAccount);

// Set 3DSv2 recurring params
ThreeDsV2RecurringParams recurring=new ThreeDsV2RecurringParams()

// Create an instance of ThreeDsV2Params via builder
ThreeDsV2Params threeDsV2Params=threeDsV2ParamsBuilder.build();
        
paymentRequest.setThreeDsV2Params(threeDsV2Params);

Set Recurring Params

// Create Transaction types
val transactionTypes = TransactionTypesRequest()
transactionTypes.addTransaction(WPFTransactionTypes.SALE)

transactionTypes.setMode(RecurringMode.AUTOMATIC)
        .setInterval(RecurringInterval.DAYS)
        .setFirstDate(FIRST_DATE)
        .setTimeOfDay(7)
        .setPeriod(7)
        .setAmount(500)
        .setMaxCount(10)

// Init WPF API request
val paymentRequest = PaymentRequest(this, uniqueId,
        BigDecimal("2.00"), Currency.USD,
        "john@example.com", "+555555555", billingAddress,
        "https://example.com", transactionTypes)

paymentRequest?.transactionTypes?.customAttributes?.addAttribute("recurring_type", RecurringType.INITIAL.value)
paymentRequest?.transactionTypes?.customAttributes?.addAttribute("recurring_category", RecurringCategory.SUBSCRIPTION.value)

// ...

// Create Transaction types
TransactionTypesRequest transactionTypes = new TransactionTypesRequest();
        transactionTypes.addTransaction(WPFTransactionTypes.SALE)
        .addParam("recurring_type", RecurringType.INITIAL.getValue())
        .addParam("recurring_category", RecurringCategory.SUBSCRIPTION.getValue());
        
transactionTypes.setMode(RecurringMode.AUTOMATIC)
        .setInterval(RecurringInterval.DAYS)
        .setFirstDate(FIRST_DATE)
        .setTimeOfDay(7)
        .setPeriod(7)
        .setAmount(500)
        .setMaxCount(10);

// Init WPF API request
PaymentRequest paymentRequest = new PaymentRequest(this, uniqueId,
        new BigDecimal("2.00"), new Currency().Companion.getUSD(),
        "john@example.com", "+555555555", billingAddress,
        "https://example.com", transactionTypes);


// ...

Set Google Pay

// Create Transaction types and add Google Pay transaction
val transactionTypes = TransactionTypesRequest()
transactionTypes.addTransaction(WPFTransactionTypes.GOOGLE_PAY)

// Init WPF API request
val paymentRequest = PaymentRequest(this, uniqueId,
    BigDecimal("2.00"), Currency.USD,
    "john@example.com", "+555555555", billingAddress,
    "https://example.com", transactionTypes)

// Add Google Pay transaction subtype (one of GooglePayPaymentSubtype.AUTHORIZE, 
// GooglePayPaymentSubtype.SALE or GooglePayPaymentSubtype.INIT_RECURRING_SALE) 
paymentRequest?.setGooglePayPaymentSubtype(GooglePayPaymentSubtype.SALE)

// Create Transaction types and add Google Pay transaction
TransactionTypesRequest transactionTypes = new TransactionTypesRequest();
transactionTypes.addTransaction(WPFTransactionTypes.GOOGLE_PAY);

// Init WPF API request
PaymentRequest paymentRequest = new PaymentRequest(this, uniqueId,
    new BigDecimal("2.00"), new Currency().Companion.getUSD(),
    "john@example.com", "+555555555", billingAddress,
    "https://example.com", transactionTypes);

// Add Google Pay transaction subtype (one of GooglePayPaymentSubtype.AUTHORIZE, 
// GooglePayPaymentSubtype.SALE or GooglePayPaymentSubtype.INIT_RECURRING_SALE) 
paymentRequest.setGooglePayPaymentSubtype(GooglePayPaymentSubtype.SALE);

Running Tests

./gradlew test

Name		Name	Last commit message	Last commit date
Latest commit History 30 Commits
.github		.github
.idea		.idea
GenesisAndroid		GenesisAndroid
gradle/wrapper		gradle/wrapper
scripts		scripts
.gitignore		.gitignore
.travis.yml		.travis.yml
LICENSE		LICENSE
README.md		README.md
build.gradle		build.gradle
gradle.properties		gradle.properties
gradlew		gradlew
gradlew.bat		gradlew.bat
settings.gradle		settings.gradle

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Repository files navigation

Genesis Android SDK

Table of Contents

Requirements

Installation and Setup

Gradle

Basic Usage

Additional Usage

Running Tests

About

Releases 30

Packages

Languages

License

GenesisGateway/android_sdk

Folders and files

Latest commit

History

Repository files navigation

Genesis Android SDK

Table of Contents

Requirements

Installation and Setup

Gradle

Basic Usage

Additional Usage

Running Tests

About

Resources

License

Stars

Watchers

Forks

Releases 30

Packages 0

Languages

Packages