Financial Accounts Income and Employment
Collecting information about financial accounts to verify income and employment.
Overview
Income and employment verification through financial account data is a modern and efficient method to validate financial and employment status. Leverage digital records from banks, credit unions, or other financial institutions, to view real-time insights into a person's income streams, transaction history, and employment deposits. Traditional methods involving manual document submissions may be cumbersome and prone to errors or falsification.
Use financial data for verification for multiple use cases like the examples below.
- Lenders quickly assessing loan eligibility
- Landlords evaluating tenant applications
- Employers confirming a potential hire's employment history
- Social service agencies determining benefits or assistance eligibility
These data-driven verifications are immediate and accurate. They streamline processes, reduce fraud, and ensure better decision making across sectors.
Configuring using Financial Accounts as VOIE
Truv simplifies connecting your users to their financial institution. Users can select their bank or credit union in Truv Bridge from the list of most popular financial institutions. They can also look for their financial institution in the search field at the top of the screen.
Bridge token specifications
When creating a Bridge Token for the User, additional values in the request are required. Include the product_type = income
and data_sources = ["financial_accounts"]
in the configuration from the cURL sample below.
curl --request POST \
--url https://prod.truv.com/v1/users/{user_id}/tokens/ \
--header 'X-Access-Client-Id: {{client_id}}' \
--header 'X-Access-Secret: {{access_key}} ' \
--header 'accept: application/json' \
--header 'content-type: application/json' \
--data '
{
"product_type": "income",
"data_source": ["financial_accounts"],
"tracking_info": "any data for tracking current transaction"
}
'
Income Reports
Truv income reports share a comprehensive view of the user’s financial account. This information is an overview and includes historical information. This gives decision makers as much information as possible about a user’s financial account.
Endpoints
These endpoints provide a comprehensive collection of financial account information from a user. View detailed information on the attributes and responses using the Income Report API reference page.
Example response
The JSON example below contains payload information from income reports.
{
"status": "success",
"completed_at": "2022-05-04T11:30:00Z",
"days_requested": 61,
"tracking_info": "any string",
"provider": "bank_of_america",
"access_token": "99dd17074ac94aa9ace2621d657c7610",
"companies": [
"my employer"
],
"accounts": [
{
"id": "24d7e80942ce4ad58a93f70ce4115f5c",
"created_at": "2022-05-04T11:30:00Z",
"updated_at": "2022-05-04T12:00:00Z",
"type": "CHECKING",
"subtype": "MONEY_MARKET",
"mask": "string",
"nickname": "My account"
}
],
"income": [
{
"start_date": "2022-05-04",
"end_date": "2022-05-04",
"account_id": "24d7e80942ce4ad58a93f70ce4115f5c",
"income_description": "Paycheck",
"income_category": "Income: Paycheck",
"pay_rate": 0,
"pay_frequency": "SM",
"total_amounts": [
{
"amount": "200.31",
"iso_currency_code": "USD"
}
],
"transaction_count": 7,
"historical_summary": [
{
"start_date": "2022-05-04",
"end_date": "2022-05-04",
"total_amounts": [
{
"amount": "200.31",
"iso_currency_code": "USD"
}
],
"transactions": [
{
"amount": "200.31",
"iso_currency_code": "USD",
"date": "2022-05-04",
"check_number": "string",
"description": "string",
"pending": true,
"transaction_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
}
]
}
]
}
],
"summary": {
"start_date": "2022-05-04",
"end_date": "2022-05-04",
"income_sources_count": 2,
"income_categories_count": 1,
"income_transactions_count": 17,
"total_amounts": [
{
"amount": "200.31",
"iso_currency_code": "USD"
}
]
},
"is_suspicious": false
}
Updated 10 months ago