# Use Case 5.1 Share data with a Relying Party

## Overview

| Aspect                       | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
|------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| **Summary**                  | The user shares personal data with a Relying Party by initiating the process on the Relying Party site, confirming their identity in the NL Wallet app,<br>reviewing organization and data details, and then confirming the disclosure with PIN.                                                                                                                                                                                                                              |
| **Goal**                     | Share data with a Relying Party.                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| **Preconditions**            | <ul><li>The App holds the requested data.</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                           |
| **Postconditions**           | <ul><li>Data is shared with Relying Party.</li><li>The disclosure event is added in the history.</li></ul>                                                                                                                                                                                                                                                                                                                                                                    |
| **Triggered by**             | <ul><li>User invokes a universal link that contains the URL to a Relying Party.</li><li>User scans QR with in-app scanner [UC9.9 Scan QR](UC9.9_ScanQR.md)</li></ul>                                                                                                                                                                                                                                                                                                          |
| **Additional Documentation** | <ul><li>[Disclosure with openidp4vp](../../architecture/use-cases/disclosure-with-openid4vp.md)</li></ul>                                                                                                                                                                                                                                                                                                                                                                     |
| **Possible errors**          | <ul><li>[No Internet](../errors.md#no-internet)</li><li>[Server Unreachable](../errors.md#server-unreachable)</li><li>[Session Expired](../errors.md#session-expired)</li><li>[Known Verifier Error](../errors.md#known-verifier-error)</li><li>[Unknown Verifier Error](../errors.md#unknown-verifier-error)</li></ul>                                                                                                                                                       |
| **Logical test cases**       | <ul><li>[LTC15 Share data](../logical-test-cases.md#ltc15)</li><li>[LTC16 Cross-device share data](../logical-test-cases.md#ltc16)</li><li>[LTC17 Decline consent to share data](../logical-test-cases.md#ltc17)</li><li>[LTC10 Wallet does not contain requested attributes](../logical-test-cases.md#ltc10)</li><li>[LTC26 Disclosure fails](../logical-test-cases.md#ltc26)</li><li>[LTC65 Select another card to be disclosed ](../logical-test-cases.md#ltc65)</li></ul> |

---

## Flow

| #        | Description                                                                                                                                                                                                                    | Next                                                                      |
|----------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------|
| **1**    | **PRIMARY SCENARIO**                                                                                                                                                                                                           |                                                                           |
| **1.1**  | **System retrieves data request from verifier and displays loading indicator**<ul><li>Message: Data is being retrieved</li><li>Actions: Stop</li><li>Duration: 0.0 - 1.0 seconds</li></ul>                                     |                                                                           |
| 1.1a     | Case: Requested data is available in wallet (cross-device flow)                                                                                                                                                                | 1.2                                                                       |
| 1.1b     | Case: Requested data is available in wallet (same-device flow)                                                                                                                                                                 | 1.3                                                                       |
| 1.1c     | Case: Wallet does not contain requested attribute                                                                                                                                                                              | 9                                                                         |
| 1.1d     | User selects Stop                                                                                                                                                                                                              | 2                                                                         |
| 1.1e     | Error: Session expired                                                                                                                                                                                                         | Error flow: [Session Expired](../errors.md#session-expired)               |
| 1.1f     | Error: No internet                                                                                                                                                                                                             | Error flow: [No Internet](../errors.md#no-internet)                       |
| 1.1g     | Error: Server unreachable                                                                                                                                                                                                      | Error flow: [Server Unreachable](../errors.md#server-unreachable)         |
| 1.1h     | Error: Unknown verifier error                                                                                                                                                                                                  | Error flow: [Unknown Verifier Error](../errors.md#unknown-verifier-error) |
| 1.1i     | Error: Known verifier error                                                                                                                                                                                                    | Error flow: [Known Verifier Error](../errors.md#known-verifier-error)     |
| **1.2**  | **System displays screen 'Website check' (cross-device only)**<ul><li>Message: Is the website starting with: [organization url]?</li><li>Actions: Yes continue, Stop, About the website check, Help</li></ul>                  |                                                                           |
| 1.2a     | User selects Yes continue                                                                                                                                                                                                      | 1.3                                                                       |
| 1.2b     | User selects Stop                                                                                                                                                                                                              | 2                                                                         |
| 1.2c     | User selects About the website check                                                                                                                                                                                           | 3                                                                         |
| 1.2d     | User selects Help                                                                                                                                                                                                              | Show placeholder 'under construction'                                     |
| **1.3**  | **System determines whether user has multiple cards to fulfill disclosure**                                                                                                                                                    |                                                                           |
| 1.3a     | Case: User has one card                                                                                                                                                                                                        | 1.4                                                                       |
| 1.3b     | Case: User has multiple cards                                                                                                                                                                                                  | 10                                                                        |
| **1.4**  | **System displays screen 'Approve organization'**<ul><li>Do you want to share details with [Organization]?</li><li>Actions: Share, About [organization], View data, Read the agreement, Help, Close, Stop</li></ul>            |                                                                           |
| 1.4a     | User selects Share                                                                                                                                                                                                             | 1.5                                                                       |
| 1.4b     | User selects About [organization]                                                                                                                                                                                              | 7                                                                         |
| 1.4c     | User selects View data                                                                                                                                                                                                         | 4                                                                         |
| 1.4d     | User selects Help                                                                                                                                                                                                              | Show placeholder 'under construction'                                     |
| 1.4e     | User selects Close                                                                                                                                                                                                             | 2                                                                         |
| 1.4f     | User selects Stop                                                                                                                                                                                                              | 2                                                                         |
| 1.4g     | User selects Read the agreement                                                                                                                                                                                                | 6                                                                         |
| **1.5**  | **System executes partial flow [PF2.4 Confirm a protected action](../partial-flows/PF2.4_ConfirmProtectedAction.md)**<ul><li>Cancelable</li></ul>                                                                              |                                                                           |
| 1.5a     | Result: Confirm                                                                                                                                                                                                                | 1.6                                                                       |
| 1.5b     | Result: Cancel                                                                                                                                                                                                                 | 2                                                                         |
| 1.5c     | Result: Back                                                                                                                                                                                                                   | Back                                                                      |
| **1.6**  | **System displays screen 'Disclosure success'**<ul><li>Message: Success!</li><li>Actions: To my overview (cross-device flow), Go to website (same-device flow), See activity, Help, Close</li></ul>                            |                                                                           |
| 1.6a     | User selects To my overview (in cross-device flow only)                                                                                                                                                                        | Go to: [UC7.1 Show all available cards](UC7.1_ShowAllAvailableCards.md)   |
| 1.6b     | User selects Go to website <br>&rarr; System opens browser and suspends app (in same-device flow only)                                                                                                                         |                                                                           |
| 1.6c     | User selects See activity                                                                                                                                                                                                      | Go to: [UC6.3 Show event](UC6.3_ShowHistoryEvent.md)                      |
| 1.6d     | User selects Help                                                                                                                                                                                                              | Show placeholder 'under construction'                                     |
| 1.6e     | User selects Close <br>&rarr; System opens browser and suspends app                                                                                                                                                            | Go to: [UC7.1 Show all available cards](UC7.1_ShowAllAvailableCards.md)   |
| 1.6f     | Error: No internet                                                                                                                                                                                                             | Error flow: [No Internet](../errors.md#no-internet)                       |
| 1.6g     | Error: Server unreachable                                                                                                                                                                                                      | Error flow: [Server Unreachable](../errors.md#server-unreachable)         |
| **2**    | **STOP**                                                                                                                                                                                                                       |                                                                           |
| **2.1**  | **System displays screen 'Stop'**<ul><li>Message: Are you sure you want to stop?</li><li>Actions: Yes Stop, No, Report Problem</li></ul>                                                                                       |                                                                           |
| 2.1a     | User selects Yes stop                                                                                                                                                                                                          |                                                                           |
| 2.1b     | User selects No                                                                                                                                                                                                                | Back                                                                      |
| 2.1c     | User selects Report a problem                                                                                                                                                                                                  | 6                                                                         |
| **3**    | **GET WEBSITE CHECK DETAILS**                                                                                                                                                                                                  |                                                                           |
| **3.1**  | **System displays screen 'Under construction'**<ul><li>Actions: Back</li></ul>                                                                                                                                                 |                                                                           |
| 3.1a     | User selects Back                                                                                                                                                                                                              | Back                                                                      |
| **4**    | **GET SHARING DETAILS**                                                                                                                                                                                                        |                                                                           |
| **4.1**  | **System displays screen 'Approve Organization'**<ul><li>Message: Information about logging in at [organization]?</li><li>Actions: [organization], View data, Read the agreement, Help, Back</li></ul>                         |                                                                           |
| 4.1a     | User selects [organization]                                                                                                                                                                                                    | 7                                                                         |
| 4.1b     | User selects View data                                                                                                                                                                                                         | 4.2                                                                       |
| 4.1c     | User selects Read the agreement                                                                                                                                                                                                | 6                                                                         |
| 4.1d     | User selects Help                                                                                                                                                                                                              | Go to: [UC9.6 Get help](UC9.6_GetHelp.md)                                 |
| 4.1e     | User selects Back                                                                                                                                                                                                              | Back                                                                      |
| **4.2**  | **System displays screen 'Requested data'**<ul><li># from [Card Title]</li><li>Actions: Details Incorrect, Help, Back</li></ul>                                                                                                |                                                                           |
| 4.2a     | User selects Details Incorrect                                                                                                                                                                                                 | 5                                                                         |
| 4.2b     | User selects Help                                                                                                                                                                                                              | Go to: [UC9.6 Get help](UC9.6_GetHelp.md)                                 |
| 4.2c     | User selects Back                                                                                                                                                                                                              | Back                                                                      |
| **5**    | **WHEN DETAILS ARE INCORRECT**                                                                                                                                                                                                 |                                                                           |
| **5.1**  | **System displays screen 'Details incorrect'**<ul><li>Message: Details Incorrect</li><li>Actions: Back</li></ul>                                                                                                               |                                                                           |
| 5.1a     | User selects Back                                                                                                                                                                                                              | Back                                                                      |
| **6**    | **GET SHARING AGREEMENT DETAILS**                                                                                                                                                                                              |                                                                           |
| **6.2**  | **System displays screen 'Agreements'**<ul><li>Message: agreements</li><li>Actions: Privacy policy, Back</li></ul>                                                                                                             |                                                                           |
| 6.2a     | User selects Privacy policy <br>&rarr; System opens browser and suspends app                                                                                                                                                   |                                                                           |
| 6.2b     | User selects Back                                                                                                                                                                                                              | Back                                                                      |
| **7**    | **GET VERIFIER ORGANIZATION DETAILS**                                                                                                                                                                                          |                                                                           |
| **7.1**  | **System displays screen 'About organization'**<ul><li>Message: About [Organization]</li><li>Actions: Help, Back</li></ul>                                                                                                     |                                                                           |
| 7.1a     | User selects Help                                                                                                                                                                                                              | Show placeholder 'under construction'                                     |
| 7.1b     | User selects Back                                                                                                                                                                                                              | Back                                                                      |
| **8**    | **REPORT PROBLEM**                                                                                                                                                                                                             |                                                                           |
| **8.1**  | **System displays screen 'Report problem'**<ul><li>Message: Report Problem</li><li>Options: problems</li><li>Actions: Back</li></ul>                                                                                           |                                                                           |
| 8.1a     | User selects Back                                                                                                                                                                                                              | Back                                                                      |
| 8.1b     | User selects Problem option                                                                                                                                                                                                    | 8.2                                                                       |
| **8.2**  | **System displays screen 'Under construction'**<ul><li>Actions: Back</li></ul>                                                                                                                                                 |                                                                           |
| 8.2a     | User selects Back                                                                                                                                                                                                              | 8.1                                                                       |
| **9**    | **WHEN WALLET DOES NOT CONTAIN REQUESTED ATTRIBUTES**                                                                                                                                                                          |                                                                           |
| **9.1**  | **System displays screen 'Missing data'**<ul><li>Message: See at verifier what is missing, add and try again</li><li>Actions: Close, See details, Help</li></ul>                                                               |                                                                           |
| 9.1a     | User selects Close                                                                                                                                                                                                             | 2                                                                         |
| 9.1b     | User selects See details                                                                                                                                                                                                       | 9.2                                                                       |
| 9.1c     | User selects Help                                                                                                                                                                                                              | Show placeholder 'under construction'                                     |
| **9.2**  | **System displays bottom sheet 'Error details' with list of all requested attributes**<ul><li>Actions: Close</li></ul>                                                                                                         |                                                                           |
| 9.2a     | User selects Close                                                                                                                                                                                                             | 9.1                                                                       |
| **10**   | **WHEN USER HAS MULTIPLE CARDS**                                                                                                                                                                                               |                                                                           |
| **10.1** | **System displays screen 'Approve organization'**<ul><li>Do you want to share details with [Organization]?</li><li>Actions: Share, About [organization], View data, Swap card, Read the agreement, Help, Close, Stop</li></ul> |                                                                           |
| 10.1a    | User selects Share                                                                                                                                                                                                             | 1.5                                                                       |
| 10.1b    | User selects About [organization]                                                                                                                                                                                              | 7                                                                         |
| 10.1c    | User selects View data                                                                                                                                                                                                         | 10.2                                                                      |
| 10.1d    | User selects Help                                                                                                                                                                                                              | Show placeholder 'under construction'                                     |
| 10.1e    | User selects Close                                                                                                                                                                                                             | 2                                                                         |
| 10.1f    | User selects Stop                                                                                                                                                                                                              | 2                                                                         |
| 10.1g    | User selects Read the agreement                                                                                                                                                                                                | 6                                                                         |
| 10.1e    | User selects Swap card                                                                                                                                                                                                         | 10.3                                                                      |
| **10.2** | **System displays screen 'Requested data'**<ul><li># from [Card Title]</li><li>Actions: Swap card, Details Incorrect, Help, Back</li></ul>                                                                                     |                                                                           |
| 10.2a    | User selects Swap card                                                                                                                                                                                                         | 10.3                                                                      |
| 10.2b    | User selects Details Incorrect                                                                                                                                                                                                 | 5                                                                         |
| 10.2c    | User selects Help                                                                                                                                                                                                              | Show placeholder 'under construction'                                     |
| 10.2d    | User selects Back                                                                                                                                                                                                              | Back                                                                      |
| **10.3** | **System displays bottom sheet 'Choose another card' with list of all possible cards**<ul><li>Actions: Close</li></ul>                                                                                                         |                                                                           |
| 10.3a    | User selects Card                                                                                                                                                                                                              | Back                                                                      |
| 10.3a    | User selects Close                                                                                                                                                                                                             | Back                                                                      |