LinkSDK statuses
The SDK callback receives a CallbackData object with two status fields:
status— the top-level outcome of the session, one ofSUCCESS,ERROR,CANCELLED,REDIRECT,LINK_CLOSED_PROGRAMMATICALLY. Switch on this in your UI code.secondary_status— the detailed, machine-readable status returned by the bank or the Lean API. Use this to log support diagnostics or to distinguish between differentERRORcauses.
This page lists every secondary_status value the SDK can surface. For the top-level status enum and the rest of the callback fields, see Config reference → callback.
Secondary status reference
| Status | Reason |
|---|---|
| OK | Successful connection |
| ACTIVE | Successful connection |
| ACCEPTED_BY_BANK | Bank confirmed payment initiation |
| PENDING_WITH_BANK | Payment is pending with the bank |
| FAILED | Generic failure |
| UNKNOWN | Generic failure |
| REJECTED_BY_BANK | Bank rejected the operation |
| MFA_ATTEMPTS_EXHAUSTED | User has attempted too many MFAs |
| INVALID_CREDENTIALS | User entered incorrect credentials |
| CREDENTIALS_UPDATE_REQUIRED | User has updated their username / password |
| MFA_REQUIRED | User needs to enter an OTP |
| INVALID_MFA | User entered an incorrect OTP |
| REQUIRES_LOGIN_MFA | User needs to enter an OTP |
| AWAITING_LOGIN_MFA_TOKEN | User needs to enter an OTP |
| INVALID_LOGIN_MFA | User needs to enter an OTP |
| AWAITING_PAYMENT_MFA_TOKEN | User needs to enter an OTP |
| INVALID_PAYMENT_MFA | User needs to enter an OTP |
| REQUIRES_BENEFICIARY_MFA | User needs to enter an OTP |
| INVALID_BENEFICIARY_MFA | User entered an incorrect OTP |
| REQUIRES_MFA | User needs to enter an OTP |
| AWAITING_APP_AUTH | User needs to confirm the transaction in a third party app |
| PENDING_BENEFICIARY_COOL_OFF | User's payment source is in a cool off state |
| AWAITING_END_USER_AUTHORIZATION | User needs to approve the transaction |
| REQUIRES_LOGIN_SECURITY_QUESTIONS | User needs to enter security question(s) |
| INVALID_LOGIN_SECURITY_QUESTION_ANSWER | User entered incorrect security question answer(s) |
| REQUIRES_BENEFICIARY_SECURITY_QUESTIONS | User needs to enter security question(s) |
| INVALID_BENEFICIARY_SECURITY_QUESTION_ANSWER | User entered incorrect security question answer(s) |
| SECURITY_QUESTION_ATTEMPTS_EXHAUSTED | User has exhausted security question answer attempts |
| SECURITY_QUESTION_ANSWER_REQUIRED | User needs to enter security question(s) |
| INVALID_SECURITY_QUESTION_ANSWER | User entered incorrect security question answer(s) |
| AWAITING_PAYMENT_SECURITY_QUESTIONS | User needs to enter security question(s) |
| INVALID_PAYMENT_SECURITY_ANSWERS | User entered incorrect security question answer(s) |
| SECURITY_QUESTION_ANSWER_ATTEMPTS_EXHAUSTED | User has exhausted security question answer attempts |
| PAYMENT_SOURCE_ACCOUNT_BALANCES | User requested account balances |
| PAYMENT_SOURCE_ACCOUNT_BALANCES_OK | User recieved account balances |
| PAYMENT_SOURCE_ACCOUNT_BALANCES_REQUIRES_MFA | User prompted for OTP to view latest balances |
| PAYMENT_SOURCE_ACCOUNT_BALANCES_INVALID_MFA | User entered incorrect MFA to view latest balances |
| PAYMENT_SOURCE_ACCOUNT_BALANCES_REQUIRES_SECURITY_QUESTION_ANSWER | User prompted for security questions to view balances |
| PAYMENT_SOURCE_ACCOUNT_BALANCES_INVALID_SECURITY_QUESTION_ANSWER | User entered incorrect details for a security question |
| PAYMENT_SOURCE_ACCOUNT_BALANCES_FAILED | Lean was unable to update a user's account balances |
| PAYMENT_SOURCE_ACCOUNT_BALANCES_CREDENTIALS_UPDATE_REQUIRED | User needs to update credentials |
| PAYMENT_SOURCE_ACCOUNT_BALANCES_INVALID_CREDENTIALS | User entered incorrect credentials |
| PAYMENT_SOURCE_ACCOUNT_BALANCES_EXHAUSTED_SECURITY_QUESTION_ATTEMPTS | User exhausted security question answer attempts |
| PAYMENT_SOURCE_ACCOUNT_BALANCES_EXHAUSTED_MFA_ATTEMPTS | User exhausted OTP entry attempts |
Updated 8 days ago