GuidesAPI ReferenceChangelog
Log In
Guides

Link SDK Errors

Link SDKs offer an onError callback so you can handle different error states of the Link Modal.

📘

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.

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.