Implementation Guide

Authentication

A unique access token should be created upon each SDK entry. In order to generate an access token, please refer to Valify's Authentication Documentation.

Security Warning: For improved security, consider implementing the access token fetching logic outside the Activity. This helps keep sensitive credentials secure and reduces potential exposure within the Activity/Fragment code.

Initialization

Declare the following variables

Kotlin

private lateinit var docKitBuilder: VIDVDocKitConfig.Builder

Java

private VIDVDocKitConfig.Builder docKitBuilder;

Initialize your SDK in your activity or fragment as follows

Kotlin

docKitBuilder = VIDVDocKitConfig.Builder()

Java

docKitBuilder= new VIDVDocKitConfig.Builder();

Configurations

The SDK builder is separated into two components.

Make sure that you fetched the access token successfully before passing it to the Builder object.

Required Configurations

Kotlin

docKitBuilder
    .setBaseUrl("Base Url") // add your actual base url
    .setAccessToken("Access Token") // add the fetched access token here
    .setBundleKey("Bundle Key") // add your actual bundle key
    .setDocumentType(VIDVDocKitDocType.passport()) // Passport

Java

docKitBuilder
.setBaseUrl("Base Url"); //add your actual base url
.setAccessToken("Access Token"); //add the fetched access token here
.setBundleKey("Bundle Key"); //add your actual bundle key
.setDocumentType(VIDVDocKitDocType.passport());  // Passport 

Optional Configurations

Kotlin

.setLanguage("en") // or "ar"
.setCollectUserInfo(true) // enable location permissions if true
.previewCapturedImage(true) // show preview of captured image
.reviewData(true) // show a review screen before finishing
.manualCaptureMode(true) // enable manual capture

// UI Customization
config.setPrimaryColor("#FFA500".toColorInt())
config.setLogo(VIDVLogo.ResourceLogo(R.drawable.logo))
config.setLogo(VIDVLogo.ByteArrayLogo(byteArray))
config.setLogo(VIDVLogo.Empty()) // Hide logo

Java

docKitBuilder.setLanguage("en"); // or "ar"
docKitBuilder.setCollectUserInfo(true); // enable location permissions if true
docKitBuilder.setPreviewCapturedImage(true); // show preview of captured image
docKitBuilder.setReviewData(true); // show a review screen before finishing
docKitBuilder.setManualCaptureMode(true); // enable manual capture
// UI Customization
docKitBuilder.setPrimaryColor(Color.parseColor("#FFA500")); // Convert hex to int color
// Set logo (choose one based on your use case)
docKitBuilder.setLogo(new VIDVLogo.ResourceLogo(R.drawable.logo));
// or
docKitBuilder.setLogo(new VIDVLogo.ByteArrayLogo(byteArray));
// or
docKitBuilder.setLogo(new VIDVLogo.Empty()); // Hide logo

Start SDK

Use the following code snippet to run the SDK

Kotlin

config.start(this, object : VIDVDocKitListener {
    override fun onDocKitResult(result: VIDVDocKitResponse) {
        when (result) {
            is VIDVDocKitResponse.Success -> {
                // Handle success
            }
            is VIDVDocKitResponse.ServiceFailure -> {
                // Handle failure
            }
            is VIDVDocKitResponse.BuilderError -> {
                // Handle builder error
            }
            is VIDVDocKitResponse.Exit -> {
                val step = result.step // screen where user exited
            }
        }
    }
})

Java

config.start(this, new VIDVDocKitListener() {
    @Override
    public void onDocKitResult(VIDVDocKitResponse result) {
        if (result instanceof VIDVDocKitResponse.Success) {
            // Handle success
        } else if (result instanceof VIDVDocKitResponse.ServiceFailure) {
            // Handle failure
        } else if (result instanceof VIDVDocKitResponse.BuilderError) {
            // Handle builder error
        } else if (result instanceof VIDVDocKitResponse.Exit) {
            VIDVDocKitResponse.Exit exitResult = (VIDVDocKitResponse.Exit) result;
            String step = exitResult.getStep(); // screen where user exited
        }
    }
});