GuidesAPI ReferenceChangelog
Log In

Link SDK Errors

Link SDKs offer an onError callback so you can handle different error states of the Link Modal. Alternatively, the onEvent callback also fires error events as well.

πŸ“˜

Looking for a different category of errors?

Pinwheel's system also communicates API Errors and Job Errors.

The onError callback will be triggered for Link Modal errors as well as Job Errors. If an error occurred before closing the modal, Link's onExit callback is called with an error object as well.

🚧

Users may be able to proceed after error events

Errors surfaced via the error event do not necessarily mean the user can no longer continue to successfully complete the flow. For example, the error with code invalidCredentials fires when a user inputs invalid credentials, however, the user can proceed despite this error.

Link error types and codes are safe for developer use, whereas error messages are liable to change.

There are three different Link error types:

Error TypeDescription
networkErrorThe user's device is offline.
clientErrorThere is a problem with the SDK integration.
invalidLinkTokenThe Link token is invalid.

Specific error codes include:

typecodedescriptionmessage
networkErrornetworkErrorThrown when the user's device is offline, or when there is an issue communicating with the server.Uh oh, looks like your device is offline. Please try again later.
clientErrorclientErrorThis error is thrown when the client modal is in an erroneous stateUh oh, looks like we're having trouble getting you connected. Please try again later.
clientErrorconnectionRateLimitedThis error is thrown when a client is rate limitedUh oh, looks like we're having trouble getting you connected. Please try again later.
systemErrorsystemErrorAn unhandled error when a payroll integration behaves in an unexpected manner. These errors are fixed such that subsequent users do not trigger themUh oh, looks like we're having trouble getting you connected. Please try again later.
invalidLinkTokenusedLinkTokenThe Link token has already been usedUh oh, something unexpected happened. We are trying to fix this as quickly as possible, so please try again later.
invalidLinkTokeninvalidLinkTokenSignatureThe Link token signature is invalidUh oh, something unexpected happened. We are trying to fix this as quickly as possible, so please try again later.
invalidLinkTokeninvalidLinkTokenThe Link token is invalidUh oh, something unexpected happened. We are trying to fix this as quickly as possible, so please try again later.
invalidLinkTokenexpiredLinkTokenThe Link token has expiredUh oh, something unexpected happened. We are trying to fix this as quickly as possible, so please try again later.

Please contact [email protected] for access to our Developer Dashboard.