User Connection Status Codes
Connection Status Code Matrix
Note:
isValid flag on the connectionStatus is a great reference point for the validity of the user's credentials
| Status Code | isValid | HTTP Status Code | Description | Webhook fired | Notes |
|---|---|---|---|---|---|
| 2000 | TRUE | 200 | Auth successful! | TRUE | |
| 2001 | FALSE | 200 | Security step pending. | TRUE | User needs to re-authenticate with all required MFA details. For Mohela direct connected users with security questions, please disconnect the user and have them reattempt authentication. |
| 2002 | FALSE | 200 | OTP Step pending | TRUE | In particular, Nelnet's new integration requires an OTP. When the user needs to re-authenticate. |
| 2003 | FALSE | 200 | Email missing on user's profile. | TRUE | We are not able to get all of the loan account information if the email has not been provided to the servicer. |
| 2004 | FALSE | 200 | Need to confirm auto-debit enrollment. | TRUE | Without confirming/denying auto-debit info, we are not able to get account information. |
| 2005 | TRUE | 200 | Auth successful! | FALSE | The user selected an incorrect servicer during the initial connection. |
| 2006 | TRUE | 200 | Servicer specific status where authentication is stuck for any other reason | FALSE (note: webhook will be fired for existing connections) | The messaging will vary by loan servicer. |
| 5000 | TRUE | 500 | {{Error is passed directly from the servicer}} | FALSE | |
| 5001 | FALSE | 401 | {{Error is passed directly from the servicer}} | TRUE | |
| 5002 | FALSE | 401 | {{Error is passed directly from the servicer}} | TRUE | |
| 5003 | TRUE | 401 | {{Error is passed directly from the servicer}} | FALSE | |
| 5004 | FALSE | 401 | {{Error is passed directly from the servicer}} | TRUE |
To learn more about our debt APIs and 1-click solutions, visit spinwheel.io.
Updated 7 months ago