Getting Started

The Merchant PayContactless SDK enables seamless contactless payment and refund operations from your React Native application. The SDK handles payment transaction UI internally, provides querying of transaction history, daily summaries, and lot more.

Integrators must initialize the SDK early in the app lifecycle to ensure proper transaction handling.

Prerequisites

Before integrating this SDK, ensure you have:

• API Key, Organization ID, and Google Cloud ID. Learn more on SDK Initialization section to understand how to get this parameters.

• Merchant ID, Terminal ID, Phone Number, Business Name

• React Native dependencies installed in your project, preferably;

"react": "19.2.0" or updward,
"react-native": "0.83.1" or upward

To download the PayContactless embedded SDK, you will be provided with secure credentials (username and password).

Follow the steps below to configure your project and sync the SDK dependency.

Supported Android SDKs

• Minimum Android SDK: 30

• Kotlin minimum version: 1.9

• Minimum Android NDK version: 26.+

Add the required permissions in android directory AndroidManifest.xml:

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

 <uses-permission android:name="android.permission.NFC" />
 <uses-permission android:name="android.permission.READ_PHONE_STATE" />
 <uses-feature android:name="android.hardware.nfc" android:required="false" />

No custom activities are required. The SDK handles UI internally.

Add the Maven repository block to your android directory:

• settings.gradle

We recommend keeping the credential in your gradle.properties file, and avoid committing this file to your repo.

You can ignore this in git by adding it to .gitignore

Groovy DSL

def libUser = hasProperty('YOUR USERNAME') ? YOUR USERNAME : ""
def libPass = hasProperty('YOUR PASSWORD') ? YOUR PASSWORD : ""
//dependencyResolutionManagement block
dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.PREFER_SETTINGS)
    repositories {
        google()
        mavenCentral()
        flatDir {
            dirs 'libs'
        }

        maven {
            url "https://nexus.prophius-api.com/repository/maven-releases/"
            credentials {
                username = libUser
                password = libPass
            }
        }
    }
}

We recommend using the following version of ndkd kotlin.

Add this to your project level buildscript block, and your reference in your app level android block, accordingly.

ndkVersion = "27.1.12297006"
kotlinVersion = "2.1.20"

Add the SDK dependency in your module level build.gradle file of the project like below.

implementation 'com.prophius:paycontactlesssdk.embed.stage:3.4.17'

SDK does not allow to run the app on debug. The application must be release build.

Check Security Mechanisms section for the other restriction.

Security Mechanisms

This version of the SDK must be used in integration phase by developer. For the internal and external tests, the version of SDK must never be used.

Required Dependencies

SDK needs some third party libraries and the integrator app must have these dependencies. The libraries which is shared below should be added to the build.gradle file.

// Room
    implementation "androidx.room:room-runtime:2.7.0"
    annotationProcessor "androidx.room:room-compiler:2.7.0"
// SQLCipher
    implementation "net.zetetic:android-database-sqlcipher:4.5.0"
// Gson
    implementation 'com.google.code.gson:gson:2.10.1'
// Lottie
    implementation "com.airbnb.android:lottie:3.4.0"
// Google Play Services
    implementation 'com.google.android.gms:play-services-base:18.6.0'
// Google Play Integrity
    implementation 'com.google.android.play:integrity:1.4.0'
// OkHttp3
    implementation 'com.squareup.okhttp3:okhttp:4.12.0'
    implementation 'com.squareup.okhttp3:logging-interceptor:4.10.0'
// Android appcompact & material ui
    implementation 'androidx.appcompat:appcompat:1.7.0'
    implementation 'com.google.android.material:material:1.9.0'

In order to support schemas' branding animations, jetifier tools must be enabled on your project. The following configuration must be added on your gradle.properties file.

# Automatically convert third-party libraries to use AndroidX
android.enableJetifier=true