public void setUniqueToken(final String uniqueToken)
setUniqueToken method enables the user to pass to
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.
public void setNotificationHandler(final NotificationHandler handler)
Use this method to register a NotificationHandler.
public void submitDataForVerification(final List<IdCard> data, final Consumer<VerifyStatus> resultHandler, final Consumer<Throwable> errorHandler)
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
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.
public void checkVerificationStatus(@Nullable NotificationHandler handler)
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.
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.