# Partial Flow 2.4 Confirm a protected action

## Overview

| Aspect                       | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| ---------------------------- |---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| **Summary**                  | The user confirms a protected action by entering their PIN. If they fail too many times, they are locked out of the app.                                                                                                                                                                                                                                                                                                                                                                                                        |
| **Goal**                     | Confirming a protected action.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| **Preconditions**            | *None*                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| **Postconditions**           | Depends on the use case.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| **Used by**                  | <ul><li>[UC2.2 Change biometric unlock](../use-cases/UC2.2_ChangeBiometricUnlock.md)</li><li>[UC2.6 Change PIN](../use-cases/UC2.6_ChangeRemotePIN.md)</li><li>[UC3.1 Obtain PID](../use-cases/UC3.1_ObtainPidFromProvider.md)</li><li>[UC4.1 Obtain cards](../use-cases/UC4.1_ObtainCardsFromEAAIssuer.md)</li><li>[UC5.1 Share data with RP](../use-cases/UC5.1_ShareDataWithRP.md)</li><li>[UC5.2 Login to RP application](../use-cases/UC5.2_LoginToApplicationOfRP.md)</li></ul>                                           |
| **Parameters**               | Cancelable                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| **Possible Results**         | <ul><li>Confirm</li><li>Cancel</li><li>Back</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| **Additional Documentation** | *None*                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| **Possible errors**          | *None*                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| **Logical test cases**       | <ul><li>[LTC5 Disclosure based Issuance](../logical-test-cases.md#ltc5)</li><li>[LTC15 Share data](../logical-test-cases.md#ltc15)</li><li>[LTC41 Recover PIN](../logical-test-cases.md#ltc41)</li><li>[LTC56 PIN Change](../logical-test-cases.md#ltc56)</li><li>[LTC74 Revoke wallet with revocation code](../logical-test-cases.md#ltc74)</li><li>[LTC75 Revoke wallet by wallet id](../logical-test-cases.md#ltc75)</li><li>[LTC76 Revoke wallet by recovery id](../logical-test-cases.md#ltc76)</li><li>[LTC77 Revoke wallet solution](../logical-test-cases.md#ltc77)</li></ul> |

---

## Flow

| #       | Description                                                                                                                                                                                                   | Next                                                                    |
|---------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------|
| **1**   | **PRIMARY SCENARIO**                                                                                                                                                                                          |                                                                         |
| **1.1** | **System displays PIN screen**<ul><li>Input: 6 digits (0-9) PIN field</li><li>Actions: Back, Cancel, Forgot Pin, Help</li></ul>                                                                               |                                                                         |
| 1.1a    | User enters PIN                                                                                                                                                                                               | 1.2                                                                     |
| 1.1b    | User selects Forgot PIN                                                                                                                                                                                       | 2                                                                       |
| 1.1c    | User selects Back                                                                                                                                                                                             | Result: Back                                                            |
| 1.1d    | User selects Cancel (when Cancelable)                                                                                                                                                                         | Result: Cancel                                                          |
| 1.1e    | User selects Help                                                                                                                                                                                             | Show placeholder 'under construction'                                   |
| **1.2** | **System executes partial flow [PF2.8 Validate PIN](PF2.8_ValidatePin.md)**                                                                                                                                   |                                                                         |
| 1.2a    | Result: Valid PIN                                                                                                                                                                                             | 1.3                                                                     |
| 1.2b    | Result: Retry                                                                                                                                                                                                 | 1.1                                                                     |
| 1.2c    | Result: Back                                                                                                                                                                                                  | Back                                                                    |
| **1.3** | **System determines wallet status**                                                                                                                                                                           |                                                                         |
| 1.3a    | Case: Wallet is active                                                                                                                                                                                        | 1.4                                                                     |
| 1.3b    | Case: Wallet is revoked by user                                                                                                                                                                               | 3                                                                       |
| 1.3c    | Case: Wallet ID is revoked by admin                                                                                                                                                                           | 4                                                                       |
| 1.3d    | Case: Wallet recovery code is revoked by admin                                                                                                                                                                | 5                                                                       |
| 1.3e    | Case: Wallet solution is revoked by admin                                                                                                                                                                     | 6                                                                       |
| **1.4** | **System executes partial flow [PF1.4 Apply update policy](PF1.4_ApplyAppUpdatePolicy.md)**                                                                                                                   |                                                                         |
| 1.4a    | Result: App version is allowed                                                                                                                                                                                | Result: Confirm                                                         |
| **2**   | **RECOVER FROM FORGOTTEN PIN**                                                                                                                                                                                |                                                                         |
| **2.1** | **System determines if protected action is PID issuance**                                                                                                                                                     |                                                                         |
| 2.1a    | Case: Protected action is PID issuance                                                                                                                                                                        | 2.2                                                                     |
| 2.1b    | Case: Protected action is not PID issuance                                                                                                                                                                    | 2.3                                                                     |
| **2.2** | **System displays screen 'forgot PIN'**<ul><li>Forgot PIN?</li><li>Actions: Delete Wallet, Back</li></ul>                                                                                                     |                                                                         |
| 2.2a    | User selects Delete Wallet                                                                                                                                                                                    | Go to: [UC9.4 Wipe all app data](../use-cases/UC9.4_WipeAllAppData.md)  |
| 2.2b    | User selects Back                                                                                                                                                                                             | Back                                                                    |
| **2.3** | **System displays screen 'forgot PIN'**<ul><li>Forgot PIN?</li><li>Actions: Create a new PIN, Back</li></ul>                                                                                                  |                                                                         |
| 2.3a    | User selects Delete Wallet                                                                                                                                                                                    | Go to: [UC2.3.2 Recover PIN](../use-cases/UC2.3.2_RecoverPIN.md)        |
| 2.3b    | User selects Back                                                                                                                                                                                             | Back                                                                    |
| **3**   | **WHEN WALLET IS REVOKED BY USER**                                                                                                                                                                            |                                                                         |
| **3.1** | **System displays screen 'Your wallet was deleted'**<ul><li>Message: You deleted this wallet with your deletion code</li>li>Actions: To help desk, Help</li></ul>                                             |                                                                         |
| 3.1a    | User selects To help desk                                                                                                                                                                                     | 3.2                                                                     |
| 3.1b    | User selects Help                                                                                                                                                                                             | Show placeholder 'under construction'                                   |
| **3.2** | **System displays screen 'Contact'**<ul><li>Message: Check our website or contact us</li>li>Actions: Call, Back</li></ul>                                                                                     |                                                                         |
| 3.2a    | User selects Call<br>&rarr; System opens phone and suspends app                                                                                                                                               |                                                                         |
| 3.2b    | User selects Back                                                                                                                                                                                             | Back                                                                    |
| **4**   | **WHEN WALLET ID IS REVOKED BY ADMIN**                                                                                                                                                                        |                                                                         |
| **4.1** | **System displays screen 'Your wallet is blocked'**<ul><li>Message: Close this app or creat e a new wallet to use the app again.</li>li>Actions: Create new NL Wallet, To help desk, Help</li></ul>           |                                                                         |
| 4.1a    | User selects To help desk                                                                                                                                                                                     | 4.2                                                                     |
| 4.1b    | User selects Help                                                                                                                                                                                             | Show placeholder 'under construction'                                   |
| 4.1c    | User selects Create new NL Wallet                                                                                                                                                                             | Go to: [UC1.1 Introduce the app](../use-cases/UC1.1_IntroduceTheApp.md) |
| **4.2** | **System displays screen 'Contact'**<ul><li>Message: Check our website or contact us</li>li>Actions: Call, Back</li></ul>                                                                                     |                                                                         |
| 4.2a    | User selects Call<br>&rarr; System opens phone and suspends app                                                                                                                                               |                                                                         |
| 4.2b    | User selects Back                                                                                                                                                                                             | Back                                                                    |
| **5**   | **WHEN WALLET RECOVERY CODE IS REVOKED BY ADMIN**                                                                                                                                                             |                                                                         |
| **5.1** | **System displays screen 'Your have been blocked'**<ul><li>Message: You cannot use NL WALLET right now.</li>li>Actions: To help desk, Help</li></ul>                                                          |                                                                         |
| 5.1a    | User selects To help desk                                                                                                                                                                                     | 5.2                                                                     |
| 5.1b    | User selects Help                                                                                                                                                                                             | Show placeholder 'under construction'                                   |
| **5.2** | **System displays screen 'Contact'**<ul><li>Message: Check our website or contact us</li>li>Actions: Call, Back</li></ul>                                                                                     |                                                                         |
| 5.2a    | User selects Call<br>&rarr; System opens phone and suspends app                                                                                                                                               |                                                                         |
| 5.2b    | User selects Back                                                                                                                                                                                             | Back                                                                    |
| *65**   | **WHEN WALLET SOLUTION IS REVOKED BY ADMIN**                                                                                                                                                                  |                                                                         |
| **6.1** | **System displays screen 'NL Wallet can no longer be used'**<ul><li>Message: You cannot use NL WALLET right now due to a technical problem on our side.</li>li>Actions: Read more information, Help</li></ul> |                                                                         |
| 6.1a    | User selects Read more information                                                                                                                                                                            | 5.2                                                                     |
| 6.1b    | User selects Help                                                                                                                                                                                             | Show placeholder 'under construction'                                   |
| **6.2** | **System displays screen 'More information'**<ul>li>Actions: Back</li></ul>                                                                                                                                   |                                                                         |
| 6.2a    | User selects Back                                                                                                                                                                                             | Back                                                                    |