Android POS Integration SDK

This repository contains the implementation of a library that allows your application to connect with PayPlaza terminal app to perform a payment in CM|PayPlaza environment. You only would need an Android POS device with PayPlaza terminal app installed.

Release notes

Compatibility table

SDK	Terminal
1.3.0	2.17.0
1.2.1	2.12.0
1.2.0	2.11.0
1.1.4	2.7.0
1.1.3	2.0.1
1.1.2	2.0.0
1.1.0	1.2.0
1.0.1	1.1.1
1.0.0	1.1.1

Versions

1.3.0

• Introduced a new acceptance build type which allows the integrator app to connect to the Terminal app in acceptance environment.
• Dev build type is deprecated and will be removed in future releases. Please use acceptance build type instead.

1.2.1

• Add new MAT specific error codes.

1.2.0

• Add support for MAT feature on SDK.
• Fix a bug related to onCrash callback.

1.1.5

• Fix a typo.

1.1.4

• Fix typo in error description
• Send information about SDK version to Terminal app

1.1.3

• Not start new operation if another one is already in progress

• Remove isTipping parameter from SDK payment Data

1.1.2

• Proguard problems in some scenarios

1.1.0

• Added Start pre authorization support
• Added Cancel pre authorization support
• Added Confirm pre authorization support
• Check device's battery

1.0.1

• Forward AUTO_TIMEZONE_ENABLE error from Terminal

1.0.0

• Initial implementation

Adding POS Integration Library to project

You can include this library into your Android project by adding first the JitPack repository to your root build.gradle

dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        google()
        mavenCentral()
        maven { url 'https://jitpack.io' }
    }
}

Next, add the dependency to your app-level build.gradle

Production:

dependencies {
    [...]
    // CM|PayPlaza Android POS Integration library
    implementation 'com.github.cmdotcom.android-pos-integration-sdk-kotlin:androidposintegrationsdk:<version-tag>'
}

Acceptance:

dependencies {
    [...]
    // CM|PayPlaza Android POS Integration library
    implementation 'com.github.cmdotcom.android-pos-integration-sdk-kotlin:androidposintegrationsdk-acc:<version-tag>'
}

dependencies { [...] // CM|PayPlaza Android POS Integration library implementation files('lib/<aar_file_name>') }

After this dependency is included, you can start using functionality contained in this library to perform operations in CM|PayPlaza environment.

More information on how to work with this library is available in the following link: [Getting started with App 2 app integration (cm.com)](https://developers.cm.com/payments-platform/v1.0.2/docs/app-2-app-integration).

Also an [example](https://github.com/cmdotcom/sunmi-ecr-example-kotlin) of how to implement the Integration SDK is available.