Listen to Widget events

The attachEventListener method is an optional method for attaching callback functions to specific Widget events.

instantor.attachEventListener(eventName, callbackFunction(payload))

This method attaches an event listener with a specified callback function to the specified event, eventName. When triggered, the callback function is called with an event payload.

Event Name	Payload Example	Description
load	{ status: true }	Triggered when the Widget has loaded. The payload contains status true if loading was successful.
processEnd	{ "process-finished" }	Triggered when the process has ended, i.e. the user completed the last login step. The payload contains a representation of the result: "process-finished" "invalid-login" "process-error"
chooseBank	{ bankAbbreviation: "se-swedbank", bankID: "uuid", sessionID: "uuid" }	Triggered when the user selects a bank. The payload contains a representation of the bank and session data: bankAbbreviation (bank abbreviation) bankID (unique bank ID) sessionID (unique session ID).
error	{ message: "error message" }	Triggered when an error occurs. The payload contains a description of the error.
displayChange	{ display: "bankLogin" }	Triggered when the Widget changes content. The payload contains a representation of what is displayed: "bankLogin" (the Widget renders a bank login form) "bankChooser" (the Widget renders the bank chooser)

Example

An example of how to use attachEventListener

const instantor = new Instantor('produktKey.example')
  
instantor.attachEventListener('chooseBank', function(payload) {
  console.log("The user selected this bank: " + payload.bankAbbreviation);
})
  
instantor.load('#instantor_div');