Cette page documente
@whop/elements@1.10.0 et @whop/elements-react@1.10.0.Whop Elements sont des composants d’interface hébergés et personnalisables que vous intégrez à votre propre site. Chaque élément s’affiche dans un frame isolé servi depuis le CDN de Whop. Vous installez un package léger et entièrement typé, et le code des éléments se met à jour de lui-même.
Installation
Prérequis
Content Security Policy
contentSecurityPolicy() de @whop/elements renvoie toutes les sources de ce tableau, pour l’environnement que vous transmettez. Les lignes concernant le travail côté page s’exécutent sur votre page, pas dans un frame. Les scripts que les éléments chargent pour Apple Pay, Google Pay et PayPal et pour la liaison de compte bancaire Plaid proviennent d’autres entreprises et peuvent charger des ressources au-delà de ces lignes. Consultez aussi les recommandations Content Security Policy de chaque fournisseur.Un élément modal assombrit votre page en arrière-plan avec un style inline. Un
style-src qui n’autorise pas les styles inline laisse la page non assombrie, mais la modale fonctionne toujours.Avant de commencer
Il vous faut deux choses :- Un
accountId. Un ID de compte, préfixé parbiz_, ou un ID d’utilisateur, préfixé paruser_, pour les propres données de l’utilisateur. Les interfaces de paiement acceptent plutôt un plan ou un montant, et chaque page d’élément indique ce dont il a besoin. - Un endpoint serveur qui crée un jeton d’accès, limité aux éléments que vous montez.
Monter votre premier élément
Vous préférez npm à la balise script ? Le jeton est une valeur que vous définissez, pas un callback appelé par le SDK. Définissez-en un nouveau avant son expiration :Avec React, le même objet passe par
loadWhop() injecte le même script hébergé et résout le constructeur global :Authentification
Transmettez unaccessToken lorsque vous créez le handle. Utilisez un seul jeton pour tout le handle, pas un par élément. Le handle envoie ce jeton à chaque élément qu’il contient, donc demandez tous les scopes dont vous avez besoin sur ce seul jeton. Chaque page d’élément liste les scopes qu’il lit.Si vous omettez
accessToken, les requêtes utilisent à la place le cookie de session de l’utilisateur. Cela fonctionne uniquement sur whop.com. L’API n’envoie pas Access-Control-Allow-Credentials sur les requêtes preflight cross-origin, donc une page sur votre propre domaine n’a pas de session de repli et doit transmettre un jeton.Configuration globale
Tout ce que vous transmettez à la construction s’applique à chaque groupe d’éléments créé à partir de cette instance (les options propres à un handle peuvent prendre le dessus pour chaque groupe) :Personnalisation visuelle de chaque élément —
theme (clair/sombre + palettes), variables (propriétés CSS personnalisées) et classes (déclarations de style par partie). Le schéma de couleurs est appliqué avant le premier affichage d’un élément, donc les pages sombres ne clignotent jamais en clair. Consultez Apparence.Langue du texte de l’interface des éléments — l’une des langues intégrées à l’application ; toute autre valeur revient à la langue par défaut. Par défaut :
"en".L’une des valeurs "en", "es", "zh", "nl", "pt", "de", "hu", "it", "fr", "ja", "pl" ou "tr".L’environnement de l’API Whop avec lequel communiquent les éléments —
"sandbox" cible l’API sandbox (données de test ; aucun argent réel ne circule). Choisir un environnement est le seul moyen de changer l’endroit où les éléments envoient ce que saisit un acheteur, et les deux environnements appartiennent à Whop. L’environnement sandbox n’est pas encore disponible pour tous. Par défaut : "production".Indique si les éléments peuvent afficher des notifications toast sur votre page — de brefs messages d’état (« Payment method added », « Payment failed ») affichés dans le coin inférieur droit. Définissez
false pour les désactiver entièrement. Par défaut : true.Ignore le pixel Whop. Par défaut, les éléments chargent le pixel publicitaire Whop sur une page qui ne l’exécute pas déjà, limité au compte pour lequel ils travaillent (l’
accountId d’un groupe d’éléments, ou le vendeur du plan d’un checkout), et associent les analytics des éléments à l’ID visiteur du pixel, un lien d’identité ponctuel qui permet de rapprocher l’activité des éléments de vos données d’attribution publicitaire dans le graphe d’identité de Whop. Définissez true pour ne faire ni l’un ni l’autre. Les analytics d’utilisation elles-mêmes ne sont pas affectées (désactivez-les par handle avec analytics: false). Par défaut : false.<WhopElements appearance={…} locale={…}>.L’option globale toasts est active sur cette page — le bouton ci-dessous en envoie un via le même canal que celui utilisé par les éléments, avec le thème de l’appearance de cette page :Ce que gèrent les éléments, et ce qui vous revient
Chaque élément récupère ses propres données et affiche ses propres états de chargement, vide et d’erreur.Vous gérez la navigation et le stockage. Les éléments signalent les sélections et les résultats sous forme d’événements, et n’écrivent jamais dans votre base de données.L’exception est un flux qui quitte la page. Lorsqu’un élément accepte unereturnUrl, il y redirige l’onglet, et l’acheteur peut donc se retrouver hors de votre page. L’acheteur y arrive après une étape externe échouée ou abandonnée aussi bien qu’après une étape réussie, avec status (succeeded, failed ou canceled) et l’ID de la tentative ajoutés à l’URL, donc la page de returnUrl doit lire status avant d’afficher un message de succès. Exécutez les commandes à partir des webhooks plutôt que d’un callback navigateur.Les éléments s’exécutent dans des frames, donc seules les valeurs sérialisables franchissent la frontière. Il n’y a pas de DOM partagé, et l’identité des objets n’est pas préservée.Dépannage
Éléments disponibles
Payments
Encaissez un paiement à partir d’un ID
plan_ ou d’une devise et d’un montant inline, ou enregistrez un moyen de paiement sans débit avec mode: "setup".Verifications
Collecte et vérifie les informations d’identité d’un compte.
Checkout
Pilote un checkout hébergé complet pour un ou plusieurs plans — récapitulatif de prix détaillé, codes promo, devise dans laquelle l’acheteur paie, et toute l’interface de collecte du paiement (les éléments de paiement, composés à l’intérieur) — via l’API des sessions de checkout Whop.
Ads
Un compte publicitaire.
Tracking
L’audience suivie d’un compte : toutes les personnes vues par son pixel, et tous les événements qu’elles ont effectués.
Wallet
Pilote les interfaces financières d’un compte.
Websites
Les sites web d’un compte : chaque site créé sur whop.site ainsi que chaque domaine signalé par le Whop Pixel, avec le trafic et le revenu attribué par domaine.
Dashboard
Les interfaces du tableau de bord propres à un compte, intégrées à votre site.
Delivery
Suivi des livraisons pour les clients d’une entreprise.
Chat
Chat en temps réel avec une liste de canaux et une recherche de messages.
Étapes suivantes
- Apparence : thèmes, variables CSS et restylage par partie
- Create Access Token : l’endpoint à partir duquel votre serveur génère les jetons

