Link store accounts to Bolt Accounts

Account Linking lets merchants tap into Bolt Shopper Accounts and link them with store accounts using the shopper’s email address.

Who this is for

Developers who have implemented Embeddable Checkout and want shoppers to check out with Bolt without logging into the store separately.

Shopper enters email on your storefront.
Bolt identifies whether a Bolt Account exists and prompts OTP login.
After authorization, Bolt returns an ID token via OAuth.
Your backend validates the email from the ID token against store accounts and logs the shopper in.

Step	Task
1	Exchange authorization code for ID token via OAuth token endpoint with `scope` including `openid`
2	Fetch Bolt’s RSA public key from `/.well-known/openid-configuration`
3	Parse the ID token to get the Bolt Account email
4	Match email to a store account and trigger store login

When you set up Bolt Accounts, require shoppers to input their email when logging into your store account.

For the full OAuth and JWT validation flow, see the Account Linking guide and access shopper data.