Integrating 1-Click Onboarding SDK

The 1-Click Onboarding SDK simplifies user verification workflows for Android, iOS, and web applications. You can include a script tag, initialise the SDK with a session ID, and manage verification processes easily. Success and error callbacks handle responses, and you can close the SDK programmatically if needed. This topic includes the following sections:

Integration
Initializing SDK
Callback structure

Integration

To integrate 1-Click Onboarding:

Log in to the Merchant Dashboard and create a 1-Click Onboarding template.
Follow the workflow below:
1. Verify user data using the Data Availability API to check user data availability using a mobile number. This step is mandatory.
2. Initiate OAuth by calling the Initiate OAuth API with the mobile number to obtain a session_id for opening the SDK.
3. Collect user consent by opening the SDK using the session_id. Once the user provides consent, a callback returns an auth_code.
4. Generate an access token using the auth_code with the OAuth Access Token Generation API to get a token valid for one hour.
5. Retrieve user details using the access token with the Fetch User Details API to access user details.

Refer to the image below for a sample workflow:

Initializing SDKs

The SDK communicates with Telr and provides updates via the callbacks. Initialize the applicable SDK from the options below:

Web
Android native
iOS native

Web

To initiate the web SDK, pass the sessionId and callback functions. Refer to the JavaScript example below:

const cf = CF1ClickOnboarding({
  sessionId: newId,
  successCb: successCallback,
  errorCb: errorCallback,
  mode: "production" // default: "sandbox"
});

const successCallback = (data) => {
  console.log("Success: ", data);
};

const errorCallback = (error) => {
  console.error("Error: ", error);
};

// Close the SDK programmatically
cf.closeSDK();

Importing hosted JS SDK

Include the appropriate SDK version in your HTML document:

Use the following for the production environment:

<script src="https://vssdk-prod.cashfree.com/vsvault/prod/1.0.0/index.js"></script>

Use the following for the sandbox environment:

<script src="https://vssdk-prod.cashfree.com/vsvault/gamma/1.0.0/index.js"></script>

Refer to the code snippet below for the HTML structure:

<html>
  <head>
    <title>1-Click Onboarding</title>
    <script src="https://vssdk-prod.cashfree.com/vsvault/prod/1.0.0/index.js"></script>
  </head>
  <body>
    <div id="cf-sdk"></div>
  </body>
</html>

Android native

To set up the Android native SDK:

Add the Maven repository to settings.gradle.kts:

repositories {
    google()
    mavenCentral()
    maven { url = URI("https://maven.cashfree.com/release") }
}

Add SDK dependency in build.gradle.kts:

dependencies {
    implementation("com.cashfree.vrs:kyc-verification:1.0.1")
}

Click Sync Now in Android Studio to sync the project.

To initialise and use the Android native SDK:

Create an instance of the verification service:

val verificationService = CFVerificationService.Builder()
    .setContext(this) // Pass the context
    .build()

Configure the callback to handle verification responses, errors, and user drop scenarios:

verificationService.set1ClickOnboardingCallback(object : CF1ClickOnboardingCallback {
    override fun onVerification(response: CF1ClickOnboardingResponse) {
        // Handle response
    }

    override fun onVerificationError(error: CF1ClickOnboardingErrorResponse) {
        // Handle error
    }

    override fun onUserDrop(error: CFUserDropResponse) {
        // Handle user drop
    }
})

Initiate the 1-Click Onboarding SDK:

verificationService.open1ClickOnboarding(sessionId, Environment.TEST)

It consists of the following parameters:

sessionId: Unique session identifier.
Environment: SDK environment. Possible values are:
- Environment.TEST
- Environment.PROD

iOS native

To set up the iOS native SDK:

Add the SDK to your project by updating your Podfile:
pod 'KycVerificationSdk', '~> 1.0.2'
Run pod install to install the SDK.

To initialise and use the iOS native SDK:

Create an instance of the CFVerificationService class:

let kycService = CFVerificationService.getInstance()

Set up callback handlers to manage events after verification processing. Implement the CF1ClickOnboardingResponseDelegate protocol to handle responses and errors:

extension ViewController: CFResponseDelegate {
    func onVerification(_ verificationResponse: KycVerificationSdk.CF1ClickOnboardingResponse) {
        showErrorAlert(title: "Verification Success", message: verificationResponse.verificationId ?? "N/A")
    }

    func onVerificationError(_ errorResponse: KycVerificationSdk.CF1ClickOnboardingErrorResponse) {
        showErrorAlert(title: "Verification Error", message: errorResponse.status ?? "N/A")
    }

    func onUserDrop(_ userDropResponse: KycVerificationSdk.CFUserDropResponse) {
        showErrorAlert(title: "User Dropped", message: userDropResponse.verificationId ?? "N/A")
    }
}

Initiate the 1-Click Onboarding SDK using the following code:

do {
    let environment = Environment.PROD
    try kycService.open1ClickOnboarding(sessionId, environment, self, self)
} catch let e {
    let error = e as! VerificationError
    print(error)
}

It consists of the following parameters:

sessionId: A unique identifier for the session.
environment: Specifies the environment in which the SDK operates. Possible values are:
- Environment.TEST
- Environment.PROD

Callback structure

Refer to the sample response below:

{
  "verification_id": "verification_id_value",
  "auth_code": "auth_code_value",
  "status": "SUCCESS"
}

Refer to the table below for the possible statuses:

Status	Description
SESSION_EXPIRED	The session ID is invalid.
SESSION_ID_MISSING	No session ID is provided during initialization.
DIV_MISSING	The `<div>` with ID `cf-sdk` is missing.
SUCCESS	The operation is completed successfully.
CLOSED	The SDK closes.

Notes:

Ensure the <div> with ID cf-sdk exists in your HTML.
The SDK applies default styling for consistent behaviour; custom styling is not supported.
The iframe uses sandboxing for secure interactions.

For detailed API documentation, refer to 1-Click Onboarding API Integration.

​Integration

​Initializing SDKs

​Web

​Importing hosted JS SDK

​Android native

​iOS native

​Callback structure