OS Browser Value Use Case

Overview

The IN_APP_OS_BROWSER value is set in the provider configuration to handle specific browser interactions on Android and iOS devices.

Functionality

• Android : Opens the OS browser.

• iOS: Opens a Safari instance (ASWebAuthenticationSession via react-native-inappbrowser) which listens to the callback URL to continue the regular Ramp flow.

Callback URL

• The callback URL in this case will be a deeplink with the metamask:// schema.

Requirements

1. Pre-created Orders:

   • customOrderId pre-created orders must be used: Since the user may leave the MetaMask app and not return, or the redirection may not be handled, pre-created orders are necessary to retrieve the order.

2. Deeplink Format:

   • The provider's widget must support the metamask:// deeplink format as the callback URL.

3. External Application Integration:

   • TProviders are allowed to open external applications using their own deeplink/universal links from their widget URL.
   • It is required to call the redirect URL (with the deeplink format) at the end of the interaction, whether it was directly on the widget or using an external app.