Offer Codes, Promo Codes and Discounts
What Superwall supports for App Store offer codes, promotional and win-back offers, Google Play offers and promo codes, and Stripe discount codes on paywalls.
Stores and payment providers each have their own kind of discount code. Superwall supports some of them fully, tracks others, and can't apply some at all. This page says which is which, so you can pick the right approach before you build a promotion.
At a glance
| Discount | Apply it from a paywall | What Superwall does |
|---|---|---|
| Stripe promotion codes | Yes | A paywall's Apply Discount action validates the code and checks out at the discounted price. |
| App Store introductory offers | Yes | Shown and applied automatically. On iOS you can also override who's eligible. |
| Google Play offers | Yes | Pick a specific offer, or let Superwall pick the best one, per product. |
| App Store offer codes | No | Purchases made with an offer code are tracked and labeled as offer codes. |
| App Store promotional offers | No | Tracked. Superwall can offer them on Apple's cancellation sheet with Apple Retention Messaging. |
| App Store win-back offers | No | Tracked and labeled as win-back. |
| Google Play promo codes | No | Purchases made with a promo code are acknowledged so Google doesn't refund them. |
| Your own referral or promo codes | Yes, with your app | Your app validates the code, and Superwall shows the paywall with the discounted product. |
Stripe promotion codes
For paywalls that sell Stripe products through Web Checkout, add a text input and a button with the Apply Discount tap behavior. Superwall checks the code with Stripe, and if it's valid, re-prices the paywall's products and applies the code when the user checks out. Variables such as discountedPrice and hasDiscount let the paywall show the new price.
- It works with the promotion codes you create in Stripe. You don't need separate discounted products.
- It applies to Stripe products only. The action is offered on paywalls for Stripe and web apps.
- The code is applied in redirect, embedded and elements checkout, and with Apple Pay.
- Stripe's own promotion code field isn't shown on Superwall's hosted checkout, and a link can't fill in a code. Users enter it on the paywall.
See Discount Codes for the setup.
App Store introductory offers
Introductory offers, such as a free trial or a discounted first period, are set up on the product in App Store Connect. Superwall shows them to eligible users and the App Store applies them at purchase. On iOS, you can also offer them to users who've already had one, or hide them, per paywall. See Free Trials and Introductory Offers and Overriding Introductory Offer Eligibility.
Google Play offers
Each Google Play product in Superwall can use a specific offer on a base plan, let Superwall pick the best offer the user is eligible for, or use no offer. Superwall passes the chosen offer to Google Play at purchase. See Google Play Offers.
App Store offer codes
A paywall can't redeem an App Store offer code, and the SDK doesn't open Apple's offer code redemption sheet. Users redeem offer codes in the App Store, or in your app if you show Apple's redemption sheet yourself.
When a user subscribes with an offer code, Superwall still tracks it:
- On iOS 17.2 and later, the SDK reports the subscription's offer type as
codeinSubscriptionTransaction.offerType(iOS SDK 4.11.0 and later). See SubscriptionTransaction. - Webhooks include Apple's offer identifier in
offerCode. It holds whatever identifier Apple reports for the offer, and doesn't say which kind of offer it was.
App Store promotional offers
Superwall can't apply a promotional offer to a purchase from a paywall, and promotional offers aren't available as paywall product variables. Subscriptions bought with one are tracked with the offer type promotional.
Apple Retention Messaging is the exception: Superwall can offer a promotional offer on Apple's subscription cancellation sheet, and signs it for you.
If you use a purchase controller, your code makes the purchase, so it can apply a promotional offer itself.
App Store win-back offers
Superwall can't show or apply a win-back offer from a paywall. When a user resubscribes with one, the SDK reports the offer type as winback.
Google Play promo codes
A paywall can't redeem a Google Play promo code. Users redeem them in Google Play. Since Android SDK 2.8.5, the SDK acknowledges any purchase it finds unacknowledged, including ones made with a Play Store promo code, so Google doesn't refund them automatically.
Your own referral or promo codes
For codes your own system issues, such as referral or influencer codes, your app validates the code and Superwall shows the right paywall:
- Collect the code on the paywall. Add a text input, and a button with a Custom Callback action that sends the input's value to your app. Your app validates it and returns success or failure, and the paywall branches on the result. Custom callbacks need iOS SDK 4.12.10 or Android SDK 2.7.0 or later. See Custom callbacks.
- Show the discount. When the code is valid, register a placement for a campaign whose paywall has the discounted product. The discounted product has to exist in App Store Connect or Google Play.
For a full walkthrough, see Using Referral or Promo Codes with Superwall.
Related
How is this guide?