# Verification of Income
source: https://developer.mastercard.com/open-finance-europe/documentation/licensed/insights/voi/index.md

## Overview {#overview}

Verification of Income product (VOI) allows an **AIS licensed client** to identify a consumer's income through utilizing Open Banking transaction data and highlighting the various income streams that make their income. The VOI Solution is available through the insights platform. ​

The VOI solution analyses positive inbound transaction amounts, distinguishes between one-off and recurring income streams to provide clarity on the nature of income. It then employs a series of calculations---including total income, total salary, regularity, longevity, and stability of income---to generate confidence ratings, categorized as high, medium, or low. Clients can seamlessly access these income-related insights through the Insights API, available in **JSON and PDF formats**. Importantly, clients are at their own discretion of this information, whether for approving or declining credit applicants.​

This solution is tailored for Third-Party Providers (TPPs) who operate under their own **AIS license only**. Ensuring compliance with PSD2 Open Banking consent requirements on behalf of the end user

## Participants and Interactions {#participants-and-interactions}

Mastercard Open Banking Insights provides actionable data retrieved Open Banking connectivity through a single platform that supports multiple products including Verification of Income.
![](https://static.developer.mastercard.com/content/open-finance-europe/uploads/insights/participants-interactions-voi.png)

|      Participant      |                                                                 Description                                                                  |                      Example                      |
|-----------------------|----------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------|
| **Consumer**          | Consumer provides consent to share account information. This is also defined as the payment service user "PSU".                              | Bank account holder                               |
| **Business**          | Business provides consent to share account information. This is also defined as the payment service user "PSU".                              | Business bank account holder                      |
| **Bank**              | The financial institution where the consumer holds an account. This is also defined as the Account Service Payment Service Provider "ASPSP". | Retail banking provider Business banking provider |
| **Integrator**        | Initiates request for Account Owner Verification through the Insights API endpoint.                                                          | Financial Institution Financing Companies Lenders |
| **Insights Platform** | Serves as an integration point for integrators to offer Insights services.                                                                   | Mastercard                                        |

## How it works {#how-it-works}

Diagram voi-enterprise-how-it-works

**Detailed steps are explained below:**

1. End User initiates a service with the client. For example, a consumer wishes to apply for a Credit Card.

2. The Client collects the consent from the end user with data parameters defined according to which product they would like to consume.

3. End user gives consent to the client to connect to their bank. Consent is managed by the client.

4. Client submits the Insights job through the Insights endpoint and specifies which service they would like ( eg: Verification of Income).

5. Mastercard validates client credentials.

6. Mastercard returns the Connect URL

7. Mastercard presented the Connect URL to the end user on the clients site.

8. The connectURL is presented to the end user who can use it to authorise access to their account.

9. The URL will either direct the End User to the Bank Selection screen or ASPSP depending on whether the Client has passed a Provider ID to Insights.

10. End User Redirected to the client.

11. Mastercard requests transactions information from the bank

12. Mastercard receives account and transactions information from the bank.

13. Mastercard performs categorisation and leverages algorithmic models to provide Income insights.

14. Client polls the Status end point to enquire about the status of the job

15. Status of the job returned

16. Insights available to the client.

17. Client requests the insights results.

18. The Client can use the results to make a decision that relates to the end user.

## Report example {#report-example}

You can view an example Verification of Income report by downloading the following PDF:
[VoI summary report example.pdf](https://static.developer.mastercard.com/content/open-finance-europe/documents/VoI%20summary%20report%20example.pdf) (174KB)

## User journey {#user-journey}

When the end user is redirected to their bank for SCA, we will facilitate this through [Supervised login](https://developer.mastercard.com/open-finance-europe/documentation/licensed/aiia-enterprise/connect/supervised/index.md). The user will be redirected to an authentication URL in a browser. Here, they will choose their provider (bank or other financial institution) and enter their credentials. A [Supervised login](https://developer.mastercard.com/open-finance-europe/documentation/licensed/aiia-enterprise/connect/supervised/index.md) flow consist of a series of steps that the user needs to perform. A typical example is to enter a username and password as a first step, and a one-time password as a second step.

Some providers support multiple login methods. In this way, these providers allow the user to choose between using an authentication app or merely logging in with a username and a password. Therefore, there will be different supervised login flows.

To learn more: see [here](https://developer.mastercard.com/open-finance-europe/documentation/licensed/aiia-enterprise/connect/supervised/index.md)

## Next steps {#next-steps}

* Refer to the [API References](https://developer.mastercard.com/open-finance-europe/documentation/licensed/insights/api-references/index.md) to learn more about the API.

### Getting help {#getting-help}

Complete the [Contact Us](https://openbankingeu.mastercard.com/contact-us) form if you have any questions or require assistance.