Migration Guides
Web Version 1.0+
Overview
To simplify your application logic and integration with the Knot JS SDK, Version 1.0 includes a number of breaking changes that may affect the way your integration works or behaves.
The new version includes a number of significant improvements:
- Enhanced speed and stability in loading merchant flows.
- More streamlined initialization of the SDK.
- Simplified event handling, more informative event messaging, and uniform naming conventions for easier debugging.
- Improved maintainability and foundations for new feature compatibility.
Breaking Changes
Configuring and opening the Knot SDK has changed significantly in JS Version 1.0 and requires some refactoring in order to initialize the SDK with a session. Errors are now encapsulated in a KnotError
object which provides an enumerated value to debug with.
Session Initialization
Changes
Knot.openCardOnFileSwitcher
is replaced with a more flexibleopen
.- The product type is now defined by
Product
values"card_switcher" | "transaction_link"
.
Before
JavaScript
After
Event Handling
Changes
- All events introduce a
product
argument to help distinguish events in your code.
Before
JavaScript
After
JavaScript
Was this page helpful?