Android

Use esta guía para integrar el SDK de Thales en una aplicación de comerciante para Android.

Paquete de entrega

El paquete de entrega del SDK incluye:

Nombre	Descripción
tmgsdk-debug-<versión>-<fecha_de_lanzamiento>.aar	AAR de depuración para el SDK de Thales.
tmgsdk-release-<versión>-<fecha_de_lanzamiento>.aar	AAR de lanzamiento para el SDK de Thales.
demo	Proyecto de ejemplo que muestra cómo integrar y usar el SDK.
javadoc	Documentación de la API del SDK.

Dependencias

Nombre de la dependencia	Versión	Descripción
JNA	5.5.0	Esta biblioteca se utiliza para acceder a las bibliotecas nativas que se incluyen con el SDK de Thales.
AndroidX Biometric	1.1.0	Esta biblioteca se utiliza para la autenticación biométrica en dispositivos Android.

Desde la versión v2.0.0 del SDK, OkHttp ya no es obligatorio.

Integrar el SDK

1. Cree una carpeta llamada libs bajo el directorio del proyecto.

Ejemplo libs carpeta que contiene el AAR del SDK.

1. Copiar tmgsdk-<variant>-<version>-<release_date>.aar en la libs carpeta.

   variant es debug o lanzamiento.
2. Abra el archivo app/build.gradle y agregue las siguientes dependencias:

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

Configurar el SDK

• Desde la versión v2.0.0 del SDK, la aplicación ya no está obligada a proporcionar el valor PIN del certificado.
• Desde la versión v3.0.0 del SDK, el SDK ya no es compatible con Android Keyguard.

Configure Thales SDK antes de llamar a cualquier API del SDK.

Construya un TMGClientConfiguration con los parámetros requeridos:

• Contexto de la aplicación
• URL del servidor
• Certificado del servidor
• Identificador de clave

1. Cree un TMGClientConfiguration

Obtenga la URL del servidor, el certificado del servidor y el identificador de clave durante el registro.

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

2. Comprobar compatibilidad biométrica

Compruebe si el dispositivo admite la autenticación biométrica.

int biometricSupport = DeviceAuthenticationChecker.getBiometricsSupport(activity);
if (biometricSupport == BiometricsSupport.SUPPORTED) {
    // El dispositivo actual admite biometría.
}

3. Cree un VisaCTFHelper

Cree el asistente para iniciar el emparejamiento del dispositivo y autenticar transacciones para Visa CTF y DAF.

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

4. Cree un MastercardTAFHelper

Cree el asistente para iniciar el emparejamiento del dispositivo y autenticar transacciones para Mastercard TAF.

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