Skip to main content
Whop sluit apps in de site in met iframes. Deze SDK biedt een typeveilige manier om met de Whop-applicatie te communiceren via een request-en-response-API die window.postMessage gebruikt. Omdat dit pakket afhankelijk is van window.postMessage, werkt het alleen in Client Components of client-side JavaScript.

Relevante pakketten

  • @whop/iframe - Het hoofdpakket voor de iframe-SDK.
  • @whop/react - Een React-wrapper voor Whop Apps, inclusief helpers voor de iframe-SDK.

Installatie

De belangrijkste functie die het pakket @whop/iframe exporteert, is de functie createSdk. Wanneer je deze aanroept, stelt de functie met window.on('message', ...) een listener in voor berichten van de hoofdsite van Whop. Ze is ook beschikbaar via de component WhopIframeSdkProvider uit @whop/react.

React

Als je React gebruikt, voeg dan de component WhopIframeSdkProvider uit @whop/react toe om de iframe-SDK aan alle onderliggende componenten beschikbaar te stellen.
1

Mount de provider in de root-layout

2

Gebruik de iframe-SDK in een component

Andere frameworks

Voor andere frameworks kun je de functie createSdk uit @whop/iframe gebruiken om een instantie van de iframe-SDK te maken.
1

Maak de instantie van de iframe-SDK

2

Gebruik de instantie van de iframe-SDK

De SDK en het iframe zijn nu ingesteld.
Nadat je de iframe-SDK hebt geïnitialiseerd, kun je deze gebruiken om externe links te openen. Hiermee wordt je app gesloten en navigeer je naar een nieuwe website.

Gebruikersprofielen openen

Als je een Whop-gebruikersprofiel wilt tonen, kun je de methode openExternalUrl gebruiken en de link naar de profielpagina meegeven, die eruitziet als https://whop.com/@username. De Whop-app onderschept dit en toont een modal met het gebruikersprofiel in plaats van weg te navigeren.
Je kunt ook een gebruikers-ID gebruiken in plaats van een gebruikersnaam. De uiteindelijke link ziet er dan zo uit: https://whop.com/@user_XXXXXXXX

In-app-aankopen

De iframe-SDK biedt een methode om in-app-aankopen direct binnen je app te starten. Zo kun je met de checkout van Whop betalingen accepteren voor eenmalige aankopen of abonnementen. Om in-app-aankopen te verwerken, moet je:
  1. Een checkoutconfiguratie aanmaken op je server (met variantgegevens in het compatibiliteitsveld plan en je metadata)
  2. De methode inAppPurchase van de iframe-SDK gebruiken om de betalingsmodal te openen
  3. Het antwoord afhandelen en de betaling valideren via webhooks
Zie de documentatie over het accepteren van betalingen voor een volledige gids over het instellen van in-app-aankopen, inclusief het aanmaken van checkoutconfiguraties, het afhandelen van webhooks en het valideren van betalingen.