EdfaPay SoftPos SDK

Installation

[!IMPORTANT]

Configure Repository

Its is important to add the gradlePluginPortal and maven jipack with authorization repositories to your project, It's allows the gradle to download edfapay plugin from gradlePluginPortal the native dependency from jitpack.

If your project build was configured to prefer settings repositories, Place the below maven block to project ./settings.gradle

pluginManagement {
    repositories {

        // Add below at same
        gradlePluginPortal()
    }
}

dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        mavenCentral()

        // Add below at same
        maven {
            url "https://jitpack.io"
            credentials { username "jp_i9ed2av1lj1kjnqpgobpeh0e7k" }
        }
    }
}

---

If your project build was configured to prefer traditional build.gradle repositories, Place the below maven block to project ./build.gradle

allprojects {
  repositories {

    // Add below at same
    gradlePluginPortal()
    maven{
      url "https://jitpack.io"
      credentials{
        username "jp_i9ed2av1lj1kjnqpgobpeh0e7k"
      }
    }
  }
}

[!IMPORTANT]

Adding Edfapay Gradle plugin

It is important to apply edfapay plugin to your app module build.gradle

Using plugin DSL:

plugins {
  id("com.edfapay.softpos.tools") version "1.0.1"
}

---

Using legacy plugin application:

Add the classpath to the project build.gradle

buildscript {
  dependencies {
    classpath("com.edfapay.softpos:plugin:1.0.1") // add this line
  }
}

apply(plugin = "com.edfapay.softpos.tools")

Learn how to apply plugins to subprojects

[!IMPORTANT]

Adding dependency

It is important to add dependency to your project module build.gradle

• Provide your partner code to the script below at install method like: install("xyz...")
• If you provide the null in install method like: install(null), The plugin will look for the value from variable EDFAPAY_PARTNER at gradle.properties of your project and apply it to the script. ```groovy dependencies { . . . //add below at same edfapay{

    softpos{
        install("You Partner Code Here Received from EdfaPay")
    }
  

  } }

// Also add below at same configurations.configureEach { exclude group: "com.github.edfapay.emv", module: "mastercard-debug" exclude group: "com.github.edfapay.emv", module: "discovery-corec-release" exclude group: "com.github.edfapay.emv", module: "discovery-readerc-release" }

```

Setting EdfaPay Plugin Properties

You must define the below properties in your project gradle.properties

• EDFAPAY_PARTNER

  • EdfaPay will provide the partner code, The Developer should set the property. example: EDFAPAY_PARTNER=706172746E65727Exxxxxxxxxxxxx

• EDFAPAY_SDK_MODE

  • The developer should set the property to production. example: EDFAPAY_SDK_MODE=production
  • If the partner requests some enhancement and a new feature in SDK, the developer will directed to change the mode to development or any value for testing.
  • If the developer wants to define the mode, then no need to specify version to EDFAPAY_SDK_VERSION property.

• EDFAPAY_SDK_VERSION

  • The developer should set the property with the required version of SDK suggested by EdfaPay. example: EDFAPAY_SDK_VERSION=1.0.6.1
  • If the developer defines the version then mode will be skipped and a specified version will downloaded as a dependency.

Usage

1: Import

import com.edfapay.paymentcard.EdfaPayPlugin
import com.edfapay.paymentcard.Env
import com.edfapay.paymentcard.model.TransactionType
import com.edfapay.paymentcard.model.TxnParams

2: Initialization

EdfaPayPlugin.initiate(
    context = this,
    environment = Env.DEVELOPMENT,
    authCode = "Your login auth code here received from edfapay",
    onSuccess = { plugin ->
        // Successfully initialized
    }
){ err ->
    err.printStackTrace()
}

4: Pay

val params = TxnParams(
    amount = amount,
    transactionType = TransactionType.PURCHASE,
)

EdfaPayPlugin.pay(
    this, 
    params,
    onRequestTimerEnd = {
        Toast.makeText(this, "Server Request Timeout", Toast.LENGTH_SHORT).show()
    },

    onCardScanTimerEnd = {
        Toast.makeText(this, "Card Scan Timeout", Toast.LENGTH_SHORT).show()
    },

    onPaymentProcessComplete = { status, code, transaction, isProcessComplete ->
        when (status) {
            true -> Toast.makeText(this, "Success: Payment Process Complete", Toast.LENGTH_SHORT).show()
            false -> Toast.makeText(this, "Failure: Payment Process Complete", Toast.LENGTH_SHORT).show()
        }
    },

    onCancelByUser = {
        Toast.makeText(this, "Cancel: Cancel By User", Toast.LENGTH_SHORT).show()
    },

    onError = { e ->
        Toast.makeText(this, "Error: ${e.message}", Toast.LENGTH_SHORT).show()
    },
)

[!TIP]

Enable or Disable Logs

The developer can enable or disable logging at the SDK

EdfaPayPlugin.enableLogs = true

Setting the animation speed

The developer can set the speed for animations for status and card scheme. It will control the process speed.

EdfaPayPlugin.animationSpeedX = 2.0f

Setting Theme

EdfaPayPlugin.theme
    .setButtonBackgroundColor("#06E59F")
    .setButtonTextColor("#000000")
    .setHeaderImage(this, R.drawable.logo)
    .setPoweredByImage(this, R.drawable.ogo);

License

MIT