BrowserSwitchClient

Construct a client that manages browser switching with Chrome Custom Tabs fallback only. This constructor does not initialize Auth Tab support. For Auth Tab functionality, use BrowserSwitchClient instead.

Construct a client that manages the logic for browser switching and automatically initializes the Auth Tab launcher.

IMPORTANT: This constructor enables the AuthTab functionality, which has several caveats:

• This constructor must be called in the activity/fragment's onCreate() method to properly register the activity result launcher before the activity/fragment is started.
• The caller must be an ActivityResultCaller to register for activity results.
• ACTIVITY_NEW_TASK is not supported when using AuthTab and will be ignored. Only ACTIVITY_CLEAR_TOP is supported with AuthTab.
• When using SingleTop activities, you must check for launcher results in onResume() as well as in onNewIntent(), since the AuthTab activity result might be delivered during the resuming phase.
• Care must be taken to avoid calling completeRequest multiple times for the same result. Merchants should properly track their pending request state to ensure the completeRequest method is only called once per browser switch session.
• AuthTab support is browser version dependent. It requires Chrome version 137 or higher on the user's device. On devices with older browser versions, the library will automatically fall back to Custom Tabs. This means that enabling AuthTab is not guaranteed to use the AuthTab flow if the user's browser version is too old.

Consider using the default constructor BrowserSwitchClient if these limitations are incompatible with your implementation.

Parameters