Flashpay Decoupled Flow Android Integration

FlashPay solution primarily offers advanced biometric-based out-of-band (OOB) authentication. The Wibmo Tridentity SDK enables seamless integration of FlashPay functionality using various API methods and configuration options tailored to business needs.

Gradle Changes

Minimum Requirements

• Minimum SDK Version: v23
• Compile SDK Version: v33 or later

Maven Dependency

To include the Tridentity SDK, add the following line to your app/build.gradle file:

implementation 'in.payu:tridentity-sdk:x.x.x-SNAPSHOT'

Android Manifest Permissions

The SDK requires specific application-level permissions to enable its functionalities. As per business needs and enabled modes, these permissions must be declared in the AndroidManifest.xml file.

Supported Modes in SDK

• Biometric Based Authentication

Required Permissions

Include the following permissions in your AndroidManifest.xml file to enable the SDK functionalities:

<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.READ_PHONE_STATE" />
<uses-permission android:name="android.permission.SEND_SMS" />

SDK Configuration

This is a prerequisite step where you invoke the SDK's configuration method to initialize client-specific details. Validation of security checks and required permissions also occurs during this phase.

Configuration Parameters

The SDK must be configured with client-specific details before any other methods can be used. Create a configuration object with the required parameters and call the configSdk method to initialize the SDK properly. Check the message flag in the onSuccess callback for configuration status:

TridentitySDK.getInstance().configSdk(context, configObject, object : ConfigStatusCallback {
    override fun onSuccess(event: JSONObject) {
        // Check the message flag in the event for configuration status
    }
    override fun onError(errorCode: Int, errorDesc: String) {
        // Handle configuration error
    }
})

Once populated with these parameters, the configuration object is passed to the configSdk method to properly initialize the SDK, with callback handlers managing the configuration success or failure responses.

val configObject = JSONObject()  

configObject.put("env", "UAT") // UAT or PROD 

configObject.put("clientId", "")   

 configObject.put(“themeConfig”, “{themeConfig}”)

configObject.put(“bankId”,"8045")

configObject.put(“bindingType”, “02”)

configObject.put(“customerId”, "B81AEBFD8013D2F92B7DF38C00B20F168B18B3C27E78BAA721280189A5B86664")

configObject.put(“registrationTimeout”, 60)

📘

From the response object in the onSuccess method check for the message flag to get Configuration status.

Customer Enrollment

This method facilitates user enrollment for Tridentity-based authentication.

Enrollment Parameters

To enable biometric authentication for users, they must first be enrolled in the Tridentity system. Call the initiateRegistration method with the activity instance and registration object to begin the enrollment process. Check the message in the onSuccess response object for the registration status:

TridentitySDK.getInstance().initiateRegistration(activity, regObject, object : RegistrationStatusCallBack {
    override fun onSuccess(event: JSONObject) {
        // Check message in the event response object for the status
    }
    override fun onError(code: Int, error: String) {
        // Handle registration error
    }
})

The registration object is then passed to the initiateRegistration method to begin the enrollment process, with callback handlers to manage success and error responses during the biometric setup workflow.

val regObject = JSONObject()  

regObject.put("uid", "<>")  

📘

From the response object in the onSuccess method, check for the message flag to get the status

Check Registration Status

This method retrieves the customer's current registration status in the Tridentity system.

Registration Status Parameters

Use the checkRegistrationStatus method to verify if a customer is already registered in the Tridentity system:

TridentitySDK.getInstance().checkRegistrationStatus(context, custObject, object : RegistrationStatusCallBack {
    override fun onSuccess(event: JSONObject) {
      // Handle successful status check
      // Note: customerStatus : registration_comm_success is only considered as successful Registration.  

    }
    override fun onError(code: Int, error: String) {
        // Handle status check error
    }
})

The customer object is then passed to the checkRegistrationStatus method to perform the verification, with success callbacks specifically looking for a "registration_comm_success" status to confirm successful registration.

val custObject = JSONObject()  

custObject.put("clientId", "<>")     

Process Transaction

This method processes transactions and validates them using biometric OOB authentication.

Transaction Parameters

Transaction JSON Object Parameters

Create a JSON object with the transaction details and call the processTransaction method to initiate biometric authentication for the transaction:

TridentitySDK.getInstance().processTransaction(context, jsonObject, object : UpdateTransactionCallback {
    override fun onSuccess(event: JSONObject) {
        // Handle successful transaction
    }
    override fun onError(code: Int, error: String) {
        // Handle transaction error
    }
})

The populated transaction object is then passed to the processTransaction method to trigger the biometric authentication flow, allowing users to authorize transactions using their enrolled biometric credentials.

val custObject = JSONObject()  

custObject.put("clientId", "<>")  

custObject.put("txnId", "<>")  

custObject.put("hashKey", "<>")  

Deregistration

This method is used to deregister a customer from the Tridentity service.

Call the deRegistration method to remove a customer from the Tridentity authentication system:

TridentitySDK.getInstance().deRegistration(context, object : DeregisterCallBack {
    override fun onSuccess(event: JSONObject) {
        // Handle successful deregistration
    }
    override fun onError(code: Int, error: String) {
        // Handle deregistration error
    }
})

UI Customization

The SDK allows UI customizations through a configuration object passed in as themeConfig.

UI Customization Parameters

Text Customization Parameters