Tax Returns Income

This guide covers adding tax return processing for income and employment verification.

Configuring Tax Returns collection

Create successful experiences for your users with a high quality introduction page for Tax Returns product. Users can verify income and connect to their tax preparation software from the start. Provide context for next steps highlighting your users’ privacy and security.

Verification can be instant compared to the wait time for IRS tax returns and documents such as 4506-C. With this benefit, improve your conversion rates when guiding users connecting their accounts.

Configure your introduction page to your users on top of Truv’s widget templates. Provide additional context and guidance as needed for a successful user experience.

Truv simplifies connecting your users to their tax preparation software providers. Users can select their tax preparation provider from the list in Truv Bridge.

Bridge Token specifications

Document uploading for collecting tax returns requires additional request values. This occurs when creating a Bridge Token for the user. Include the product_type = income and data_sources = ["tax"] in the configuration from the cURL sample below.

curl --request POST \
     --url{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_sources": ["tax"],
     "tracking_info": "any data for tracking current transaction"

Example response

The JSON data below contains a sample payload from the List all tax documents endpoint.

    "id": "24d7e80942ce4ad58a93f70ce4115f5c",
    "document_type": "F1040",
    "document_subtype": "",
    "file": "",
    "md5sum": "24d7e80942ce4ad58a93f70ce4115f5c",
    "year": 2019

Testing integrations

When implementing VOIE in your workflow for Tax Returns, use the credentials below to try different scenarios within the sandbox.

goodlogin.taxgoodpassword991-91-9991Successful login with complete data returned

The table below covers the credentials available for testing error scenarios.

error.userlogin_errorIncorrect login and password
error.usermfa_errorIssue with multi-factor authentication
error.useraccount_lockedLocked account, requires provider unlock
error.userno_dataNo data found in provider account
error.userunavailableProvider is not available, maintenance issue
error.usererrorGeneric login error