MassSwitcher is currently in beta.

​
Overview

Knot’s MassSwitcher feature enables users to login to their Google Account, identify their merchant accounts, and subsequently update their card across many merchants in a more seamless manner. If you would like to enable the MassSwitcher feature, let the Knot team know.

​
Integration Steps

​
Webhooks

​
AUTHENTICATED

Handle the send_card property in the AUTHENTICATED event when determining whether to send card information to Knot based on the event. When users login to their Google Account and you receive this event, the event will include send_card = false, so you know not to send any card information. Your integration should send card information when a user subsequently chooses merchants where they’d like to update their card. Once the merchants are chosen, you will receive an AUTHENTICATED webhook for each merchant with send_card = true.

​
ACCOUNTS_RETRIEVED (Optional)

Handle the ACCOUNTS_RETRIEVED webhook to know when a user’s merchant accounts are retrieved from their Google Account (if any exist).

​
Entrypoint (Optional)

If you retrieve and list merchants in your native app, you should design and implement an entry point for the MassSwitcher feature, encouraging users to update their card at many merchants simultaneously. This entry point should invoke the SDK with the merchant Id you receive for the Google Keychain merchant when calling List Merchants. Doing so will send the user directly to the flow for the MassSwitcher feature.

​
Testing & Launch

To test the MassSwitcher feature, you can invoke the SDK in the development environment, click on the feature’s entry point from the home screen, and proceed to login to a Google Account with test credentials here. Once you’re ready to turn on the feature, just let the Knot team know.