Income errors

Guide to troubleshooting Income errors

PRODUCT_NOT_ENABLED

The Income product has not been enabled.
Server-Side
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}

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
1http code 400
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}

INCOME_VERIFICATION_FAILED

The income verification you are trying to retrieve could not be completed. please try creating a new income verification
Server-SideorClient-Side
Common causes
  • The processing of the verification failed to complete successfully.
Troubleshooting steps
1http code 500
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}

VERIFICATION_STATUS_PENDING_APPROVAL

The user has not yet authorized the sharing of this data
Server-Side
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}