Passkey Feature

Passkey is a passwordless login feature for Mercuryo users. Instead of entering a password or email code, users confirm sign-in using Face ID, fingerprint, PIN, or a hardware key on their device.


Technical Limitations

  • Not supported in Safari on iPhones, iPads, or Mac.
  • Not available in WebView — WebView does not implement the required passkey browser APIs.
  • Not triggered for partner silent sign-in — passkey is only used when users log in directly via the Mercuryo widget login form.

End-User Flow

  1. After the feature is enabled on the Mercuryo side, the user must first log in using one of:

    • Email verification code
    • Email code + password (if a password was set)
  2. After login, the user is prompted to set up a Passkey. They can skip this step; if skipped, they'll be prompted again on subsequent logins.

  3. Once a Passkey is set, the user can use it instead of the email verification code on future logins. The email code remains available as a fallback.

  4. If the user uses non-cloud key storage (e.g., a local device), they must set up the Passkey on each device they use.

  5. If a user uses 1Password for passkeys and switches devices, they must add a new passkey on the new device. After that, the same 1Password entry works across devices.


User Management

  • Each user can have up to 10 passkeys set.
  • Passkeys are managed via the widget menu: users can rename keys, add new ones, or remove unused ones.