Introducing Widget 3.0

A guide that introduces all of the juices that comes with Okra Widget 3.0

The Okra Widget 3.0 ushers faster means to allow customers to share their financial information with their favourite fintech products, with exciting features such as Selfie Verification, and a seamless returning user experience and many more.

Returning User Experience Flow

The returning user experience (RUX) simplifies onboarding for users who have already connected a financial account with Okra. If your application contains the user’s bvn, phone, email, or nin during widget 3.0 integration before the user connects to Okra Widget, there will have a seamless onboarding flow.

RUX Integration Flow Options

To unlock the returning user experience you can send any of the following items
in a customer to your widget. Only one is needed to be sent. This will also work if you are sending them in your options object.

    ...widget properties...,
    customer: {
        id: "okra customer id",
        bvn: "customer bvn", 
        phone: "customer phone", 
          email: "customer email", 
        nin: "customer nin"

RUX Benefits

  • During the RUX flow, the user sees only their previously connected banks, without having to search.
  • Once the user selects a bank, they have 3 options to verify their identity for quick login, they include;
    • Password - Enter the password and click "Connect Account"
    • Biometrics - Facial recognition or fingerprint, depending on the phone capabilities.
    • OTP - If they do not remember their password and don't have a biometric capable phone, we verify via OTP
  • If the user's phone doesn't have any biometric options, the biometric icon will not show in the UI and the "Connect Account" button would be full width showing the 2 other quick login options.

In summary, when the user gives consent through any application on the Okra network, the next time they interact with Okra to login to a new app they only have 3-clicks to connect their account.

Selfie Verification Flow

Another exciting feature of Okra Widget is selfie verification.
To minimize onboarding time for the user if your current process involves exiting the Okra widget to trigger a 3rd party verification service, you can leverage a selfie verification process to verify users' identities directly within the Okra widget, the selfie verification comes free with Okra's Identity product.

Selfie Verification Integration Options

To unlock the selfie verification flow, send the following additional items to your existing widget properties.

    ...widget properties...,
    selfieVerify: true,
  allowSelfieUpload: true // allow customer to upload an image to compare


Identity must be passed as a product, for selfie verification to work.

To integrate selfie verification via Okra API check this guide.

Check the following guides for Flutter, React Native-Expo, React Native, Android, IOS, and web for an update on the integration of Widget 3.0.

If you run into any issues, while integrating the widget, please seek help from our customer engineering team on Slack.

Did this page help you?