Edge Cases

Common scenarios and how to handle them.

Does the user need cellular data enabled?

Connectivity

No. The authentication is SIM-based, not network-based. It works over any internet connection including WiFi. The solution verifies through the physical SIM (or eSIM) on the device, so as long as the device has a SIM card and some form of internet connectivity, the flow will work.

What if the user has multiple SIM cards (dual-SIM)?

Device

On Android (TS.43), the Digital Credentials consent prompt lets the user choose which SIM to use for verification. On iOS, authentication works for both active SIMs on dual-SIM devices.

What happens with eSIM devices?

Device

eSIM works the same as physical SIM for authentication. The carrier authenticates the eSIM profile identically.

What if the user's carrier is not supported?

Eligibility

The backend returns a carrier eligibility error. Implement a fallback authentication method (e.g., SMS OTP) for unsupported carriers. You can also check eligibility upfront before starting the flow.

What happens if verification takes too long?

Session

Sessions have a timeout window. If exceeded, the session expires and the SDK returns a session error. Show a timeout message and offer to start over.

What if the phone number doesn't match (Verify flow)?

Verification

The backend returns a verification failure indicating the SIM phone number doesn't match the number provided. Show a clear message and let the user correct the number or switch to the Get Phone Number flow.

What if the user is roaming internationally?

Connectivity

Since the authentication is SIM-based and works over any internet connection, roaming does not affect the flow. The SIM is verified regardless of which network the device is connected to.

What happens if the app is backgrounded during verification?

Device

The verification continues in the background. Results are delivered when the app returns to foreground. Make sure your state management handles delayed responses gracefully.

What if the user scans the QR code with a device that has no carrier support?

Desktop

The mobile verification page or carrier flow will fail with an eligibility error. If using a mobile verification page, you can detect this early and show a message asking the user to use a supported device.

What happens if the desktop browser loses connection while waiting?

Desktop

The SDK handles reconnection and resumes polling when connectivity returns. If the session has already expired by then, start a new flow.

Encountered something not listed here?

Contact your Glide representative with the requestId and traceId from the error for faster resolution.