Payment Passkeys troubleshooting

Resolve passkey registration failures

Use this guide when passkey registration or authentication fails on Android.

The D1 SDK opens passkey flows in Android Custom Tabs. The device selects the browser and passkey provider.

The D1 SDK recommend Google Chrome for Android passkey registration.

Try these steps first

Ask the end user to complete these checks, then retry the passkey operation.

1

Check the passkey provider

Google Password Manager provides the best compatibility.

1. Open Settings on the Android device.

2. Search for Passwords, Passkeys & Autofill. The name can vary by device.

3. Open Preferred service or Password Manager.

4. Check the selected passkey provider.

5. Select Google Password Manager, if it is available.

2

Set Google Chrome as the default browser

Google Chrome is used during D1 SDK validation and testing.

1. Open Settings.

2. Select Apps or Applications.

3. Select Default apps, then Browser app.

4. Select Chrome.

3

Retry the passkey operation

Return to the issuer application. Retry passkey registration or authentication.

If the issue persists, collect the relevant logs and contact support.

Why browser settings matter

Browser capabilities and passkey implementations vary by vendor and version. Behavior can differ when another browser is the default.

The D1 SDK is validated with Google Chrome and Google Password Manager. Other browser and provider combinations can work, but are not validated.

Optional: detect the default browser

Use browser detection to support troubleshooting. Add Chrome to the <queries> element in your Android manifest:

<queries>
    <package android:name="com.android.chrome" />
</queries>

Then check the browser resolved for an HTTPS URL:

fun isChromeDefaultBrowser(context: Context): Boolean {
    val intent = Intent(
        Intent.ACTION_VIEW,
        Uri.parse("https://www.google.com")
    )

    val resolveInfo = context.packageManager.resolveActivity(
        intent,
        PackageManager.MATCH_DEFAULT_ONLY
    )

    return resolveInfo?.activityInfo?.packageName == "com.android.chrome"
}

For example, log when Chrome is not the default browser:

val isChromeDefault = isChromeDefaultBrowser(context)

if (!isChromeDefault) {
    Log.d("Passkey", "Chrome is not configured as the default browser.")
}