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 (based on subsequent AUTHENTICATED webhooks) if a user subsequently chooses merchants where they'd like to update their card.

ACCOUNTS_RETRIEVED

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

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 initialize the SDK with the merchant Id you receive for the Google Keychain merchant when calling Get 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 development, 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 you're ready to go live!