Data Intelligence Public Platform Documentation

Income Use Cases

Introduction

Income Report provides an overview of income-related data.

Information you can get from the Income Report:

  • How much income does the customer have?

  • Which kind of income does the customer have?

The following use cases are examples to make them more “plastic”.

Banks

UC-01: Bank wants to determine the user's income for a loan application

Actors

  • Bank

  • User

Systems

  • Bank’s loan application

  • finAPI Data Intelligence

  • finAPI Process Controller

  • finAPI WebForm

Goals

  • Determine income of a user

Preconditions

  • User has opened the Bank's online loan application

Flow

  • Bank’s loan application asks customer to import all accounts

    • Open finAPI Process Controller and get process token and user

    • Call finAPI WebForm v2 to let the user import the accounts

      • wait until user has finished

    • Call finAPI Data Intelligence Synchronize accounts endpoint and wait for callback

      • Callback should create a Case and an Income Report with the given Data Sources

    • Get the result of the Income Report

      • Look into the result to get all income related transactions and aggregations


Financial services providers in general

UC-02: Offers for tailor-made investment and insurance products.

Actors

  • Bank

  • User

Systems

  • Bank’s loan application

  • finAPI Data Intelligence

  • finAPI Process Controller

  • finAPI WebForm

Goals

  • Determine the users sources of income

  • Offer fitting insurances (e.g. Income from rental an leasing → houseowners insurance, liability insurance, legal costs insurance)

  • Offer suitable financial asset products.

Preconditions

  • User has opened the Bank's online loan application

Flow

  • Bank’s loan application asks customer to import all accounts

    • Open finAPI Process Controller and get process token and user

    • Call finAPI WebForm v2 to let the user import the accounts

      • wait until user has finished

    • Call finAPI Data Intelligence Synchronize accounts endpoint and wait for callback

      • Callback should create a Case and an Income Report with the given Data Sources

    • Get the result of the Income Report

      • Look into the result to get all income related transactions and aggregations


Real Estate Agents

UC-03: Real estate agents wants to determine the income for rental application.

Actors

  • Bank

  • User

Systems

  • Bank’s loan application

  • finAPI Data Intelligence

  • finAPI Process Controller

  • finAPI WebForm

Goals

  • Determine income of a user for rental application

Preconditions

  • User has opened the Bank's online loan application

Flow

  • Bank’s loan application asks customer to import all accounts

    • Open finAPI Process Controller and get process token and user

    • Call finAPI WebForm v2 to let the user import the accounts

      • wait until user has finished

    • Call finAPI Data Intelligence Synchronize accounts endpoint and wait for callback

      • Callback should create a Case and an Income Report with the given Data Sources

    • Get the result of the Income Report

      • Look into the result to get all income related transactions and aggregations