--- title: "Implement digital credentials with the Android Tutorial App" slug: "dpo-verify-implement-digital-credentials-with-the-android-tutorial-app" tags: ["S3 v10.1", "S3 v10.0"] updated: 2026-11-14T22:46:18Z published: 2026-11-14T22:46:18Z canonical: "docs.onespan.com/dpo-verify-implement-digital-credentials-with-the-android-tutorial-app" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.onespan.com/llms.txt > Use this file to discover all available pages before exploring further. # Implement digital credentials with the Android Tutorial App ## 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](/dpoa/docs/dpo-verify-implement-digital-credentials-with-the-android-tutorial-app#install-onespan-wallet) - [Download the Android SDK](/dpoa/docs/dpo-verify-implement-digital-credentials-with-the-android-tutorial-app#download-the-android-sdk) - [Build the Android tutorial app](/dpoa/docs/dpo-verify-implement-digital-credentials-with-the-android-tutorial-app#build-the-android-tutorial-app) - [Connect the Android tutorial app to your tenant](/dpoa/docs/dpo-verify-implement-digital-credentials-with-the-android-tutorial-app#connect-the-android-tutorial-app-to-your-tenant) - [Get the configuration settings](/dpoa/docs/dpo-verify-implement-digital-credentials-with-the-android-tutorial-app#get-the-configuration-settings) - [Apply the configuration to your tutorial app](/dpoa/docs/dpo-verify-implement-digital-credentials-with-the-android-tutorial-app#apply-the-configuration-to-your-tutorial-app) - [Test the Android tutorial app](/dpoa/docs/dpo-verify-implement-digital-credentials-with-the-android-tutorial-app#test-the-android-tutorial-app) - [Register a digital credential](/dpoa/docs/dpo-verify-implement-digital-credentials-with-the-android-tutorial-app#register-a-digital-credential) - [Login with a digital credential](/dpoa/docs/dpo-verify-implement-digital-credentials-with-the-android-tutorial-app#login-with-a-digital-credential) - [Authenticate a transaction with a digital credential](/dpoa/docs/dpo-verify-implement-digital-credentials-with-the-android-tutorial-app#authenticate-a-transaction-with-a-digital-credential) - [Remove a digital credential from the tutorial app](/dpoa/docs/dpo-verify-implement-digital-credentials-with-the-android-tutorial-app#remove-a-digital-credential-from-the-tutorial-app) ## 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.](https://cdn.document360.io/038f59a7-abd0-4c14-9de7-3434d28b49fd/Images/Documentation/screenshot-onespan-wallet-set-pin-light.png?sv=2026-02-06&spr=https&st=2026-11-18T19%3A15%3A56Z&se=2026-11-18T20%3A15%3A56Z&sr=b&sp=r&sig=2GzeMO8OlJEBT0rO%2F0e0JYEV19kx0f2O%2FT4%2FI7QRmJ4%3D) 4. You should see a message indicating that your wallet is ready. ![OneSpan Wallet interface displaying options to receive and present credentials.](https://cdn.document360.io/038f59a7-abd0-4c14-9de7-3434d28b49fd/Images/Documentation/screenshot-onespan-wallet-ready-light.png?sv=2026-02-06&spr=https&st=2026-11-18T19%3A15%3A56Z&se=2026-11-18T20%3A15%3A56Z&sr=b&sp=r&sig=QFqcMoDubyi8lLUy8z3vuQm6kdvzHhpCia2Me0sZJUs%3D) ## Download the Android SDK 1. Login to the [DigipassONE portal](https://preview.digipassone.com/noknok/webapps/nnllauncher/loginPage.jsp). 2. Locate the **Software Downloads** tile and click on **Android SDK**. ![](https://cdn.document360.io/038f59a7-abd0-4c14-9de7-3434d28b49fd/Images/Documentation/screenshot-dpoverify-software-downloads.png?sv=2026-02-06&spr=https&st=2026-11-18T19%3A15%3A56Z&se=2026-11-18T20%3A15%3A56Z&sr=b&sp=r&sig=uvxGGpaM6Jourm5w%2BojBkFt89wXAZKg6yY1AQCo7c3g%3D) 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.](https://cdn.document360.io/038f59a7-abd0-4c14-9de7-3434d28b49fd/Images/Documentation/screenshot-S3-auth-cloud-android-web-app-config(1).png?sv=2026-02-06&spr=https&st=2026-11-18T19%3A15%3A56Z&se=2026-11-18T20%3A15%3A56Z&sr=b&sp=r&sig=6q0wwwhNz%2FZKLo5pu%2F53j1LPrO7ZN%2FqlJjd9vWhXl5s%3D) 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.](https://cdn.document360.io/038f59a7-abd0-4c14-9de7-3434d28b49fd/Images/Documentation/screenshot-S3-auth-cloud-web-app-config-qr-code(3).png?sv=2026-02-06&spr=https&st=2026-11-18T19%3A15%3A56Z&se=2026-11-18T20%3A15%3A56Z&sr=b&sp=r&sig=w7GFLu6y0pDIdIbuW%2BX2R74s%2BWsjb5FBRCwsdNHQ32s%3D) > 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.](https://cdn.document360.io/038f59a7-abd0-4c14-9de7-3434d28b49fd/Images/Documentation/screenshot-dc-android-app-scan-qrcode.png?sv=2026-02-06&spr=https&st=2026-11-18T19%3A15%3A56Z&se=2026-11-18T20%3A15%3A56Z&sr=b&sp=r&sig=Qs9rgpo9dkSg36D06eSvhOtbqccfzw%2BJJq%2FqHiCyKgw%3D) 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**. ![](https://cdn.document360.io/038f59a7-abd0-4c14-9de7-3434d28b49fd/Images/Documentation/screenshot-dc-android-setup-passkey_updated.png?sv=2026-02-06&spr=https&st=2026-11-18T19%3A15%3A56Z&se=2026-11-18T20%3A15%3A56Z&sr=b&sp=r&sig=W3UPZZygBHT3gd15Rfc3AVt8A6P%2FcEC0MJlpmAzph0M%3D) 4. You will see a dialog asking, *Are you ready to invoke your Identity Wallet?* Click **Next** to confirm. ![](https://cdn.document360.io/038f59a7-abd0-4c14-9de7-3434d28b49fd/Images/Documentation/screenshot-dc-android-issue-cred 1.png?sv=2026-02-06&spr=https&st=2026-11-18T19%3A15%3A56Z&se=2026-11-18T20%3A15%3A56Z&sr=b&sp=r&sig=zexQ%2FGnJOpMghQ9ZzodwjuT5zube%2BECGeB%2BTqalzbiA%3D) 5. This will open **OneSpan Wallet**. You may be asked to enter the PIN you created in [Install OneSpan Wallet](/dpoa/docs/dpo-verify-implement-digital-credentials-with-the-android-tutorial-app#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. ![](https://cdn.document360.io/038f59a7-abd0-4c14-9de7-3434d28b49fd/Images/Documentation/screenshot-dc-android-oswallet-receive-cred-1st(2).png?sv=2026-02-06&spr=https&st=2026-11-18T19%3A15%3A56Z&se=2026-11-18T20%3A15%3A56Z&sr=b&sp=r&sig=GTEMUjgXx%2BPCvUOGen10eHf21waWc3l7BVhRvY6CK6I%3D) 7. The *Add credential screen* will appear. Review the details before clicking **Confirm**. ![](https://cdn.document360.io/038f59a7-abd0-4c14-9de7-3434d28b49fd/Images/Documentation/screenshot-dc-android-oswallet-ad-cred-1st(2).png?sv=2026-02-06&spr=https&st=2026-11-18T19%3A15%3A56Z&se=2026-11-18T20%3A15%3A56Z&sr=b&sp=r&sig=EyiNoXaLYHo%2FxZn4qjfiUnlPhtAETn1DEr8ZepTlvuU%3D) 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. ![](https://cdn.document360.io/038f59a7-abd0-4c14-9de7-3434d28b49fd/Images/Documentation/screenshot-dc-android-app-new-cred-wallet_blurred.png?sv=2026-02-06&spr=https&st=2026-11-18T19%3A15%3A56Z&se=2026-11-18T20%3A15%3A56Z&sr=b&sp=r&sig=FVUA7YbQcAPBclQzqOqIEswR%2FOLwQMlpnEqp2S56a3U%3D) 9. Access the Tutorial app by using the back button. The new credential should now be available at the bottom of the *Register screen*. ![](https://cdn.document360.io/038f59a7-abd0-4c14-9de7-3434d28b49fd/Images/Documentation/screenshot-dc-android-app-new-cred(3).png?sv=2026-02-06&spr=https&st=2026-11-18T19%3A15%3A56Z&se=2026-11-18T20%3A15%3A56Z&sr=b&sp=r&sig=LTSznSOwWeFD8JVopup27nM0STEE8vvIppind9seN7g%3D) ### 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.](https://cdn.document360.io/038f59a7-abd0-4c14-9de7-3434d28b49fd/Images/Documentation/screenshot-dc-android-signin-digital-cred.png?sv=2026-02-06&spr=https&st=2026-11-18T19%3A15%3A56Z&se=2026-11-18T20%3A15%3A56Z&sr=b&sp=r&sig=ac%2FFWEk1eCS8bRH4KHFeFW5K5V6LclPE2hUAVcGNbzA%3D) 4. You will be asked to verify your credential. Click **Next** to confirm. ![](https://cdn.document360.io/038f59a7-abd0-4c14-9de7-3434d28b49fd/Images/Documentation/screenshot-dc-android-issue-cred 1(1).png?sv=2026-02-06&spr=https&st=2026-11-18T19%3A15%3A56Z&se=2026-11-18T20%3A15%3A56Z&sr=b&sp=r&sig=vrg3qBIUtF39Re65wzPmHgA4UCuQxeccXKglcB3c3XQ%3D) 5. This will open your OneSpan Wallet where you should see the credential you created previously. Click **Present**. ![](https://cdn.document360.io/038f59a7-abd0-4c14-9de7-3434d28b49fd/Images/Documentation/screenshot-dc-android-oswallet-present-cred_blurred.jpg?sv=2026-02-06&spr=https&st=2026-11-18T19%3A15%3A56Z&se=2026-11-18T20%3A15%3A56Z&sr=b&sp=r&sig=Y7m%2BtgVIXm7J7HCicPSyB2ZiTvbWPsFIOjByenswjIU%3D) 6. You will be prompted to *Share credentials?* Review the information included before clicking **Confirm**. ![](https://cdn.document360.io/038f59a7-abd0-4c14-9de7-3434d28b49fd/Images/Documentation/screenshot-dc-android-signin-share-cred_blurred.jpg?sv=2026-02-06&spr=https&st=2026-11-18T19%3A15%3A56Z&se=2026-11-18T20%3A15%3A56Z&sr=b&sp=r&sig=dcGCl8WtFhbc8uhULaEbRvDcWWyuPJUwBdo7MjFHGHI%3D) 7. You should see the notification, *Presentation sent* if the credential was successfully shared. ![](https://cdn.document360.io/038f59a7-abd0-4c14-9de7-3434d28b49fd/Images/Documentation/screenshot-dc-android-oswallet-present-sent_blurred.png?sv=2026-02-06&spr=https&st=2026-11-18T19%3A15%3A56Z&se=2026-11-18T20%3A15%3A56Z&sr=b&sp=r&sig=TmSkQy%2FpW9wIlteslHgPODlLn0rHoEeRdQbIPFI%2F8Ds%3D) 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. ![](https://cdn.document360.io/038f59a7-abd0-4c14-9de7-3434d28b49fd/Images/Documentation/screenshot-dc-android-app-welcome(3).png?sv=2026-02-06&spr=https&st=2026-11-18T19%3A15%3A56Z&se=2026-11-18T20%3A15%3A56Z&sr=b&sp=r&sig=weEtn2%2FfkL2xg6x9PEqmjMK44V1d6pMiL0Ajo5Zmp4g%3D) ### 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.](https://cdn.document360.io/038f59a7-abd0-4c14-9de7-3434d28b49fd/Images/Documentation/screenshot-dc-android-transaction.png?sv=2026-02-06&spr=https&st=2026-11-18T19%3A15%3A56Z&se=2026-11-18T20%3A15%3A56Z&sr=b&sp=r&sig=M2uST0mbyhiTfuJ8KZTsKhed9%2BWl3jzC8rDE9R7r8hk%3D) 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.](https://cdn.document360.io/038f59a7-abd0-4c14-9de7-3434d28b49fd/Images/Documentation/screenshot-dc-android-transaction-amount.png?sv=2026-02-06&spr=https&st=2026-11-18T19%3A15%3A56Z&se=2026-11-18T20%3A15%3A56Z&sr=b&sp=r&sig=OuN0Pj8l1la%2Bi8D%2FVk8woI507gRnT7obNzkK7wu0sjo%3D) 3. Click **Authorize** to proceed with the transaction. ![](https://cdn.document360.io/038f59a7-abd0-4c14-9de7-3434d28b49fd/Images/Documentation/screenshot-dc-android-transaction-authorize(1).png?sv=2026-02-06&spr=https&st=2026-11-18T19%3A15%3A56Z&se=2026-11-18T20%3A15%3A56Z&sr=b&sp=r&sig=fOblI%2Bw7BRFIKfIH7dTl6EOGwSyRct%2F%2BWTqNdR37wgA%3D) 4. Afterwards, verify the credential by clicking **Next**. ![](https://cdn.document360.io/038f59a7-abd0-4c14-9de7-3434d28b49fd/Images/Documentation/screenshot-dc-android-invoke-wallet.png?sv=2026-02-06&spr=https&st=2026-11-18T19%3A15%3A56Z&se=2026-11-18T20%3A15%3A56Z&sr=b&sp=r&sig=ROv6fNzOZ%2Bt7w8wbu0%2Fof9Yu6wiwfwwLTtuN1hNBrM8%3D) 5. This will open your OneSpan Wallet where you should see the credential you created previously. Click **Present**. ![](https://cdn.document360.io/038f59a7-abd0-4c14-9de7-3434d28b49fd/Images/Documentation/screenshot-dc-android-oswallet-present-cred_blurred.jpg?sv=2026-02-06&spr=https&st=2026-11-18T19%3A15%3A56Z&se=2026-11-18T20%3A15%3A56Z&sr=b&sp=r&sig=Y7m%2BtgVIXm7J7HCicPSyB2ZiTvbWPsFIOjByenswjIU%3D) 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**. ![](https://cdn.document360.io/038f59a7-abd0-4c14-9de7-3434d28b49fd/Images/Documentation/screenshot-tutorial-app-android-confirm-transactionl_blurred.png?sv=2026-02-06&spr=https&st=2026-11-18T19%3A15%3A56Z&se=2026-11-18T20%3A15%3A56Z&sr=b&sp=r&sig=0IAr22ka5xB2iUZvsYD3Qyu3ibUHL%2F0%2F%2BtjzzdwDExE%3D) 7. You should see the notification, *Presentation sent* if the credential was successfully shared. ![](https://cdn.document360.io/038f59a7-abd0-4c14-9de7-3434d28b49fd/Images/Documentation/screenshot-dc-android-oswallet-present-sent_blurred.png?sv=2026-02-06&spr=https&st=2026-11-18T19%3A15%3A56Z&se=2026-11-18T20%3A15%3A56Z&sr=b&sp=r&sig=TmSkQy%2FpW9wIlteslHgPODlLn0rHoEeRdQbIPFI%2F8Ds%3D) 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.](https://cdn.document360.io/038f59a7-abd0-4c14-9de7-3434d28b49fd/Images/Documentation/screenshot-dc-android-transaction-success.png?sv=2026-02-06&spr=https&st=2026-11-18T19%3A15%3A56Z&se=2026-11-18T20%3A15%3A56Z&sr=b&sp=r&sig=%2BPbpQy13gFkEUUN7TVFocTQo0iuvI%2BNQ5Bl%2BeVgD2aw%3D) ### 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**. ![](https://cdn.document360.io/038f59a7-abd0-4c14-9de7-3434d28b49fd/Images/Documentation/screenshot-dc-android-app-welcome(2).png?sv=2026-02-06&spr=https&st=2026-11-18T19%3A15%3A56Z&se=2026-11-18T20%3A15%3A56Z&sr=b&sp=r&sig=R0kGCI5E8PZfM8LmZpJ8zhYfaDtNykRXm4zWfF9OsMQ%3D) 3. You will be asked to confirm the credential’s removal. Click **Yes**. ![](https://cdn.document360.io/038f59a7-abd0-4c14-9de7-3434d28b49fd/Images/Documentation/screenshot-dc-android-delete-cred-sure(3).png?sv=2026-02-06&spr=https&st=2026-11-18T19%3A15%3A56Z&se=2026-11-18T20%3A15%3A56Z&sr=b&sp=r&sig=B6wqiaWuGx%2BN3eo8pYyg%2BoRLQh2vP5MsVjlyJ%2BVvVkk%3D) 4. The Register page will no longer display the credential. ![Registration screen for app security options including biometric and PIN settings.](https://cdn.document360.io/038f59a7-abd0-4c14-9de7-3434d28b49fd/Images/Documentation/screenshot-dc-android-delete-cred-done.png?sv=2026-02-06&spr=https&st=2026-11-18T19%3A15%3A56Z&se=2026-11-18T20%3A15%3A56Z&sr=b&sp=r&sig=yU%2BjEnpHbMjHkF1nSl6V8IWWzcyI7fw6N7Yq5kWCKOM%3D) > Removing a digital credential from the Tutorial app will not delete it from OneSpan Wallet. Formerly known as Digipass S3 App SDK. Includes SDKs for Android, iOS and web. Formerly known as Digipass S3. Identification, qualifications, or entitlements that are issued by a trusted authority and held by an individual in a digital wallet.