Quickstart
Introduction
Integrating Knot is quite simple. You’ll need a basic client-side and server-side integration, including calling the API, invoking the SDK, and subscribing to webhooks.
Start the Flow
Access your customer dashboad
Access your customer dashboad
Ensure you have access to your Customer Dashboard and retrieve your API keys: client_id
and secret
.
Call the API to create a session
Call the API to create a session
With your client_id
and secret
for the development
environment, call Create Session to create a session used when invoking the SDK.
Install the SDK
Install the SDK
Install and import an SDK of your choosing, for example on iOS here. If you are using the Web SDK, make sure to allowlist your application’s domains for the development
and production
environments in your Customer Dashboard.
Initialize the SDK
Initialize the SDK
Initialize the SDK with the session_id
retrieved from Create Session. The SDK is where users will interact with the Knot UI to authenticate to various merchants. All login flows, including step-up authentication, are handled with the SDK. Users will see real-time feedback as they progress through authenticating with a merchant.
Handle Events
Handle SDK callbacks
Handle SDK callbacks
Handle onSuccess
, onError
, onExit
, and onEvent
SDK callbacks to be notified of client-side events.
Subscribe to webhooks
Subscribe to webhooks
Subscribe to webhooks so your backend can be notified about user-generated events, as well as asynchronous processes.
If you fail to receive a webhook, you can call Get Merchant Accounts to determine whether a user previously attempted to switch their card with a given merchant. Pass type: card_switcher
in the request and capture the last_user_action
object.
Switch a Card
Switch a card
Switch a card
Post card information to Switch Card or Switch Card (JWE) within 15 seconds of receiving the AUTHENTICATED
webhook when send_card: true
, fired after a user authenticates to a merchant account. You can read more about sending card data to Knot here.