# DOME Digital Wallet User Guide

# Introduction to the DOME Digital Wallet

The DOME Digital Wallet is an essential tool for managing your digital identity within the DOME Marketplace. It enables secure interactions by allowing users to store, manage, and utilize digital credentials effectively. This wallet supports various functionalities including signing in, credential management, and QR code scanning for credential verification or issuance. Access the wallet by visiting [DOME Digital Wallet](https://wallet.dome-marketplace.eu).

For a detailed walkthrough on setting up your account and the initial steps to access the DOME Marketplace, please refer to the official [Onboarding Guide](https://github.com/DOME-Marketplace/onboarding/tree/official-csp-participants-onboarding). This guide will help you understand the prerequisites and steps to get started with DOME.

# Registering on the DOME Digital Wallet

In the Dev2 environment, the Wallet user registration is disabled. Use the [PRD Wallet](https://wallet.dome-marketplace.eu). See the [PRD Guide](https://knowledgebase.dome-marketplace.eu/books/dome-digital-wallet-user-guide/page/registering-on-the-dome-digital-wallet).

If for some specific reason you need to use the [Dev2 Wallet](https://wallet.dome-marketplace-dev2.org), you can open a ticket in the [ticketing support system](https://ticketing-int.dome-marketplace.eu/).

# Forgot Password Process

- **Access the Forgot Password Link**:
    
    
    - On the login page, click the 'Forgot password' link if you cannot remember your password.
        
        [![image.png](https://knowledgebase.dome-marketplace-dev2.org/uploads/images/gallery/2025-10/scaled-1680-/bqvimage.png)](https://knowledgebase.dome-marketplace-dev2.org/uploads/images/gallery/2025-10/bqvimage.png)
- **Submit Your Email Address**:
    
    
    - Enter your registered email address where prompted to receive a password reset link.
        
        [![image.png](https://knowledgebase.dome-marketplace-dev2.org/uploads/images/gallery/2025-10/scaled-1680-/hAlimage.png)](https://knowledgebase.dome-marketplace-dev2.org/uploads/images/gallery/2025-10/hAlimage.png)
- **Confirmation Message**:
    
    
    - After submitting your email, you will see a message confirming that an email has been sent to you with the reset link.
        
        [![image.png](https://knowledgebase.dome-marketplace-dev2.org/uploads/images/gallery/2025-10/scaled-1680-/3XLimage.png)](https://knowledgebase.dome-marketplace-dev2.org/uploads/images/gallery/2025-10/3XLimage.png)
- **Check Your Email**:
    
    
    - Open your email to find the password reset message. Click the link provided within the email to proceed with resetting your password.
        
        [![image.png](https://knowledgebase.dome-marketplace-dev2.org/uploads/images/gallery/2025-10/scaled-1680-/aZ0image.png)](https://knowledgebase.dome-marketplace-dev2.org/uploads/images/gallery/2025-10/aZ0image.png)
- **Reset Your Password**:
    
    
    - Follow the link from your email to a secure page where you can enter a new password.
        
        [![image.png](https://knowledgebase.dome-marketplace-dev2.org/uploads/images/gallery/2025-10/scaled-1680-/2yHimage.png)](https://knowledgebase.dome-marketplace-dev2.org/uploads/images/gallery/2025-10/2yHimage.png)
- **Confirmation of Password Reset**:
    
    
    - Once you have successfully reset your password, you will receive a confirmation on the screen indicating that your password has been changed.
        
        [![image.png](https://knowledgebase.dome-marketplace-dev2.org/uploads/images/gallery/2025-10/scaled-1680-/h8simage.png)](https://knowledgebase.dome-marketplace-dev2.org/uploads/images/gallery/2025-10/h8simage.png)

# Main Wallet Features

### QR Scan Functionality

- **General Use**:
    
    
    - The QR Scan function is used to scan QR codes provided by a third party, which can trigger processes for **obtaining** or **presenting** credentials (see below). To initiate a scan, press the 'Scan QR' button to deploy the camera.
        
        [![image.png](https://knowledgebase.dome-marketplace-dev2.org/uploads/images/gallery/2025-10/scaled-1680-/FIbimage.png)](https://knowledgebase.dome-marketplace-dev2.org/uploads/images/gallery/2025-10/FIbimage.png)
- **Scanning Process**:
    
    
    - After pressing the 'Scan QR' button, align the QR code within the camera to scan it. This will trigger the specific process linked to the QR code. If you scan a QR which is not recognized as belonging to the DOME environment, an error message will be shown.

### Credential Obtaining Process

- **PIN Verification**: 
    - If the credential obtaining process includes PIN verification (used for additional security), you will be prompted to enter a PIN code after scanning the QR code. The PIN will be sent to you through a communication channel specified by the issuer. Currently, the DOME issuer delivers this PIN code via email.
    - For more information about the process of obtaining a credential, check the chapter "Receiving and Accepting the Credential Offer" in this [guide](https://knowledgebase.dome-marketplace-dev2.org/books/company-onboarding-process-guide-for-cloud-service-providers-csp/page/6-generation-of-lear-verifiable-credentials).
    - [![image.png](https://knowledgebase.dome-marketplace-dev2.org/uploads/images/gallery/2025-10/scaled-1680-/cflimage.png)](https://knowledgebase.dome-marketplace-dev2.org/uploads/images/gallery/2025-10/cflimage.png)

### Credential Presentation Process

- **Automatic Credential Display for Specific Types**: 
    - When required to present a credential (i. e., when logging in to the [DOME Marketplace](https://dome-marketplace.eu/)), the wallet automatically displays all available credentials of the type required for the transaction or verification. Select the appropriate credential you wish to present and confirm the action. If the presentation is successful, a confirmation pop-up will appear, indicating a successful transaction or verification.
        
        [![image.png](https://knowledgebase.dome-marketplace-dev2.org/uploads/images/gallery/2025-10/scaled-1680-/gLiimage.png)](https://knowledgebase.dome-marketplace-dev2.org/uploads/images/gallery/2025-10/gLiimage.png)

### See your credentials

- In the "Credentials" tab you can see all the credentials that have been added to your wallet account.
- Each type of credential has a different icon and displays different information. For example, LEAR Credential Employees display the credential type, the name of the mandatee and the mandator Company name, while LEAR Credential Machine display the IP and the domain and the mandator Company name .
- Expired and revoked credentials have a red ellipse with the word "EXPIRED" and "REVOKED". These can't be used to login. To learn more about statuses, check the [Issuer guide](https://knowledgebase.dome-marketplace-dev2.org/books/dome-credential-issuer-user-guide/page/credentials-management).

[![image.png](https://knowledgebase.dome-marketplace-dev2.org/uploads/images/gallery/2025-10/scaled-1680-/rH4image.png)](https://knowledgebase.dome-marketplace-dev2.org/uploads/images/gallery/2025-10/rH4image.png)

### See Credential details

- By clicking on a credential card, you can view all the credential details. In LEAR Credential Machine and Label Credential credentials.

[![image.png](https://knowledgebase.dome-marketplace-dev2.org/uploads/images/gallery/2025-10/scaled-1680-/7d9image.png)](https://knowledgebase.dome-marketplace-dev2.org/uploads/images/gallery/2025-10/7d9image.png)

### Export credential

- Some type of credentials (LEAR Credential Machine, Label Credential), allow exporting the credential in JWT format. Access the credential details by clicking on the card and then scroll to the bottom. Here you will find the "Credential" section with the JWT. Click on the button to copy it to the clipboard.

[![image.png](https://knowledgebase.dome-marketplace-dev2.org/uploads/images/gallery/2025-10/scaled-1680-/LTeimage.png)](https://knowledgebase.dome-marketplace-dev2.org/uploads/images/gallery/2025-10/LTeimage.png)

### Credential Deletion

- **Deleting a Credential**: 
    - If you choose to delete a credential, access the credential details by clicking on the card and click on the "Delete" button that con find in the bottom right corner. Be aware that once a credential is deleted, it cannot be recovered, so you must obtain a new one through the [issuance process](https://knowledgebase.dome-marketplace-dev2.org/books/company-onboarding-process-guide-for-cloud-service-providers-csp/page/6-generation-of-lear-verifiable-credentials) if needed.

### Language Settings

- **Changing Language**: 
    - You can change the language of the wallet interface by going to the settings and selecting your preferred language. Currently, the wallet supports English, Spanish, and Catalan.
        
        [![image.png](https://knowledgebase.dome-marketplace-dev2.org/uploads/images/gallery/2025-10/scaled-1680-/5slimage.png)](https://knowledgebase.dome-marketplace-dev2.org/uploads/images/gallery/2025-10/5slimage.png)

# Troubleshooting Common Issues

### Camera Not Activating for QR Scan

If the camera does not activate when you attempt to use the **Scan QR** function, follow these troubleshooting steps to resolve the issue:

#### Navigate to Settings

- Within the DOME Wallet app, navigate to the **Settings** section.

[![image.png](https://knowledgebase.dome-marketplace-dev2.org/uploads/images/gallery/2025-10/scaled-1680-/Ru8image.png)](https://knowledgebase.dome-marketplace-dev2.org/uploads/images/gallery/2025-10/Ru8image.png)

#### Access Camera Settings

- Find and select the **Camera** option to configure your camera settings.

[![image.png](https://knowledgebase.dome-marketplace-dev2.org/uploads/images/gallery/2025-10/scaled-1680-/dNUimage.png)](https://knowledgebase.dome-marketplace-dev2.org/uploads/images/gallery/2025-10/dNUimage.png)

#### Select Your Camera

- Choose your preferred camera for QR scanning. If you have more than one camera, you may need to select which one to use.

#### Ensure Camera Permissions are Enabled

- Make sure the DOME Wallet app has the necessary permissions to access the camera in your device's settings. 
    - On Android: Go to Settings &gt; Apps &gt; Your Browser Permissions and ensure the Camera permission is enabled.
    - On iOS: Go to Settings &gt; Privacy &gt; Camera, find Your Browser and ensure the toggle is enabled.

#### Retry QR Scan

- Return to the home screen and try to scan the QR code again.

#### Reset Camera Permissions (Optional)[<svg aria-hidden="true" class="octicon octicon-link" height="16" version="1.1" viewbox="0 0 16 16" width="16"></svg>](https://github.com/DOME-Marketplace/wallet-guide/tree/initial-wallet-guide#reset-camera-permissions-optional)

- If the issue persists, you can try resetting your camera permissions: 
    - Go to your device's App Permissions settings.
    - Find the DOME Wallet app and remove the camera permissions.
    - Reopen the app and grant camera permissions again when prompted.

#### Restart Your Device[<svg aria-hidden="true" class="octicon octicon-link" height="16" version="1.1" viewbox="0 0 16 16" width="16"></svg>](https://github.com/DOME-Marketplace/wallet-guide/tree/initial-wallet-guide#restart-your-device)

- If the problem continues, try restarting your device. This can refresh system processes that may be preventing the camera from functioning correctly.

#### Update Your Browser[<svg aria-hidden="true" class="octicon octicon-link" height="16" version="1.1" viewbox="0 0 16 16" width="16"></svg>](https://github.com/DOME-Marketplace/wallet-guide/tree/initial-wallet-guide#update-your-browser)

- Ensure that you are using the latest version of your browser. Check your app store for any available updates, as newer versions may include fixes for known issues.

#### Check for System Updates[<svg aria-hidden="true" class="octicon octicon-link" height="16" version="1.1" viewbox="0 0 16 16" width="16"></svg>](https://github.com/DOME-Marketplace/wallet-guide/tree/initial-wallet-guide#check-for-system-updates)

- If your device's operating system is outdated, it may cause compatibility issues. Check for any available system updates in your phone's settings and install them if necessary.

#### Contact Support[<svg aria-hidden="true" class="octicon octicon-link" height="16" version="1.1" viewbox="0 0 16 16" width="16"></svg>](https://github.com/DOME-Marketplace/wallet-guide/tree/initial-wallet-guide#contact-support)

- If none of these steps resolve the issue, you may need to open a ticket for further assistance ([https://ticketing.dome-marketplace.eu](https://ticketing.dome-marketplace.eu)).

By following these steps, you should be able to resolve any issues with the camera not activating for QR code scanning.