Edge Cases
Common scenarios and how to handle them.
Does the user need cellular data enabled?
ConnectivityNo. 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)?
DeviceOn 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?
DeviceeSIM works the same as physical SIM for authentication. The carrier authenticates the eSIM profile identically.
What if the user's carrier is not supported?
EligibilityThe 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?
SessionSessions 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)?
VerificationThe 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?
ConnectivitySince 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?
DeviceThe 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?
DesktopThe 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?
DesktopThe 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.