diff --git a/documentation/API_documentation/NumberVerification_verify_User_Story.md b/documentation/API_documentation/NumberVerification_verify_User_Story.md index 2ac46f6..3faed10 100644 --- a/documentation/API_documentation/NumberVerification_verify_User_Story.md +++ b/documentation/API_documentation/NumberVerification_verify_User_Story.md @@ -2,7 +2,8 @@ | **Item** | **Details** | | ---- | ------- | -| ***Summary*** | As an enterprise application developer, I want to verify the phone number associated with the line from which the call was made, so I can get a proof of possession of the phone number. | +| ***Summary*** | As an enterprise application developer, I want to verify the phone number associated with the phone from which the call was made, so I can get a proof of possession of the phone number. | + | ***Roles, Actors and Scope*** | **Roles:** Customer:User, Customer:BusinessManager, Customer:Administrator
**Actors:** Application service providers, hyperscalers, application developers, end users.
**Scope:**
- Verifies if the specified phone number (plain text or hashed format) matches the one that the user is currently using. | | ***Pre-conditions*** |The preconditions are listed below:
  1. The Customer:BusinessManager and Customer:Administrator have been onboarded to the CSP's API platform.
  2. The Customer:BusinessManager has successfully subscribed to the Number Verification product from the product catalog.
  3. The Customer:Administrator has onboarded the Customer:User to the platform.
  4. The Customer:user performs an authorization request to CSP.
  5. The CSP checked access & user approval then provide access token to the Customer:user
  6. The Customer:user get the access token based on network authentication to ensure secure access of the API.| | ***Activities/Steps*** | **Starts when:** The customer application makes a POST verify via the number verification API providing in the request the phone number provided by the user on the application. This input could be hashed or plain.
    **Ends when:** The Number verification server answers if the phone number provided corresponds to the one of the line from which the request was triggered. |