Troubleshoot Passwordless Login

Review these troubleshooting steps for issues with the Shopper Login and API Access Service (SLAS) passwordless login and email verification features.

Potential causes:

  • You haven’t configured the sender email in SLAS.
  • You haven’t verified the sender email address.
  • You haven’t set the password action email template in SLAS.

Suggested solution: Verify your SLAS email configuration. See Passwordless Login with Email.

Potential cause: The callbackUri isn’t allowlisted in the SLAS client, or the callback endpoint can’t be reached.

Suggested solution: Confirm that the callbackUri in config.server.ts exactly matches an allowlisted URL in the SLAS client. Don’t use wildcards—the full URL including protocol must match. Verify that your callback endpoint is publicly accessible and returns a successful response.

Potential cause: The auth.otpLength value in config.server.ts doesn’t match the one-time password (OTP) length configured in your SLAS client. SLAS generates the token at the length set in the client, so a mismatch causes the storefront to expect a different length than what the shopper receives.

Suggested solution: Make sure that auth.otpLength in config.server.ts matches the OTP length set in your SLAS private client configuration. Valid values are 6 and 8. See Configure a SLAS Private Client.

Potential cause: Your site doesn’t have the Enable Email Verification site preference turned on, so the registration page renders the standard password form.

Suggested solution: In Business Manager, go to Merchant Tools > Site Preferences > Storefront Login Preferences and turn on Enable Email Verification. Wait up to 5 minutes for changes to reflect in your storefront. When you turn on this preference, passwordless registration becomes the default mode.

Potential cause: Your site doesn’t have the Enable Email Verification site preference turned on, or the preference change hasn’t propagated yet.

Suggested solution: In Business Manager, go to Merchant Tools > Site Preferences > Storefront Login Preferences and turn on Enable Email Verification. Wait up to 5 minutes for the changes to reflect in your storefront.

Potential cause: Your site doesn’t have the Enable Loginid Updates for SCAPI feature switch turned on. When this feature is turned off, the B2C Commerce API (SCAPI) accepts email updates but doesn’t sync the change to the shopper’s login ID, causing a mismatch between the display email and the credentials used to log in.

Suggested solution: Contact support to enable the Enable Loginid Updates for SCAPI feature switch.