DigipassONE Verify is part of v10.0 and v10.1 - a limited, early access release for users who wish to evaluate supporting digital credentials in their applications.
It is not intended for production use.

This document is currently being updated. A new version with updated information will be published presently.

Implement digital credentials with the Android Tutorial App

Prev Next

Requirements

Component

Requirement

IDE

Android Studio

Android SDK

API 24 (Android 7, Nougat) to API 36 (Android 16, Baklava)

Gradle

9.3.1 (AGP 8.13.2)

Device

Phone running Android 15 or newer

Wallet

OneSpan Wallet

Web browsers

W3C Digital Credentials-compliant versions of:

  • Google Chrome

  • Microsoft Edge

  • Firefox

The Android Tutorial App is included with the DigipassONE App SDK for Android. It is a simple client application that will teach you how to implement /digital credentials by:

  • Building and deploying a client application.

  • Connecting and testing a client application.

Below are detailed, step-by-step guides to help you get started:

Install OneSpan Wallet

OneSpan Wallet requires other DigipassONE components to function and should only be used to explore and validate digital credential functionality. It is not intended for standalone use.

  1. Access the Google Play Store on an Android device.

  2. Search for OneSpan Wallet and install.

  3. When you open the app for the first time, you will be asked to provide a 4 to 8 digit PIN. Click Set PIN when you are done.
    OneSpan Wallet interface for creating and confirming a PIN for secure access.

  4. You should see a message indicating that your wallet is ready.
    OneSpan Wallet interface displaying options to receive and present credentials.

Download the Android SDK

  1. Login to the DigipassONE portal.

  2. Locate the Software Downloads tile and click on Android SDK.

  3. Download the zip file.

Build the Android tutorial app

  1. Launch Android Studio and Open the folder where you downloaded the Android App SDK.

  2. Navigate to nn_android_app-sdk_(version number) > AppSDK > android-studio > app_tutorial_plus_ > app.

  3. Run the Android tutorial app by installing it on your Android device.

Connect the Android tutorial app to your tenant

Get the configuration settings

  1. On your computer, open a browser and navigate to https://preview.digipassone.com/<tenant>/webapps/demo/gwtutorial/configure.

  2. Replace <tenant> in the above URL with your tenant name.1

  3. On the Web App Configuration page, ensure that the Configuration Version is set to automatic.

  4. Click Apply Configuration.
    Web app configuration settings including tenant, server host, and apply configuration button.

  5. Next, click Show QR Code. You should see the Configuration QR code dialog.
    Scan this QR code to apply the configuration using your application.

1 Your tenant name appears in the header of the cloud portal.

Apply the configuration to your tutorial app

  1. Open the Android tutorial app and login with any username. Click Next.

  2. When requested, enter "noknok" as the password.

    • If you are asked to set anything up, click Not Now.

  3. Expand the menu by clicking the icon on the top left of the screen. Choose Scan QR Code.
    Menu displaying options with 'Scan QR Code' highlighted for selection.

  4. Scan the Configuration QR code from the previous step.

  5. You should receive a notification saying that the configuration has been updated. This means that the tutorial app was able to connect to your tenant.

Test the Android tutorial app

Register a digital credential

  1. Open the Android tutorial app and enter your username in the field provided. Click Next.

  2. When you are prompted for a Password, enter "noknok" and click Next.

  3. You will be prompted to set up authentication. Select Digital Credential.

  4. You will see a dialog asking, Are you ready to invoke your Identity Wallet? Click Next to confirm.

  5. This will open OneSpan Wallet. You may be asked to enter the PIN you created in Install OneSpan Wallet.

  6. You should see a new credential in the Receive section. Click Receive.

    • If this is the first time you created a digital credential, there should be No credentials listed at the bottom of the screen.

  7. The Add credential screen will appear. Review the details before clicking Confirm.

  8. You should now see a notification saying that OneSpan Wallet Received 1 credential(s) with the new credential appearing at the bottom of the screen.

  9. Access the Tutorial app by using the back button. The new credential should now be available at the bottom of the Register screen.

Login with a digital credential

  1. First make sure that you have signed out of the Tutorial app.

  2. Now, login to the Tutorial app with your username and click Next.

  3. You will see an option to Sign in with Digital Credential, click on it.
    OneSpan sign-in screen with password field and passwordless options displayed.

  4. You will be asked to verify your credential. Click Next to confirm.

  5. This will open your OneSpan Wallet where you should see the credential you created previously. Click Present.

  6. You will be prompted to Share credentials? Review the information included before clicking Confirm.

  7. You should see the notification, Presentation sent if the credential was successfully shared.

  8. Access the Tutorial app by using the back button. You should be logged in with the same credential from OneSpan wallet and can see a welcome message.

Authenticate a transaction with a digital credential

  1. Once you have logged into the Tutorial app, open the menu and click on Transaction.
    Menu displaying transaction options with selected transaction highlighted for user navigation.

  2. On the Transaction screen, enter an amount in the field provided and click Next.
    User interface for completing a transaction with a numeric keypad and next button.

  3. Click Authorize to proceed with the transaction.

  4. Afterwards, verify the credential by clicking Next.

  5. This will open your OneSpan Wallet where you should see the credential you created previously. Click Present.

  6. Verify the transaction details and click Confirm on the Share credentials dialog.

    • If you have more that one credential, you will be asked to select one before clicking Confirm.

  7. You should see the notification, Presentation sent if the credential was successfully shared.

  8. Once the credential is verified, you should see a notification for Transaction Suceeded. Click OK.
    Transaction screen showing successful completion message and numeric keypad for input.

Remove a digital credential from the tutorial app

  1. Ensure that you are logged into the Tutorial app before opening the Register page.

  2. Find the credential you wish to remove and click on the trash can.

  3. You will be asked to confirm the credential’s removal. Click Yes.

  4. The Register page will no longer display the credential.
    Registration screen for app security options including biometric and PIN settings.

Removing a digital credential from the Tutorial app will not delete it from OneSpan Wallet.