Setting Up

eSign SDK Setup Guide

10min

Introduction

Signzy fascilitates digital Signing via native mobile application by providing neat SDK discussed in this document. All types of signature method are supported such as Aadhaar eSigning using OTP, fingerprint or faceAuth, Smart eSigning and Clickwrap. .

The utilization of Aadhaar eSign with Face Authentication is exclusive to a native mobile application on a mobile device. This functionality is not supported on desktops/laptops through web-based workflows. Additionally, it will not operate on a mobile device when accessed via a web-based workflow.

As of now, Aadhaar eSign with Face Authentication is compatible exclusively with Android mobile devices. iOS, Windows, or any other operating systems on mobile devices do not currently support this feature.

If you require assistance in setting up the service or have any questions, please contact our helpdesk at [email protected] or reach out to your designated Customer Success Manager (CSM).

Setup Guide

Here is a step-by-step process to use contract360 eSigning SDK.

Step 1 - Utilize the "Initiate Contract API" to create the contract.

Step 2 - Upon generation of the contract through the API, the output will include the Signer ID.

Step 3 - Invoke Signzy's eSign SDK by utilizing this Signer ID.

Signzy's eSign SDK Integration Steps

Signzy's eSignSDK is a versatile and powerful software development kit designed specifically for Android applications. By seamlessly integrating eSignSDK, developers can enhance their apps with the ability to facilitate electronic contract signings, ensuring both security and convenience.

To integrate the Android archive(.aar) file in any android application following steps need to be followed:

Step 1

Copy the esignSDK-(env)-release.aar file to app/libs/

Document image


For testing in preproduction envrionment, use the esignSDK-preproduction-release.aar

For production envrionment, use the esignSDK-production-release.aar

Links for both the files are provided below. You can download them.

To utilize Aadhaar eSign with Face Authentication, you must install the FACE RD Mobile Application, provided by UIDAI, to capture facial data and perform face matching with UIDAI's records.

The FACE RD App for Preproduction can be downloaded from -

If you are having issues while downloading this file, please get in touch with your CSM and they will provide you with the application.

The FACE RD App for Production can be downloaded from Google PlayStore - https://play.google.com/store/apps/details?id=in.gov.uidai.facerd&hl=en_IN&gl=US&pli=1

Document image


To utilize Aadhaar eSign using Fingerprint, You must connect and configure the certified biometric device to your Mobile/Desktop device. For more information regarding the biometric devices and steps to configure, Go to Biometric Devices Setup Guide

Step 2

In settings.gradle add the following to support jitpack.io

Java


Step 3 - Import dependencies

In app level build.gradle add following dependencies

Java


Step 4 - Invoke SDK

To invoke the SDK, use the startActivityForResult function with the SignzyContract360Activity. The SDK requires string parameters as input, which are already defined as string constants in SignzyContract360Activity. Required Input Parameter: CONTRACT360_SIGNER_ID: This represents the signer ID, which you receive from the Initiate Contract API.

Java


Step 5: Watch For Result

Below are the constants available in SignzyContract360Activity: CONTRACT360_SIGNED_PDF_URL : URL of the signed PDF document generated after successful transaction. CONTRACT360_SUCCESS_MESSAGE : A message indicating the success of the transaction. CONTRACT360_REDIRECT_URL : A URL to redirect the user after the transaction is completed. CONTRACT360_ERROR_MESSAGE : Provides the error message in case of a failure. CONTRACT360_TRANSACTION_ID : A unique identifier or code representing the transaction. CONTRACT360_WARN_REASON : The reason for a warning issued during the transaction. CONTRACT360_WARN_MESSAGE : A message indicating a warning during the transaction.

Java