Skip to main content

Troubleshooting Passkey Issues on Kuda Business

How to fix most issues with Passkeys

Written by Nosa O

How to fix most issues with passkeys on Kuda Business.

Passkeys offer a secure and convenient way to sign in to your Kuda Business account without needing to remember complex passwords. By using your device's built-in authentication methods like Face ID, fingerprint, or a PIN, passkeys provide enhanced protection against phishing and unauthorized access.

Important: Passkeys are the only supported login method for Kuda Business after your first setup. Deactivating or deleting your passkey could leave you locked out, as there is no ongoing password fallback. If you lose access, contact Kuda Business support for identity verification and passkey reset.

Why autofill settings matter

Passkeys often appear through the same credential flow your phone uses for saved passwords (autofill). If autofill is disabled or assigned to the wrong provider, passkey prompts may not appear—even when iCloud Keychain or Google Password Manager is otherwise enabled.

See Why Passkeys Depend on Autofill Settings for platform paths (iPhone, Android, Samsung, Transsion) and the difference between device-level and browser-level settings.

Kuda Business on Android: we recommend Google Password Manager as your autofill provider. Kuda does not enforce this, but if another manager (such as Samsung Pass) is default, it may not surface a passkey stored in Google.

Essential requirements

Before troubleshooting, confirm:

App and system

  • Kuda Business app updated from your app store

  • iOS: 16 or later (latest recommended)

  • Android: 9 or later (latest recommended)

  • Desktop: Windows 10/11 with Windows Hello, or macOS Ventura or later

  • Screen lock enabled (PIN, pattern, fingerprint, Face ID)

  • Stable internet connection

Autofill and credential storage

iPhone

  1. Settings > [Apple ID] > iCloud > Passwords and Keychain — Sync this iPhone ON

  2. Settings > Passwords > Password Options — AutoFill Passwords and Passkeys ON, iCloud Passwords & Keychain selected

Android (all brands, including Samsung and Transsion)

  1. Settings > System > Languages & input > Autofill service — we recommend Google

  • Samsung: Settings > General management > Passwords, passkeys and autofill

  1. Settings > Google > Autofill > Autofill with Google — ON

  2. Signed into the same Google Account used when the passkey was created

  3. Transsion / HiOS / XOS: if menus differ, search Settings for autofill, passwords, or password manager

Samsung devices: we recommend Google as the autofill provider when your passkey is in Google Password Manager. If Samsung Pass is default, try switching to Google or ensure your passkey is stored in the manager that is default.

Web sign-in: use a current browser (Chrome, Safari, Edge, Firefox). If sign-in fails only in one browser, check Chrome > Settings > Autofill services as well as device-level autofill.

Verify your passkey is stored

  • iOS: Settings > Passwords — look for Kuda Business

  • Android: Settings > Google > Manage your Google Account > Security > Password Manager — search for Kuda Business under passkeys

Common issues and solutions

Issue 1: Cannot complete passkey setup

Symptoms: Setup fails; messages like "enable iCloud Keychain" or "Google Password Manager required."

Steps:

  1. Confirm all essential requirements above, especially autofill provider (not just Keychain/Google account sign-in).

  2. iOS: enable iCloud Keychain sync and AutoFill Passwords and Passkeys (see above).

  3. Android: enable Autofill with Google and select Google as autofill service.

  4. Close Kuda Business completely, reopen, and choose Continue on this device.

  5. Restart the device if issues persist.

Issue 2: "No passkey found" error

Symptoms: Device says no passkey exists; cannot authenticate.

Steps:

  1. Check passkey storage (paths above).

  2. Confirm you are signed into the same Apple ID or Google Account used when the passkey was created.

  3. Use cross-device sign-in: scan the QR code with a device that still has the passkey; keep Bluetooth on and devices close.

  4. On a new device without the old phone: complete Kuda's identity verification so support can reset your passkey, then sign in and create a new one.

  5. Samsung: if passkeys still fail, try Google as the autofill provider (recommended) or confirm the passkey is stored in whichever manager is default.

  6. Update the app, OS, and browser.

Issue 3: QR code appears during login

Note: This is normal on a new device that does not have a local passkey yet.

  1. Scan the QR code with the device that has your Kuda passkey.

  2. Or tap Try another way if QR scanning is not possible.

  3. After signing in, create a passkey on the new device for future use.

Issue 4: Security key prompt (unwanted)

  1. Tap Try another way, Use a passkey from a different device, or Cancel.

  2. Ensure Face ID, Touch ID, fingerprint, or Windows Hello is configured.

Issue 5: Cannot create passkey

  1. Verify OS version, app version, screen lock, and autofill provider.

  2. Update Kuda Business, your OS, and browser (for web).

  3. On Android, delete stale Kuda entries in Google Password Manager, toggle Autofill with Google off/on, restart, and retry.

Issue 6: Passkey not available on another device

Kuda Business uses a single active device session—signing in on a new phone signs you out of the previous one. Passkeys sync only within the same Apple or Google account ecosystem.

  1. Use the same Apple ID (iPhone/iPad/Mac) or same Google Account (Android) on both devices.

  2. Confirm iCloud Keychain or Google Password Manager sync is ON.

  3. Use QR cross-device sign-in from the device that still has the passkey, or contact support for reset if the old device is lost.

  4. After login on the new device: More > Security > Passkeys to manage credentials.

Do not rely on having passkeys active on multiple phones at once for everyday login—use QR or reset when switching devices.

Issue 7: iCloud Keychain problems (iOS)

  1. Settings > [Apple ID] > iCloud > Passwords and Keychain — Sync this iPhone ON

  2. Same Apple ID on all devices; two-factor authentication enabled for Apple ID

  3. Settings > Passwords > Password Options — autofill enabled (see above)

Issue 8: Biometric authentication failing

  1. Clean fingerprint sensor / camera; use device PIN as fallback

  2. Restart the device

  3. Confirm Kuda Business can use biometrics in app permissions

Account recovery and passkey reset

If you deleted your passkey or cannot sign in, contact Kuda Business support. You will need identity verification before a passkey reset. After approval:

  1. Sign out completely

  2. Sign in again and create a new passkey

  3. Confirm it appears in iCloud Keychain or Google Password Manager

When to request reset: lost or stolen device, new phone without old device, switched Apple/Google account, repeated authentication failures after correct autofill setup.

Advanced troubleshooting

Corrupted passkey

  1. Remove stale Kuda Business passkeys from iCloud Keychain or Google Password Manager

  2. After support reset (if needed), create exactly one new passkey and test login immediately

Browser-only issues

If the app works but web login fails (or vice versa), check device autofill and browser autofill separately (see Why Passkeys Depend on Autofill Settings).

Unsupported devices

Passkeys are required for Kuda Business on supported devices (see Supported Devices and Requirements). A one-time password is only available before your first passkey is created—not as ongoing login. Contact support if your device cannot support passkeys.

Contacting support

Include:

  • Device model and OS version

  • Kuda Business app version

  • Clear description and error messages

  • Screenshots or a short screen recording

  • Autofill provider (Google / iCloud) and whether the passkey appears in device password settings

Best practices

  • Keep app, OS, and browsers updated

  • Use one Apple ID or Google Account consistently on each phone

  • Enable autofill for passkeys (Google on Android, iCloud on iPhone)

  • Use QR cross-device sign-in when switching phones; contact support if the old device is gone

  • Contact support immediately if your device is lost or stolen

---

Note: Passkeys are mandatory for Kuda Business. Maintain your passkey and autofill settings to avoid access issues.

Related articles

Related Articles
Did this answer your question?