RevenueCat abonnement instellen in je iOS-app

Waarom RevenueCat gebruiken in plaats van alleen StoreKit

Met StoreKit, het framework van Apple, kun je een abonnement verkopen zonder externe dienst. Maar als beginner zelf alle logica voor aankopen, herstel en het controleren van toegangsrechten schrijven, betekent veel code om te onderhouden. En randgevallen vergeet je makkelijk: een nieuw apparaat, een verlopen abonnement, een terugbetaling.

RevenueCat zit tussen App Store Connect en je app in: het leest je producten uit, beheert de actieve abonnementen en zorgt dat je die laag niet zelf hoeft te schrijven. Prijs en aanbiedingen regel je zelf via een dashboard, zonder je app bij elke wijziging opnieuw te publiceren.

Stap 1: maak je producten aan in App Store Connect

Voordat je aan RevenueCat begint, moeten de producten bij Apple bestaan. Maak in App Store Connect een abonnementsgroep aan, en daarna een of meer niveaus met hun looptijd, bijvoorbeeld maandelijks of jaarlijks, en hun prijs per regio. Vul ook voor elk niveau de teksten in die de gebruiker te zien krijgt: Apple vraagt daarom voordat het product door de review gaat.

Iets wat in deze fase vaak vergeten wordt: een product dat is aangemaakt, maar nooit samen met de bijbehorende versie is ingediend bij de eerste review van de app. Een product in afwachting dat nooit in een app-inzending zat, blijft onzichtbaar voor je gebruikers, ook al ziet RevenueCat het al.

Stap 2: koppel RevenueCat aan je app

In RevenueCat maak je een project aan en koppel je je App Store Connect API-sleutel, zodat RevenueCat je producten automatisch synchroniseert. Daarna definieer je "entitlements", oftewel toegangsrechten. Een entitlement staat voor wat het abonnement ontgrendelt, bijvoorbeeld volledige toegang tot de app, los van het exacte product dat het heeft geactiveerd.

Die tussenlaag is handig: als je later de opbouw van je aanbod verandert, bijvoorbeeld door een jaarabonnement toe te voegen, koppel je het nieuwe product gewoon aan hetzelfde entitlement. De code die in je app de toegang controleert, hoef je niet aan te raken.

In je app installeer je de RevenueCat SDK voor React Native in een Expo-project met een eigen plugin. De SDK biedt een eenvoudige functie om te checken of de huidige gebruiker een actief entitlement heeft.

Stap 3: bouw je paywall

De paywall is het scherm dat het aanbod laat zien en de aankoop start. RevenueCat biedt paywalls die je via het dashboard instelt en aanpast zonder de app opnieuw te publiceren. Je kunt ook je eigen paywall bouwen met de SDK als je het design volledig in de hand wilt hebben.

De plek is net zo belangrijk als het design. Een paywall die verschijnt voordat iemand de waarde van de app heeft gezien, converteert meestal slechter dan een paywall direct na een eerste geslaagde actie. De gids over paywallfouten op iOS voor beginners behandelt de meest voorkomende valkuilen in deze fase, verder dan alleen de technische koppeling.

Stap 4: test de aankoop, het herstel en het verlopen

Dit is de stap die het vaakst wordt afgeraffeld, terwijl Apple hem het grondigst controleert. Drie scenario's moeten werken voordat je indient:

De aankoop. Met een sandbox-testaccount moet de aankoop het entitlement meteen ontgrendelen, en je app moet op die verandering reageren zonder dat je de app opnieuw hoeft te starten.

Het herstel. Op een nieuw apparaat of na een herinstallatie, met hetzelfde Apple-account, moet een knop "Restore Purchases" het actieve abonnement terugvinden. Apple controleert deze flow standaard tijdens de review, en als hij ontbreekt of niet goed werkt, is dat een veelvoorkomende reden voor afwijzing op grond van guideline 3.1.1.

Het verlopen. In de sandbox-omgeving verlopen abonnementen binnen een paar minuten in plaats van na maanden. Zo kun je controleren of de toegang netjes wordt afgesloten als de periode voorbij is, zonder op een echte factureringscyclus te wachten.

Wat RevenueCat niet vervangt

RevenueCat regelt het aankoopmechanisme, niet of je productpagina en je paywall voldoen aan guideline 3.1.2. Het blijft jouw taak om het abonnement goed te beschrijven in je App Store-beschrijving, de exacte prijs en looptijd te vermelden en je gebruiksvoorwaarden in te vullen. De pagina abonnement of eenmalige aankoop op iOS helpt je het juiste model te kiezen, nog voordat je aan deze technische stap begint.

