KnotError
object which provides an enumerated value to debug with.
CardOnFileSwitcher.getInstance();
and Configuration(environment, clientId, sessionId);
are replaced with a more flexible KnotConfiguration
.
Product
enum values .card_switcher | .transaction_link
.
useCategories
, useSearch
, and merchantIds
.
open
action now requires a KnotConfiguration
and an optional KnotEventDelegate
which is now Knot.open(context, knotConfiguration, knotEventDelegate)
.
KnotEventDelegate
instead of closures.
onSuccess
, onError
, and onExit
are now explicit methods inside a delegate.
onEvent
method introduces the KnotEvent
object to better handle Knot emitted events.
KnotError
type provides improved error descriptions.
sendCard
parameter is deprecated and its functionality incorporated into the metaData
dictionary within KnotEvent
when KnotEvent.event
equals AUTHENTICATED
.
sendCard
method, as it is rarely applicable to the integration with the Knot SDK.sendCard
parameter has been deprecated and its functionality is incorporated into the metaData
object within KnotEvent
when the KnotEvent.event
equals AUTHENTICATED
. This change enhances flexibility by allowing additional contextual data to be included in events without requiring separate parameters. Previously, sendCard
was accessed as a standalone value, but now developers can retrieve it from the metaData
object in the event callback. This approach ensures better extensibility and consistency across different event types. To access the sendCard
value, simply extract it from the event’s metaData
object.
Event Name Prior to 2.0 | 2.0 Event Name |
---|---|
refresh session request | REFRESH_SESSION_REQUEST |
merchant clicked | MERCHANT_CLICKED |
login started | LOGIN_STARTED |
authenticated | AUTHENTICATED |
otp required | OTP_REQUIRED |
security questions required | SECURITY_QUESTIONS_REQUIRED |
approval required | APPROVAL_REQUIRED |
KnotError
enum.
errorDescription
) and a unique error code (errorCode
).
Error Case | Description |
---|---|
INVALID_SESSION | The session is invalid. |
EXPIRED_SESSION | The session has expired. |
INVALID_CLIENT_ID | The client ID is invalid. |
INTERNAL_ERROR | An internal error occurred. |
close
method, as it is infrequently applicable to the integration with the Knot SDK.Knot.close()
as opposed to being bound to the session object.