initialise

open override fun initialise(settings: TerminalSettings, response: InitialisationResponseHandler, notification: NotificationHandler?): Boolean

Initialises the payment terminal. Before the payment terminal can be used to process transactions, it has to be initialised. The initialisation process includes contacting the payment processor and downloading the current terminal settings.

This method returns immediately but the initialisation result is returned in the response callback. The initialisation takes a little time, from a few seconds to a couple of minutes, depending on network availability and if there are new settings or updates to process.

The initialisation is done in the background. The payment application will not take over the screen during this time.

Return

true if the request was sent successfully, otherwise false. Note that this does not indicate the success or failure of the initialisation. If no InitialisationResponseHandler is provided the method will return false.

Parameters

settings

The settings for the payment terminal.

response

A callback that will be called with the result of the initialisation.

notification

Optional. A callback that will be called for different events.