Income errors

Guide to troubleshooting Income errors

INCOME_VERIFICATION_DOCUMENT_NOT_FOUND

The requested income verification document was not found.
Common causes
  • The document URL is incorrect (for example, it may contain a typo) or has expired.
  • The document URL has already been accessed. Document URLs can only be used once.
Troubleshooting steps
1http code 400
2{
3 "error_type": "INCOME_VERIFICATION_ERROR",
4 "error_code": "INCOME_VERIFICATION_DOCUMENT_NOT_FOUND",
5 "error_message": "the requested data was not found. Please check the ID supplied.",
6 "display_message": null,
7 "request_id": "HNTDNrA8F1shFEW"
8}

INCOME_VERIFICATION_FAILED

The income verification you are trying to retrieve could not be completed. please try creating a new income verification
Common causes
  • The processing of the verification failed to complete successfully.
Troubleshooting steps
1http code 400
2{
3 "error_type": "INCOME_VERIFICATION_ERROR",
4 "error_code": "INCOME_VERIFICATION_FAILED",
5 "error_message": "the income verification you are trying to retrieve could not be completed. please try creating a new income verification",
6 "display_message": null,
7 "request_id": "HNTDNrA8F1shFEW"
8}

INCOME_VERIFICATION_NOT_FOUND

The requested income verification was not found.
Common causes
  • The Link flow has not been completed with income_verification enabled; either the user has not yet completed the Link flow, or the link token was not initialized with the income_verification product.
Troubleshooting steps
1http code 400
2{
3 "error_type": "INCOME_VERIFICATION_ERROR",
4 "error_code": "INCOME_VERIFICATION_NOT_FOUND",
5 "error_message": "the requested data was not found. Please check the ID supplied.",
6 "display_message": null,
7 "request_id": "HNTDNrA8F1shFEW"
8}

INCOME_VERIFICATION_UPLOAD_ERROR

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

PRODUCT_NOT_ENABLED

The Income product has not been enabled.
Common causes
  • The Income product has not been enabled.
Troubleshooting steps
1http code 400
2{
3 "error_type": "INCOME_VERIFICATION_ERROR",
4 "error_code": "PRODUCT_NOT_ENABLED",
5 "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.",
6 "display_message": null,
7 "request_id": "HNTDNrA8F1shFEW"
8}

PRODUCT_NOT_READY

The Income product has not completed processing.
Common causes
  • Parsing of the uploaded pay stubs has not yet completed.
Troubleshooting steps
1http code 400
2{
3 "error_type": "INCOME_VERIFICATION_ERROR",
4 "error_code": "PRODUCT_NOT_READY",
5 "error_message": "the requested product is not yet ready. please provide a webhook or try the request again later",
6 "display_message": null,
7 "request_id": "HNTDNrA8F1shFEW"
8}

VERIFICATION_STATUS_PENDING_APPROVAL

The user has not yet authorized the sharing of this data
Common causes
  • The user has not yet authorized access to the data.
Troubleshooting steps
1http code 400
2{
3 "error_type": "INCOME_VERIFICATION_ERROR",
4 "error_code": "VERIFICATION_STATUS_PENDING_APPROVAL",
5 "error_message": "The user has not yet authorized the sharing of this data",
6 "display_message": null,
7 "request_id": "HNTDNrA8F1shFEW"
8}

EMPLOYMENT_NOT_FOUND

The requested employment was not found.
Common causes
  • The Link flow has not been completed with employment enabled; either the user has not yet completed the Link flow, or the link token was not initialized with the employment product.
Troubleshooting steps
1http code 400
2{
3 "error_type": "INCOME_VERIFICATION_ERROR",
4 "error_code": "EMPLOYMENT_NOT_FOUND",
5 "error_message": "the requested employment data was not found. Please check the ID supplied.",
6 "display_message": null,
7 "request_id": "HNTDNrA8F1shFEW"
8}