Methods

initWithNewConfig

public static Builder initWithNewConfigFor(final String verificationCode)

The initWithNewConfig method initializes IdvService.Builder using the 12-digit code generated by the ID Verification service to create an IdvService object.

initWithNewConfigFromQr

public static Builder initWithNewConfigFromQr(final String qrUrl)

The initWithNewConfigFromQr method initializes IdvService.Builder using the content scanned from the QR code generated by the ID Verification service to create an IdvService object.

initWithSavedConfig

public static Builder initWithSavedConfig()

The initWithSavedConfig method loads saved transaction information from secure storage on the user’s device and creates an IdvService object using the same configuration.

setApplicationId

public Builder setApplicationId(final String applicationId)

The setApplicationId method sets the PingOne application ID that will be shared with the ID Verification service to send a push notification to your app.

setNotificationHandler

public Builder setNotificationHandler(final NotificationHandler handler)

Use this method to register a NotificationHandler.

setPushNotificationToken

public Builder setPushNotificationToken(final String pushToken)

The setPushNotificationToken method sets the push notification token that will be shared with the ID Verfication service to send a push notification to your app.

create

public void create(final Fragment fragment, final Consumer<IdvService> resultHandler, final Consumer<Throwable> errorHandler)

The create method must be called on a background thread, because it also initializes the secure encrypted storage using the keys in the keychain. This method does the following:

• Creates a new Entity ID.

• Initializes encrypted shared preferences after authenticating using user’s biometrics/device passcode.

• Updates the app JWKs with the Id Verification service.

• Returns the initialized IdvService in the resultHandler.

• Returns an error when:

  • Builder fails to validate the 12-digit code entered by the app.
  • Builder fails to fetch the configuration details using the content in the QR code.
  • No QR metadata or code is passed to the Builder, and it can’t find any saved configuration.
  • Builder fails to initialize any of the dependent services manage secure key operations and storage.