RevenueCat neemt bovendien een commissie op de omzet boven een bepaalde maandelijkse drempel, bovenop de commissie van Apple op abonnementen die in de app worden verkocht. Check de actuele tarieven op hun eigen site voordat je je verdienmodel rond die twee commissies opbouwt.

De meest voorkomende beginnersfouten

De laadstatus vergeten. Bij het opstarten heeft RevenueCat even tijd nodig om de toegangsrechten van de gebruiker op te halen. Als je app standaard de betaalde content toont voordat dat antwoord binnen is, kan een gebruiker zonder abonnement heel even content zien waarvoor hij niet heeft betaald. Zorg voor een expliciete laadstatus in plaats van optimistisch alles standaard te tonen.

Rechten op de verkeerde plek controleren. Een actief entitlement moet je opnieuw controleren telkens als een betaald scherm opent, niet alleen één keer bij het opstarten. Als de gebruiker opzegt of zijn abonnement verloopt terwijl hij de app gebruikt, moet het volgende scherm die verandering laten zien.

Sandbox en productie door elkaar halen. Product-ID's en sandbox-testaccounts staan los van productie. Een test die in de sandbox werkt met het verkeerde Apple-account, of een product dat alleen in productie is aangemaakt, kan de onterechte indruk geven dat alles klaar is.

Een geverifieerde app, niet alleen een app die compileert

Een abonnement dat "werkt" bij een snelle test op je eigen account, is geen garantie dat het een herstel op een ander apparaat of een echt verlopen overleeft. Precies dat controleert een reviewer van Apple. De pagina in-app-abonnement op iOS beschrijft die hele keten, van het aanmaken van de producten tot de laatste controle.

Wil je starten vanaf een basis waarin de paywall en de abonnementen al in de code zitten? Dat zit in de startcode van de iOS Kit. Om je abonnement te controleren zoals de reviewer dat doet, bevat de Apple Review Kit mijn checklist voor het indienen en de notities die je voor de tester achterlaat over de in-app-aankoop.

Veelgestelde vragen

Hoe zet je een RevenueCat-abonnement op iOS op?

In vier stappen. Maak eerst je producten aan in App Store Connect. Koppel daarna RevenueCat met je App Store Connect API-sleutel, definieer je entitlements (de toegangsrechten) en bouw dan de paywall. Sluit af met het testen van de aankoop, het herstel en het verlopen: die stap wordt vaak afgeraffeld, terwijl Apple hem wel controleert.

Is RevenueCat verplicht om een abonnement op iOS te verkopen?

Nee. Met StoreKit, het framework van Apple, kun je een abonnement verkopen zonder externe dienst. Maar dan schrijf je zelf alle logica voor aankopen, herstel en het controleren van toegangsrechten, met randgevallen die je makkelijk vergeet: een nieuw apparaat, een verlopen abonnement, een terugbetaling. RevenueCat zit tussen App Store Connect en je app in, zodat je die laag niet hoeft te schrijven.

Wat is een entitlement in RevenueCat?

Een entitlement is een toegangsrecht: het staat voor wat het abonnement ontgrendelt, bijvoorbeeld volledige toegang tot de app, ongeacht het exacte product dat het heeft geactiveerd. Voeg je later een jaarabonnement toe, dan koppel je het nieuwe product gewoon aan hetzelfde entitlement. De code die in je app de toegang controleert, hoeft niet te veranderen.

Hoe test je een RevenueCat-abonnement voordat je het bij Apple indient?

Drie scenario's moeten werken voordat je indient. Aankoop: met een sandbox-testaccount wordt de toegang meteen ontgrendeld, zonder de app opnieuw te starten. Herstel: op een nieuw apparaat of na een herinstallatie, met hetzelfde Apple-account, vindt de herstelknop het actieve abonnement terug. Verlopen: in de sandbox verlopen abonnementen binnen een paar minuten, zodat je kunt controleren of de toegang wordt afgesloten.

Waarom blijft een product dat zichtbaar is in RevenueCat onzichtbaar voor gebruikers?

Vaak omdat het product nooit in een app-inzending heeft gezeten. Een product dat in App Store Connect is aangemaakt, maar nooit samen met de bijbehorende versie bij de eerste review is ingediend, blijft onzichtbaar voor je gebruikers, ook al ziet RevenueCat het al. Dit wordt vaak vergeten bij het aanmaken van de producten.

Neemt RevenueCat een commissie op abonnementen?

RevenueCat neemt een commissie op de omzet boven een bepaalde maandelijkse drempel. Die komt bovenop de commissie van Apple op abonnementen die in de app worden verkocht. Check de actuele tarieven op de site van RevenueCat voordat je je verdienmodel rond die twee commissies opbouwt.