This website uses cookies so that we can provide you with the best user experience possible. Cookie information is stored in your browser and performs functions such as recognising you when you return to our website and helping our team to understand which sections of the website you find most interesting and useful.
Session handling
In this section we will cover the sessions that Brite handles. Sessions are created to load the Brite Client and there are five different use-cases:
- Deposit
- Reccuring deposit
- Withdrawal
- Bank account selection
- Client Authentication
When the session is created there is a session
token returned in the API that is used when loading the client. All of these methods also support callbacks for automatic updates of the current session or transaction status. Session details
The Brite API also provides functionality to get the session status and information. The
session.get API call allows you to get the full information about a session. This will give you the state of the session as well as providing you with a corresponding transaction_id if applicable.
The session.state API call enables you to get the state of an ongoing session in the Brite backend. The session states show how the end user is interacting with the Brite client. This will give you the state of the session as well as providing you with a corresponding transaction_id if applicable. Session timeout
A deposit session is valid for 30min.
Session states
| Name | ID | Description |
|---|---|---|
| STATE_CREATED | 0 | Session has been created. |
| STATE_AUTHENTICATION_STARTED | 1 | End user has chosen a bank, entered credentials and clicked submit. |
| STATE_AUTHENTICATION_COMPLETED | 2 | End user has finished authenticating. |
| STATE_BANK_ACCOUNT_SELECTION_STARTED | 3 | End user is shown the bank account selection view. |
| STATE_BANK_ACCOUNT_SELECTION_COMPLETED | 4 | End user has chosen the desired bank account for deposit. |
| STATE_DEPOSIT_STARTED | 5 | Deposit transaction is created. |
| STATE_RECIPIENT_APPROVAL_STARTED | 6 | Only for Swedbank. The end user needs to add Brite to their recipient base. |
| STATE_RECIPIENT_APPROVAL_COMPLETED | 7 | Only for Swedbank. The end user has added Brite to their recipient base. |
| STATE_TRANSACTION_APPROVAL_STARTED | 8 | The end user needs to sign the transaction. |
| STATE_TRANSACTION_APPROVAL_COMPLETED | 9 | The end user has signed the transaction |
| STATE_ABORTED | 10 | Session was aborted for a known reason, see 5.7 Aborted state errors. |
| STATE_FAILED | 11 | Session failed for unknown reason or was manually failed by Brite. |
| STATE_COMPLETED | 12 | The session flow has been completed. |