Skip to main content
Whop intègre les apps dans le site à l’aide d’iframes. Ce SDK vous offre un moyen typé de communiquer avec l’application Whop via une API de type requête-réponse qui utilise window.postMessage. Comme ce package repose sur window.postMessage, il ne fonctionne que dans les Client Components ou en JavaScript côté client.

Packages concernés

  • @whop/iframe - Le package principal du SDK iframe.
  • @whop/react - Un wrapper React pour les Whop Apps, incluant des helpers pour le SDK iframe.

Configuration

La fonction principale exportée par le package @whop/iframe est la fonction createSdk. Lorsqu’elle est appelée, cette fonction met en place un écouteur pour les messages provenant du site principal de Whop, à l’aide de window.on('message', ...). Elle est également exposée via le composant WhopIframeSdkProvider de @whop/react.

React

Si vous utilisez React, ajoutez le composant WhopIframeSdkProvider de @whop/react pour fournir le SDK iframe à tous les composants enfants.
1

Monter le provider dans le layout racine

2

Utiliser le SDK iframe dans un composant

Autres frameworks

Pour les autres frameworks, vous pouvez utiliser la fonction createSdk de @whop/iframe pour créer une instance du SDK iframe.
1

Créer l'instance du SDK iframe

2

Utiliser l'instance du SDK iframe

Le SDK et l’iframe sont maintenant configurés.
Après avoir initialisé le SDK iframe, vous pouvez l’utiliser pour ouvrir des liens externes. Cela ferme votre app et redirige vers un nouveau site web.

Ouvrir des profils utilisateur

Pour afficher le profil d’un utilisateur Whop, vous pouvez utiliser la méthode openExternalUrl et lui transmettre le lien de sa page de profil, qui ressemble à https://whop.com/@username. L’app Whop intercepte ce lien et affiche une modale contenant le profil de l’utilisateur au lieu de quitter la page.
Vous pouvez aussi utiliser un ID utilisateur à la place du nom d’utilisateur. Le lien final doit ressembler à ceci : https://whop.com/@user_XXXXXXXX

Achats intégrés

Le SDK iframe fournit une méthode pour déclencher des achats intégrés directement dans votre app. Vous pouvez ainsi accepter des paiements pour des achats ponctuels ou des abonnements via le checkout de Whop. Pour traiter les achats intégrés, vous devez :
  1. Créer une configuration de checkout sur votre serveur (avec les détails de la variante dans le champ de compatibilité plan et vos métadonnées)
  2. Utiliser la méthode inAppPurchase du SDK iframe pour ouvrir la modale de paiement
  3. Gérer la réponse et valider le paiement via les webhooks
Pour un guide complet sur la mise en place des achats intégrés, y compris la création de configurations de checkout, la gestion des webhooks et la validation des paiements, consultez la documentation Accepter des paiements.