HomeGuidesAPI Reference
Log In
Guides

Introduction to Income Verification

Verify a user's income, regular expenses, and disposable income from their real transaction history.

Income Verification

Income Verification gives you a data-backed affordability assessment - derived from a user's actual bank transactions, not self-reported numbers. In minutes, you know what a person earns, what they spend on fixed commitments, and how much is genuinely left over.

Use it to automate lending decisions, subscription affordability checks, or rent-to-income assessments without asking users for payslips or bank statements.

📘

Get credentials

Sign in to console.qwist.cloud to generate sandbox credentials with demo bank access.


Prerequisites

Complete these steps before starting the implementation guide.

Step 1

Get your API credentials

Sign in to the nrich Console to generate sandbox credentials instantly. No approval needed. The sandbox includes a demo bank for end-to-end testing. Production credentials can be requested directly from the Console once you are ready to go live.

Open Console →

Step 2

Review the Widget Integration Guide

Most nrich products use a Widget UI for bank selection and authentication. Understanding how to embed it before you start will save you time.

Widget Integration Guide →

Why transaction data beats payslips

Payslips and bank statements are the traditional way to verify income, but they have three fundamental problems: they're easy to falsify - a PDF can be edited, a screenshot altered - they're slow to collect and verify manually, and they only show a point-in-time snapshot that tells you nothing about how someone actually spends.

Transaction data pulled directly from the bank solves all three. It's tamper-proof because it comes from the institution itself, it reflects the user's current financial situation rather than last month's summary, and it's behavioural - you see what someone actually does with their money, not just what lands in their account.

Two things transaction data catches that payslips never will: a user who earns €3,000/month but carries €2,900 in fixed commitments, leaving almost nothing disposable; and a salary that's been irregular or declining for the past three months, which may signal job instability before any self-reported document would reflect it.

Payslips / statementsTransaction data via nrich
Fraud riskHigh - documents can be alteredNone - sourced directly from the bank
Processing timeHours to days (manual review)Seconds (automated analysis)
Expense visibilityNoneFull breakdown of fixed and variable spend
Handles irregular incomeNo - shows fixed salary onlyYes - detects patterns across multiple income streams
User effortHigh - locate, upload, waitLow - bank login only

Key concepts

Income stream
Regular expenses
Variable expenses
Disposable income
Discretionary income

How it works

You can find a step-by-step description in the next section.

📘

Reporting period recommendation

A reporting_period of at least 6 months is needed for reliable pattern detection. 12 months gives the most accurate picture of income stability and seasonal spending.


Coverage

Income Verification

Available across all nrich AIS-supported countries

GermanyAustriaSpainPortugalFranceItalyNetherlandsBelgiumNorwaySwedenDenmark

View full bank catalog - 3,381 banks across 33 countries →


Did this page help you?