Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
Expand Up @@ -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.

Expand Down
2 changes: 1 addition & 1 deletion content/docs/dashboard/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@ description: "Welcome to the Superwall Dashboard documentation"
<Card title="Campaigns" icon="PanelsTopLeft" href="/dashboard/dashboard-campaigns/campaigns">
Learn to setup and use Campaigns
</Card>
<Card title="Web Checkout" icon="Globe" href="/web-checkout/web-checkout-overview">
<Card title="Web Checkout" icon="Globe" href="/web-checkout">
Integrate Web Checkout with your app
</Card>
<Card title="SDK Docs" icon="PanelsTopLeft" href="/getting-started-with-our-sdks">
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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)
Original file line number Diff line number Diff line change
Expand Up @@ -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:
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Expand All @@ -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
Expand All @@ -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`
4 changes: 2 additions & 2 deletions content/docs/web-checkout/meta.json
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@
"icon": "ShoppingBag",
"root": true,
"pages": [
"web-checkout-overview",
"index",

"---Getting Started---",
"web-checkout-creating-an-app",
Expand All @@ -21,4 +21,4 @@
"web-checkout-faq",
"web-checkout-web-only"
]
}
}
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ For customers in the United States, you can offer Stripe products directly from

<Steps>
<Step title="Configure Web Checkout">
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.
</Step>
<Step title="Add a Stripe product to an iOS paywall">
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:
Expand Down
6 changes: 3 additions & 3 deletions content/shared/in-app-paywall-previews.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -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
<Note>
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.
</Note>

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.
Expand Down Expand Up @@ -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)
<Note>
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.
</Note>

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.
Expand Down Expand Up @@ -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)
<Note>
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.
</Note>

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.
Expand Down
2 changes: 1 addition & 1 deletion content/shared/web-checkout/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
5 changes: 2 additions & 3 deletions redirects-map.ts
Original file line number Diff line number Diff line change
Expand Up @@ -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",
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Missing redirect for old overview nested URL

High Severity

The file was renamed from web-checkout-overview.mdx to index.mdx, making the old URL /docs/web-checkout/web-checkout-overview a 404. Redirects exist for web-checkout-overview (bare slug) and dashboard/web-checkout/web-checkout-overview, but web-checkout/web-checkout-overview — the most recently canonical path — has no redirect entry. The changelog-entries.json also references this exact URL, so changelog links will break.

Additional Locations (1)
Fix in Cursor Fix in Web

Reviewed by Cursor Bugbot for commit 0f0abb6. Configure here.

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Add redirect for removed web checkout overview path

Renaming content/docs/web-checkout/web-checkout-overview.mdx to index.mdx removes the old route at /docs/web-checkout/web-checkout-overview, but this map now only redirects /docs/web-checkout-overview (no folder prefix). As a result, existing bookmarks/external links to the previous canonical page path will 404 instead of forwarding to /docs/web-checkout. Please add an explicit redirect for web-checkout/web-checkout-overview to preserve the old URL.

Useful? React with 👍 / 👎.

"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",
Expand Down Expand Up @@ -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",
Expand Down
Loading