Methods

setUniqueToken

public void setUniqueToken(final String uniqueToken)

The setUniqueToken method enables the user to pass to IdvService the uniqueToken received by the app in push notification. Your app will receive a new uniqueToken in the push notification for each transaction. The SDK persists the uniqueToken for all the calls for a single transaction.

setNotificationHandler

public void setNotificationHandler(final NotificationHandler handler)

Use this method to register a NotificationHandler.

submitDataForVerification

public void submitDataForVerification(final List<IdCard> data, final Consumer<VerifyStatus> resultHandler, final Consumer<Throwable> errorHandler)

The submitDataForVerification method accepts the user ID information from the app, performs client side validation of the data, and sends the data to the ID Verification service. The SDK retains the transaction ID and service endpoints in encrypted storage on the user device. The completion block (onComplete) notifies the app when the data is shared successfully, or when any errors occur during the process. The updated transaction status is returned in Result.

Internally, the SDK puts the ID information in a secure message to be sent to the ID Verification service. When creating the message, the SDK checks whether any existing claims can be found in secure storage for the given IDs. If the ID information is found, the claims are sent to the ID Verification service with the ID data. This prevents repeated validations for the same IDs.

checkVerificationStatus

public void checkVerificationStatus(@Nullable NotificationHandler handler)

The checkVerificationStatus method requests the verification status from the ID Verification service, and forwards the status, with any errors or claims, to the callback methods in NotificationHandler. You can register a NotificationHandler using IdvService.Builder or pass one as a function parameter to this method.

processNotification

public boolean processNotification(@NonNull final Map<String, String> notificationData, @Nullable NotificationHandler handler)

The processNotification method should be called whenever you receive a notification in your app. The method returns true if the notification can be handled by IdvService and it returns false if the service cannot recognize it as a PingOne notification. If the notification indicates that the verification process has completed, the service will call checkVerificationStatus internally, and pass the result to the NotificationHandler callback.