Once you’ve created a Stripe app, you’ll need to configure it with your Stripe keys and fill in a few settings. This is a one-time setup that connects Superwall to Stripe. The easiest way to get started is to click on the link in your overview page, which will take you to your app’s Settings page:

​
Application settings

Fill out metadata about your iOS app in this section.

  1. Icon: An icon to represent your app, we recommend using the same one that your iOS app does. This will appear on the checkout and subscription management pages.

  2. Web Paywall Domain: The domain your paywalls will be shown from. This was set when the Stripe app was created, and cannot be changed.

  3. Application Name: The name of your app, we recommend using the same name as your iOS app.

  4. Support URL: A URL to your support page. This will be shown on the checkout and subscription management pages.

  5. Support Email: An email you provide customers for support questions and general reach out

  6. Redeemable on Desktop: If your app is an iPad app on Mac, enable this option so that users can redeem products on their Mac. If you aren’t using iPads Apps on the Mac, you can disable this. If this is disabled, Superwall enforces redemption on an iOS device.

Once you’ve filled out this information, click on the Update Application button.

​
Stripe Live Configuration

This section allows you to connect Stripe keys with Superwall. You will need:

  1. Publishable Key: A Stripe publishable key. Stripe creates this key for you, you don’t need to generate it yourself.
  2. Secret Key: A Stripe secret key that you create. Once you’ve made one, paste it here.

To access these, click on the API Keys link:

Under Restricted Keys, click on + Create restricted key:

Choose “Providing this key to another website” and click Continue ->:

Use “Superwall” as the name and “superwall.com” as the URL, then click Create restricted key:

You’ll get a modal of your restricted key, copy this to your clipboard, you won’t be able to view it again:

From there, copy your Publishable Key and copied key from the Stripe dashboard to Superwall:

Once you’ve provided those two keys, click on Update Configuration to save your changes. This section should say “Configured” at the top right if setup was successful:

​
Stripe Sandbox Configuration

For the sandbox configuration, you’ll follow the same previous steps, except you retrieve the keys from this link: Stripe Sandbox API Keys.

You should see something similar to this:

Paste the both the Publishable Key and Secret Key into Superwall for each respective field and click on the Update Configuration button. As before, this section should say “Configured” at the top right if setup was successful.

​
iOS configuration

Next, fill in your custom URL scheme and iOS app ID. This information is required. If you’re unsure of your app’s ID, you find it in App Store Connect -> Select your App -> General -> App Information -> Apple ID:

​
Confirm setup

Once you’ve filled out all of these fields, you should see Configured for each section:

Next, you’ll need to create some products in Stripe.