Merge branch 'release/RN-3.15' into develop

Author: eandreeva-twr

versioned_docs/version-3.0/react-native-web-paywall.md

@@ -10,6 +10,8 @@ displayed_sidebar: sdkreactnative
 Before you begin, make sure you have [configured your web paywall in the dashboard](web-paywall.md) and installed Adapty SDK version 3.6.1 or later.
 :::
 
+## Open web paywalls
+
 If you are working with a paywall you developed yourself, you need to handle web paywalls using the SDK method. The `.openWebPaywall` method:
 1. Generates a unique URL allowing Adapty to link a specific paywall shown to a particular user to the web page they are redirected to.
 2. Tracks when your users return to the app and then requests `.getProfile` at short intervals to determine whether the profile access rights have been updated.
@@ -40,3 +42,29 @@ There are two versions of the `openWebPaywall` method:
 | AdaptyError.productWithoutPurchaseUrl   | The product doesn't have a web purchase URL            | Verify the product configuration in the Adapty Dashboard                  |
 | AdaptyError.failedOpeningWebPaywallUrl  | Failed to open the URL in the browser                  | Check device settings or provide an alternative purchase method           |
 | AdaptyError.failedDecodingWebPaywallUrl | Failed to properly encode parameters in the URL        | Verify URL parameters are valid and properly formatted                    |
+
+## Open web paywalls in an in-app browser
+
+:::important
+Opening web paywalls in an in-app browser is supported starting from Adapty SDK v. 3.15.
+:::
+
+By default, web paywalls open in the external browser.
+
+To provide a seamless user experience, you can open web paywalls in an in-app browser. This displays the web purchase page within your application, allowing users to complete transactions without switching apps.
+
+To enable this, pass `WebPresentation.InAppBrowser` as the second argument to `openWebPaywall`:
+
+```typescript showLineNumbers title="React Native (TSX)"
+import { adapty, WebPresentation } from 'react-native-adapty';
+
+try {
+    await adapty.openWebPaywall(
+        product,
+        WebPresentation.BrowserInApp, // default – WebPresentation.BrowserOutApp
+    );
+} catch (error) {
+    console.warn('Failed to open web paywall:', error);
+}
+
+```