direct-sdk-client-android

SDK to communicate with the Ingenico ePayments platform using the Ingenico Direct Client API

License

License

MIT
Categories

Categories

CLI User Interface
GroupId

GroupId

com.ingenico.direct
ArtifactId

ArtifactId

direct-sdk-client-android
Last Version

Last Version

1.0.1
Release Date

Release Date

Type

Type

aar
Description

Description

direct-sdk-client-android
SDK to communicate with the Ingenico ePayments platform using the Ingenico Direct Client API
Project URL

Project URL

https://github.com/Ingenico/direct-sdk-client-android
Project Organization

Project Organization

Ingenico ePayments
Source Code Management

Source Code Management

https://github.com/Ingenico/direct-sdk-client-android

Download direct-sdk-client-android

How to add to project

<!-- https://jarcasting.com/artifacts/com.ingenico.direct/direct-sdk-client-android/ -->
<dependency>
    <groupId>com.ingenico.direct</groupId>
    <artifactId>direct-sdk-client-android</artifactId>
    <version>1.0.1</version>
    <type>aar</type>
</dependency>
// https://jarcasting.com/artifacts/com.ingenico.direct/direct-sdk-client-android/
implementation 'com.ingenico.direct:direct-sdk-client-android:1.0.1'
// https://jarcasting.com/artifacts/com.ingenico.direct/direct-sdk-client-android/
implementation ("com.ingenico.direct:direct-sdk-client-android:1.0.1")
'com.ingenico.direct:direct-sdk-client-android:aar:1.0.1'
<dependency org="com.ingenico.direct" name="direct-sdk-client-android" rev="1.0.1">
  <artifact name="direct-sdk-client-android" type="aar" />
</dependency>
@Grapes(
@Grab(group='com.ingenico.direct', module='direct-sdk-client-android', version='1.0.1')
)
libraryDependencies += "com.ingenico.direct" % "direct-sdk-client-android" % "1.0.1"
[com.ingenico.direct/direct-sdk-client-android "1.0.1"]

Dependencies

runtime (3)

Group / Artifact Type Version
com.google.code.gson : gson jar 2.8.5
org.apache.commons : commons-lang3 jar 3.9
androidx.annotation » annotation jar 1.1.0

test (2)

Group / Artifact Type Version
junit : junit jar 4.12
org.mockito : mockito-core jar 1.10.19

Project Modules

There are no modules declared in this project.

Ingenico Direct - Android SDK

The Ingenico Direct Android SDK provides a convenient way to support a large number of payment methods inside your Android app. It supports Jelly Bean (Android version 4.1.x) and up out-of-the box. The Android SDK comes with an example app that illustrates the use of the SDK and the services provided by Ingenico ePayments on the Ingenico ePayments platform.

See the Ingenico Direct Developer Hub for more information on how to use the SDK.

Installation via Gradle

Add a requirement to the SDK to your build.gradle file, where x.y.z is the version number:

dependencies {
    // other dependencies
    implementation 'com.ingenico.direct:direct-sdk-client-android:x.y.z'
}

Manual installation

To install the Android SDK and the example app, first download the code from GitHub.

$ git clone https://github.com/Ingenico/direct-sdk-client-android.git

Afterwards, you can open the project you just downloaded in Android Studio to execute the example app.

To use the Android SDK in your own app, you need to add the ingenicodirect-sdk gradle module to the build path of your project as follows:

  1. Open your app in Android Studio.
  2. Select File, New, Import Module.
  3. Select source directory by clicking on the ... button.
  4. Browse to the downloaded Android SDK project, select the folder ingenicodirect-sdk which contains all the SDK source code, and click OK.
  5. Click on Finish to add the ingenicodirect-sdk module to your project.
  6. Wait until Android Studio is done building/cleaning the project, and you see a module named ingenicodirect appear in your Android Studio project browser.
  7. The last step is now to tell your App to use the added module.
  8. Select your app, and click File, Project Structure. In the Modules section select your app, and go to the tab Dependencies.
  9. Click on the + sign and select Module dependency. 10.Select the ingenicodirect-sdk module and press OK.
  10. You now have access to use all the Android SDK classes.

Running tests

The Android SDK comes with a set of integration tests. To run these tests, you will first need to modify file ingenicodirect-sdk-integrationtest/src/test/resources/itconfiguration.properties. This file is mostly complete, but you need to fill in the actual values for the following keys:

  • direct.api.apiKeyId for the API key id to use. This can be retrieved from the Configuration Center.
  • direct.api.secretApiKey for the secret API key to use. This can be retrieved from the Configuration Center.
  • direct.api.merchantId for your merchant ID.

Besides these settings, you can also modify the settings for the Java SDK, which is used to create the sessions and tokens needed to run the tests.

Afterwards, you can run the tests as follows:

  1. Open the SDK in Android Studio. If you haven't opened it before, choose to import a project and browse to the Android SDK project.
  2. On the Project tab, open ingenicodirect-sdk-integrationtest, then java. Right click on the com.ingenico.direct.gateway.sdk.client.android.integrationtest package, and click on Run 'Tests in 'com.ingenicodirect.ga...'.
com.ingenico.direct

Ingenico

Versions

Version
1.0.1