From 0f0abb68fa2013429df4196f7d1c85594eb22f65 Mon Sep 17 00:00:00 2001 From: Duncan Crawbuck Date: Mon, 13 Apr 2026 15:29:34 -0700 Subject: [PATCH] Make web checkout root canonical --- .../guides/migrating-from-revenuecat-to-superwall.mdx | 2 +- content/docs/dashboard/index.mdx | 2 +- .../web-checkout-revenue-tracking-is-automatic.mdx | 2 +- .../docs/using-referral-or-promo-codes-with-superwall.mdx | 2 +- .../web-checkout/{web-checkout-overview.mdx => index.mdx} | 7 +++---- content/docs/web-checkout/meta.json | 4 ++-- .../web-checkout/web-checkout-direct-stripe-checkout.mdx | 2 +- content/shared/in-app-paywall-previews.mdx | 6 +++--- content/shared/web-checkout/index.mdx | 2 +- redirects-map.ts | 5 ++--- 10 files changed, 16 insertions(+), 18 deletions(-) rename content/docs/web-checkout/{web-checkout-overview.mdx => index.mdx} (96%) diff --git a/content/docs/dashboard/guides/migrating-from-revenuecat-to-superwall.mdx b/content/docs/dashboard/guides/migrating-from-revenuecat-to-superwall.mdx index 37dc4173..21d7cbee 100644 --- a/content/docs/dashboard/guides/migrating-from-revenuecat-to-superwall.mdx +++ b/content/docs/dashboard/guides/migrating-from-revenuecat-to-superwall.mdx @@ -74,7 +74,7 @@ If you're using RevenueCat today just with [observer mode](/sdk/guides/using-rev 2. **Purchases:** Superwall uses the relevant app storefront (App Store or Google Play) to check for a source of truth for purchases. This is tied to the account logged into the device. For example, if a user is logged into the same Apple ID across an iPad, Mac and iPhone — any subscription they buy in-app will work on all of those devices too. RevenueCat uses a similar approach, so there typically isn't much you need to do. If any subscription status issues arise, typically restoring the user's purchases puts things into place. - Even if you're using [web checkout](/web-checkout/web-checkout-overview) with either platform, Superwall allows you to manually assign a subscription state to a user via [a `PurchaseController`](/sdk/guides/advanced-configuration). + Even if you're using [web checkout](/web-checkout) with either platform, Superwall allows you to manually assign a subscription state to a user via [a `PurchaseController`](/sdk/guides/advanced-configuration). 3. **Platform differences:** Like all products, Superwall and RevenueCat bring different features to the table, even though there are a lot of similarities. While both offer subscription SDKs, paywalls, and analytics - it helps to familiarize yourself with how Superwall is different. Superwall works on the foundations of registering placements and filtering users who activate them into audiences. Superwall groups those concepts together into [campaigns](/dashboard/dashboard-campaigns/campaigns). This means that you're ready from day one to run all sorts of price tests, paywall experiments, and more. diff --git a/content/docs/dashboard/index.mdx b/content/docs/dashboard/index.mdx index eeb41fec..990e7209 100644 --- a/content/docs/dashboard/index.mdx +++ b/content/docs/dashboard/index.mdx @@ -13,7 +13,7 @@ description: "Welcome to the Superwall Dashboard documentation" Learn to setup and use Campaigns - + Integrate Web Checkout with your app diff --git a/content/docs/support/web-checkout/web-checkout-revenue-tracking-is-automatic.mdx b/content/docs/support/web-checkout/web-checkout-revenue-tracking-is-automatic.mdx index d667eff6..69761738 100644 --- a/content/docs/support/web-checkout/web-checkout-revenue-tracking-is-automatic.mdx +++ b/content/docs/support/web-checkout/web-checkout-revenue-tracking-is-automatic.mdx @@ -42,4 +42,4 @@ If you have completed purchases in Stripe but no conversions showing in Superwal - [Stripe Setup](/web-checkout/web-checkout-configuring-stripe-keys-and-settings) - [Revenue Tracking for iOS and Android](/dashboard/dashboard-settings/overview-settings-revenue-tracking) -- [Web Checkout Overview](/web-checkout/web-checkout-overview) +- [Web Checkout Overview](/web-checkout) diff --git a/content/docs/using-referral-or-promo-codes-with-superwall.mdx b/content/docs/using-referral-or-promo-codes-with-superwall.mdx index 99f46933..5ab8e550 100644 --- a/content/docs/using-referral-or-promo-codes-with-superwall.mdx +++ b/content/docs/using-referral-or-promo-codes-with-superwall.mdx @@ -6,7 +6,7 @@ description: "Learn how to use referral or promo codes with Superwall." There are two primary ways to use referral codes or promo codes with Superwall: 1. **Using Superwall's Mobile SDKs**: By using [custom actions](/sdk/guides/advanced/custom-paywall-actions) along with a [campaign](/dashboard/dashboard-campaigns/campaigns) for referrals, you can create a flow to handle referral codes and see their resulting conversions and other data. You create the products that each referral should unlock within the respective app storefront. -2. **Web Checkout**: Here, you can use Superwall's [web checkout](/web-checkout/web-checkout-overview) feature to easily offer referrals. With this approach, you could create a [checkout link](/web-checkout/web-checkout-creating-campaigns-to-show-paywalls) for each referral you need. Unlike the previous option, you create the [products in Stripe](/web-checkout/web-checkout-adding-a-stripe-product). +2. **Web Checkout**: Here, you can use Superwall's [web checkout](/web-checkout) feature to easily offer referrals. With this approach, you could create a [checkout link](/web-checkout/web-checkout-creating-campaigns-to-show-paywalls) for each referral you need. Unlike the previous option, you create the [products in Stripe](/web-checkout/web-checkout-adding-a-stripe-product). ### Understanding Superwall's role Before you continue, it's critical to understand Superwall's role in this process. Most referral flows usually call for two things: diff --git a/content/docs/web-checkout/web-checkout-overview.mdx b/content/docs/web-checkout/index.mdx similarity index 96% rename from content/docs/web-checkout/web-checkout-overview.mdx rename to content/docs/web-checkout/index.mdx index d2361791..4074e942 100644 --- a/content/docs/web-checkout/web-checkout-overview.mdx +++ b/content/docs/web-checkout/index.mdx @@ -21,7 +21,7 @@ The core difference? Each placement becomes a unique URL that you can share, sen ## Overall flow -Refer to the individual pages below to get started, but for a quick, high-level overview — here's how web checkout works from beginning to end: +Refer to the individual pages below to get started, but for a quick, high-level overview - here's how web checkout works from beginning to end: 1. A Web Checkout app is added to an existing iOS project in Superwall. 2. Your checkout provider is configured with Superwall. @@ -34,7 +34,7 @@ Refer to the individual pages below to get started, but for a quick, high-level - **Redirect mode**: User is redirected to your custom URL with purchase data 8. For Redeem mode: _On the device that they downloaded the app_, they click the redemption link. 9. Your iOS app is opened via a deep link (which means it must be set up with Superwall deep links, [docs here](/sdk/quickstart/in-app-paywall-previews)). -10. In the `SuperwallDelegate`, `willRedeemLink()` is called, and then once it's fetched — `didRedeemLink(result:)` is called with the result of the redemption. +10. In the `SuperwallDelegate`, `willRedeemLink()` is called, and then once it's fetched - `didRedeemLink(result:)` is called with the result of the redemption. 11. Finally, this user's account and details are managed via a link they find in their [email receipt or by visiting a URL manually](/web-checkout/web-checkout-managing-memberships). ## Getting setup @@ -58,10 +58,9 @@ Before you start, you'll need to have a Superwall account and a Stripe account. 7. **[Testing purchases](/web-checkout/web-checkout-testing-purchases):** Test your web checkout flow with test purchases. -### App to Web +### App to Web 8. **[App to Web Checkout](/web-checkout/web-checkout-direct-stripe-checkout):** For customers in the United States, you can offer Stripe products directly from your iOS paywalls. - ## Troubleshooting If a user has issues accessing their subscription in your app after paying via web checkout, direct them to your plan management page to retrieve their subscription link or manage billing. For example: `http://yourapp.superwall.app/manage` diff --git a/content/docs/web-checkout/meta.json b/content/docs/web-checkout/meta.json index 5e16c61a..6ddf6de0 100644 --- a/content/docs/web-checkout/meta.json +++ b/content/docs/web-checkout/meta.json @@ -3,7 +3,7 @@ "icon": "ShoppingBag", "root": true, "pages": [ - "web-checkout-overview", + "index", "---Getting Started---", "web-checkout-creating-an-app", @@ -21,4 +21,4 @@ "web-checkout-faq", "web-checkout-web-only" ] -} \ No newline at end of file +} diff --git a/content/docs/web-checkout/web-checkout-direct-stripe-checkout.mdx b/content/docs/web-checkout/web-checkout-direct-stripe-checkout.mdx index a7d84687..f7b3de96 100644 --- a/content/docs/web-checkout/web-checkout-direct-stripe-checkout.mdx +++ b/content/docs/web-checkout/web-checkout-direct-stripe-checkout.mdx @@ -9,7 +9,7 @@ For customers in the United States, you can offer Stripe products directly from - First, follow the [web checkout setup guide](/web-checkout/web-checkout-overview#getting-setup) to create a Stripe app and configure your web checkout settings. Specifically, you'll need to complete the first three steps. This includes installing the [Superwall Stripe app](https://marketplace.stripe.com/apps/superwall) and setting up your app's settings. + First, follow the [web checkout setup guide](/web-checkout#getting-setup) to create a Stripe app and configure your web checkout settings. Specifically, you'll need to complete the first three steps. This includes installing the [Superwall Stripe app](https://marketplace.stripe.com/apps/superwall) and setting up your app's settings. Select a paywall and add a Stripe product to it. This will allow users to purchase the product directly from the paywall. Stripe products are prepended with "stripe" in the product selector: diff --git a/content/shared/in-app-paywall-previews.mdx b/content/shared/in-app-paywall-previews.mdx index 7c938b02..ea9ff68f 100644 --- a/content/shared/in-app-paywall-previews.mdx +++ b/content/shared/in-app-paywall-previews.mdx @@ -115,7 +115,7 @@ This configuration allows your app to open in response to a deep link with the f :::ios ### Adding a Universal Link -Only required for [Web Checkout](/web-checkout/web-checkout-overview), otherwise you can skip this step. +Only required for [Web Checkout](/web-checkout), otherwise you can skip this step. Before configuring in your app, first [create](/web-checkout/web-checkout-creating-an-app) and [configure](/web-checkout/web-checkout-configuring-stripe-keys-and-settings) your Stripe app on the Superwall Dashboard. @@ -146,7 +146,7 @@ You can verify that your universal links are working a few different ways. Keep :::flutter ### Adding a Universal Link (iOS only) -Only required for [Web Checkout](/web-checkout/web-checkout-overview), otherwise you can skip this step. +Only required for [Web Checkout](/web-checkout), otherwise you can skip this step. Before configuring in your app, first [create](/web-checkout/web-checkout-creating-an-app) and [configure](/web-checkout/web-checkout-configuring-stripe-keys-and-settings) your Stripe app on the Superwall Dashboard. @@ -177,7 +177,7 @@ You can verify that your universal links are working a few different ways. Keep :::expo ### Adding a Universal Link (iOS only) -Only required for [Web Checkout](/web-checkout/web-checkout-overview), otherwise you can skip this step. +Only required for [Web Checkout](/web-checkout), otherwise you can skip this step. Before configuring in your app, first [create](/web-checkout/web-checkout-creating-an-app) and [configure](/web-checkout/web-checkout-configuring-stripe-keys-and-settings) your Stripe app on the Superwall Dashboard. diff --git a/content/shared/web-checkout/index.mdx b/content/shared/web-checkout/index.mdx index f91732c6..66460a7c 100644 --- a/content/shared/web-checkout/index.mdx +++ b/content/shared/web-checkout/index.mdx @@ -4,7 +4,7 @@ description: "Integrate Web Checkout into your app with the Superwall SDK" --- ## Dashboard Setup -1. [Set up Web Checkout in the dashboard](/web-checkout/web-checkout-overview) +1. [Set up Web Checkout in the dashboard](/web-checkout) 2. [Add web products to your paywall](/web-checkout/web-checkout-direct-stripe-checkout) ## SDK Setup diff --git a/redirects-map.ts b/redirects-map.ts index 6432f799..7e645252 100644 --- a/redirects-map.ts +++ b/redirects-map.ts @@ -145,8 +145,7 @@ export const fileRedirectsMap = { "using-stripe-bottom-sheet-checkout-in-app": "dashboard/guides/using-stripe-checkout-in-app", // Dashboard / Web Checkout - "web-checkout": "dashboard/web-checkout/web-checkout-overview", - "web-checkout-overview": "dashboard/web-checkout/web-checkout-overview", + "web-checkout-overview": "web-checkout", "web-checkout-creating-an-app": "dashboard/web-checkout/web-checkout-creating-an-app", "web-checkout-configuring-stripe-keys-and-settings": "dashboard/web-checkout/web-checkout-configuring-stripe-keys-and-settings", "web-checkout-adding-a-stripe-product": "dashboard/web-checkout/web-checkout-adding-a-stripe-product", @@ -406,7 +405,7 @@ export const fileRedirectsMap = { "using-the-superwall-delegate": "sdk/guides/using-superwall-delegate", // Web Checkout redirects (moved from dashboard to top-level) - "dashboard/web-checkout/web-checkout-overview": "web-checkout/web-checkout-overview", + "dashboard/web-checkout/web-checkout-overview": "web-checkout", "dashboard/web-checkout/web-checkout-creating-an-app": "web-checkout/web-checkout-creating-an-app", "dashboard/web-checkout/web-checkout-configuring-stripe-keys-and-settings": "web-checkout/web-checkout-configuring-stripe-keys-and-settings", "dashboard/web-checkout/web-checkout-paddle-setup": "web-checkout/web-checkout-paddle-setup",