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:
|
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.
Access the Google Play Store on an Android device.
Search for OneSpan Wallet and install.
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.

You should see a message indicating that your wallet is ready.

Download the Android SDK
Login to the DigipassONE portal.
Locate the Software Downloads tile and click on Android SDK.

Download the zip file.
Build the Android tutorial app
Launch Android Studio and Open the folder where you downloaded the Android App SDK.
Navigate to nn_android_app-sdk_(version number) > AppSDK > android-studio > app_tutorial_plus_ > app.
Run the Android tutorial app by installing it on your Android device.
Connect the Android tutorial app to your tenant
Get the configuration settings
On your computer, open a browser and navigate to
https://preview.digipassone.com/<tenant>/webapps/demo/gwtutorial/configure.Replace
<tenant>in the above URL with your tenant name.1On the Web App Configuration page, ensure that the Configuration Version is set to automatic.
Click Apply Configuration.
.png?sv=2026-02-06&spr=https&st=2026-11-18T19%3A08%3A01Z&se=2026-11-18T19%3A22%3A01Z&sr=b&sp=r&sig=UnzAAT2xy89lf5GMsQa4A38kDrmTuftxv4h3vcFjT2g%3D)
Next, click Show QR Code. You should see the Configuration QR code dialog.
.png?sv=2026-02-06&spr=https&st=2026-11-18T19%3A08%3A01Z&se=2026-11-18T19%3A22%3A01Z&sr=b&sp=r&sig=heRrsKJWMgxW0EgkHul5yBPzhtE6fnexKMXQ1CqIqjM%3D)
1 Your tenant name appears in the header of the cloud portal.
Apply the configuration to your tutorial app
Open the Android tutorial app and login with any username. Click Next.
When requested, enter "noknok" as the password.
If you are asked to set anything up, click Not Now.
Expand the menu by clicking the icon on the top left of the screen. Choose Scan QR Code.

Scan the Configuration QR code from the previous step.
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
Open the Android tutorial app and enter your username in the field provided. Click Next.
When you are prompted for a Password, enter "noknok" and click Next.
You will be prompted to set up authentication. Select Digital Credential.

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

This will open OneSpan Wallet. You may be asked to enter the PIN you created in Install OneSpan Wallet.
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.
.png?sv=2026-02-06&spr=https&st=2026-11-18T19%3A08%3A01Z&se=2026-11-18T19%3A22%3A01Z&sr=b&sp=r&sig=SYiOMsEiB10dQ0z5b%2FDuvLlf6rK7eI%2FrnGAQjzjNvq0%3D)
The Add credential screen will appear. Review the details before clicking Confirm.
.png?sv=2026-02-06&spr=https&st=2026-11-18T19%3A08%3A01Z&se=2026-11-18T19%3A22%3A01Z&sr=b&sp=r&sig=ue3zIdechZSwMM1%2BMSG7LzTXeS9Lw0a8puu0jyOYk7w%3D)
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.

Access the Tutorial app by using the back button. The new credential should now be available at the bottom of the Register screen.
.png?sv=2026-02-06&spr=https&st=2026-11-18T19%3A08%3A01Z&se=2026-11-18T19%3A22%3A01Z&sr=b&sp=r&sig=ZlK7x0lcCwupITpXBqUpzKRQKpHkEP14%2FlqgOb7sWVc%3D)
Login with a digital credential
First make sure that you have signed out of the Tutorial app.
Now, login to the Tutorial app with your username and click Next.
You will see an option to Sign in with Digital Credential, click on it.

You will be asked to verify your credential. Click Next to confirm.
.png?sv=2026-02-06&spr=https&st=2026-11-18T19%3A08%3A01Z&se=2026-11-18T19%3A22%3A01Z&sr=b&sp=r&sig=fMhPMOHoSrDzoLEvAW%2FO%2FLlSAZ0MpJANNmXRypLJ2mI%3D)
This will open your OneSpan Wallet where you should see the credential you created previously. Click Present.

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

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

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.
.png?sv=2026-02-06&spr=https&st=2026-11-18T19%3A08%3A01Z&se=2026-11-18T19%3A22%3A01Z&sr=b&sp=r&sig=Vl0jZUiX%2BKvpFxm23sIE6x0LU0TNY2P71pb7cS0Yv%2Fc%3D)
Authenticate a transaction with a digital credential
Once you have logged into the Tutorial app, open the menu and click on Transaction.

On the Transaction screen, enter an amount in the field provided and click Next.

Click Authorize to proceed with the transaction.
.png?sv=2026-02-06&spr=https&st=2026-11-18T19%3A08%3A01Z&se=2026-11-18T19%3A22%3A01Z&sr=b&sp=r&sig=1%2BGSE7%2BZxvD41Lh7vcF7kdnxHnr4wW7Fvly%2F%2FyZox%2F8%3D)
Afterwards, verify the credential by clicking Next.

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

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.

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

Once the credential is verified, you should see a notification for Transaction Suceeded. Click OK.

Remove a digital credential from the tutorial app
Ensure that you are logged into the Tutorial app before opening the Register page.
Find the credential you wish to remove and click on the trash can.
.png?sv=2026-02-06&spr=https&st=2026-11-18T19%3A08%3A01Z&se=2026-11-18T19%3A22%3A01Z&sr=b&sp=r&sig=eJbriRxzu6EHX7XjhKZmsE8%2BzQrtVYhbsKhzWrpPf%2BI%3D)
You will be asked to confirm the credential’s removal. Click Yes.
.png?sv=2026-02-06&spr=https&st=2026-11-18T19%3A08%3A01Z&se=2026-11-18T19%3A22%3A01Z&sr=b&sp=r&sig=i8hDqlc3gH1Vymk05JaIpkrsFzLw0OBs9Xd25NjVhmA%3D)
The Register page will no longer display the credential.

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