Android

Use this guide to integrate the Thales SDK into an Android merchant application.

Delivery package

The SDK delivery package includes:

Name	Description
tmgsdk-debug-<version>-<release_date>.aar	Debug AAR for Thales SDK.
tmgsdk-release-<version>-<release_date>.aar	Release AAR for Thales SDK.
demo	Sample project that shows how to integrate and use the SDK.
javadoc	SDK API documentation.

Dependencies

Dependency Name	Version	Description
JNA	5.5.0	This library is used to access the native libraries shipped with Thales SDK.
AndroidX Biometric	1.1.0	This library is used for biometric authentication on Android devices.

Since SDK v2.0.0, OkHttp is no longer required.

Integrate the SDK

1. Create a folder called libs under the project directory.

Example libs folder containing the SDK AAR.

1. Copy tmgsdk-<variant>-<version>-<release_date>.aar into the libs folder.

   variant is debug or release.
2. Open the app/build.gradle file and add the following dependencies:

implementation 'androidx.biometric:biometric:1.1.0'
implementation 'net.java.dev.jna:jna:5.5.0@aar'
implementation fileTree(dir: 'libs', include: ['*.aar'])

Configure the SDK

• Since SDK v2.0.0, the application is no longer required to provide the certificate PIN value.
• Since SDK v3.0.0, the SDK no longer supports Android Keyguard.

Configure Thales SDK before calling any SDK API.

Build a TMGClientConfiguration with the required parameters:

• Application context
• Server URL
• Server certificate
• Key identifier

1. Create a TMGClientConfiguration

Get the server URL, server certificate, and key identifier during onboarding.

Activity activity;
String serverUrl;
byte[] serverCertificate;
String keyIdentifier;
TMGClientConfiguration tmgClientConfiguration = new TMGClientConfiguration(activity, 
                                                                           serverUrl, 
                                                                           serverCertificate, 
                                                                           keyIdentifier);

2. Check biometric support

Check whether the device supports biometric authentication.

int biometricSupport = DeviceAuthenticationChecker.getBiometricsSupport(activity);
if (biometricSupport == BiometricsSupport.SUPPORTED) {
    // The current device supports biometrics.
}

3. Create a VisaCTFHelper

Create the helper to start device binding and authenticate transactions for Visa CTF and DAF.

public void initVisaCTFHelper(@NonNull TMGClientConfiguration tmgClientConfiguration) {
    try {
        VisaCTFHelper visaCTFHelper = TMGClient.getInstance().createVisaCTFHelper(tmgClientConfiguration);
    } catch (TMGClientException e) {
        // Handle error.
    }
}

4. Create a MastercardTAFHelper

Create the helper to start device binding and authenticate transactions for Mastercard TAF.

public void initMastercardTAFHelper(@NonNull TMGClientConfiguration tmgClientConfiguration) {
   try {
       MastercardTAFHelper mastercardTAFHelper = TMGClient.getInstance().createMastercardTAFHelper(tmgClientConfiguration);
   } catch (TMGClientException e) {
       // Handle error.
   }
}