Android SDK Guide

This guide provides detailed instructions for integrating the Scanovate Colombia SDK into your Android application, enabling robust identity validation processes through facial biometric verification.

Requirements and Compatibility

Before starting the integration process, ensure your development environment meets the following requirements:

Installation

1. Add the library

Download the "hybridComponent_3_0_0_15.aar" library and add it to your project's libs folder. Ensure you configure your project's build.gradle file to include the library as a dependency:

dependencies {
    implementation(name: 'hybridComponent_3_0_0_15', ext: 'aar')
}

2. Import Required Libraries

Add the following imports in your activity or fragment where you intend to use the Scanovate SDK:

Java

import mabel_tech.com.scanovate_demo.ScanovateHandler;
import mabel_tech.com.scanovate_demo.ScanovateSdk;
import mabel_tech.com.scanovate_demo.model.CloseResponse;
import mabel_tech.com.scanovate_demo.network.ApiHelper;
import mabel_tech.com.scanovate_demo.network.RetrofitClient;

The CloseResponse object will contain the results of the transaction, providing detailed feedback on the validation process.


Example Implementation

For a practical example of how to implement the Scanovate SDK in your Android application, refer to the following steps:

Example

// Example capture method implementation

    public void capture() {
                HybridComponent.start(this,
                "documentType"                     //Tipo de Documento "VerificarID en Documentación de ADO"
                "es",                              //language: "en") // en (para ingles) es (para español)
                "lulobankqa"                        //ProyectName
                "db92efc69991",                      //ApiKey        
                "1",                                 //ProductId
                "https://adocolumbia.ado-tech.com/lulobankqa/api/",     //Url_Sdk 
                 "https://api-dev.ado-tech.com/api/EventTracer/",         //Url_TracerBackendServices       (Servicio Proporcionado Por nosotros para la Flujo de los LOGS o TAGS del proceso.) ** Opcional**   
                 "true"                        //ImmersiveMode   
                "f47ac10b-58cc-4372-a567-0e02b2c3d479",                  //ProcessID (ID creado con el servicio de CreateProccees para trasa de eventos)         **Opcional**     
                functionCapture,                      1  Livennes ,  2 CardCapture
                isFrontSide,                          // Captura de Documento (True captura Frontal)(False Captura Trasera)
                null,                                  //Token
                "null",                                
                new ScanovateHandler() {
                    @Override
                    public void onSuccess(CloseResponse response, int code, String uuidDevice) {
                        progress.show();
                        String calificacion = response.getExtras().getStateName();
                        evaluateTransaction(response.getTransactionId());
                    }

                    @Override
                    public void onFailure(CloseResponse closeResponse) {
                        String calificacion = closeResponse.getExtras().getStateName() +" "+ closeResponse.getExtras().getAdditionalProp1() ;
                    }


                });
    }

Parameters Explained
Process Transaction Results

After capturing the necessary data, use the RetrofitClient to send the data for validation and display the final state of the transaction to the user.

State Codes Reference

Be aware of the following state codes when processing responses:

This guide aims to streamline the integration process of the Scanovate Colombia SDK into your Android application, ensuring you can efficiently implement a robust identity validation system.

Demo Application

For a comprehensive example, including full source code demonstrating the integration and usage of the Scanovate Colombia SDK, visit our GitHub repository:

image.png

Scanovate Colombia SDK Demo App For Android

This demo app provides a hands-on example to help you understand how to integrate and utilize the SDK in your own applications.


Revision #14
Created 22 March 2024 21:50:02 by Admin
Updated 28 April 2025 22:43:20 by roger de avila