Income Verification (beta) errors

Guide to troubleshooting Income Verification errors

PRODUCT_NOT_ENABLED

The Income Verification product has not been enabled.
Server-Side
Common causes
  • The Income Verification product has not been enabled.
Troubleshooting steps
1
2
3
4
5
6
7
8
http code 400
{
"error_type": "INCOME_VERIFICATION_ERROR",
"error_code": "PRODUCT_NOT_ENABLED",
"error_message": "the 'income_verification' product is not enabled for the following client ID: <CLIENT_ID>. please ensure that the 'income_verification' is included in the 'product' array when initializing Link and try again.",
"display_message": null,
"request_id": "HNTDNrA8F1shFEW"
}

INCOME_VERIFICATION_NOT_FOUND

An employment verification instance with the given ID was not found.
Server-Side
Common causes
  • An invalid income verification ID was provided.
Troubleshooting steps
1
2
3
4
5
6
7
8
http code 400
{
"error_type": "INCOME_VERIFICATION_ERROR",
"error_code": "INCOME_VERIFICATION_NOT_FOUND",
"error_message": "an 'income_verification' with the id <ID> cannot be found",
"display_message": null,
"request_id": "HNTDNrA8F1shFEW"
}

INCOME_VERIFICATION_UPLOAD_ERROR

There was an error uploading income verification documents.
Server-SideorClient-Side
Common causes
  • The end user's Internet connection may have been interrupted during the upload attempt.
Troubleshooting steps
1
2
3
4
5
6
7
8
http code 400
{
"error_type": "INCOME_VERIFICATION_ERROR",
"error_code": "INCOME_VERIFICATION_UPLOAD_ERROR",
"error_message": "there was a problem uploading the document for verification. Please try again or recreate an income verification.",
"display_message": null,
"request_id": "HNTDNrA8F1shFEW"
}

INCOME_VERIFICATION_DOCUMENT_INVALID

A document used to verify income was invalid.
Server-SideorClient-Side
Common causes
  • The uploaded document was not a supported type. The following filetypes are supported: PDF, JPEG, PNG, BMP, GIF, TIFF.
Troubleshooting steps
1
2
3
4
5
6
7
8
http code 400
{
"error_type": "INCOME_VERIFICATION_ERROR",
"error_code": "INCOME_VERIFICATION_DOCUMENT_INVALID",
"error_message": "the uploaded document is invalid. upload must be a PDF or image of type JPEG, PNG, BMP, GIF, TIFF",
"display_message": null,
"request_id": "HNTDNrA8F1shFEW"
}

INCOME_VERIFICATION_DOCUMENT_NOT_RECOGNIZED

The uploaded income verification document could not be recognized.
Server-SideorClient-Side
Common causes
  • The uploaded document was not recognized as a paystub.
Troubleshooting steps
1
2
3
4
5
6
7
8
http code 400
{
"error_type": "INCOME_VERIFICATION_ERROR",
"error_code": "INCOME_VERIFICATION_DOCUMENT_NOT_RECOGNIZED",
"error_message": "the uploaded document was not recognized as an accepted document type",
"display_message": null,
"request_id": "HNTDNrA8F1shFEW"
}