Deze pagina documenteert
@whop/elements@1.10.0 en @whop/elements-react@1.10.0.Whop Elements zijn gehoste UI-componenten met aanpasbare thema’s die je in je eigen site insluit. Elk element wordt weergegeven in een geïsoleerd frame dat vanaf het CDN van Whop wordt geleverd. Je installeert een dun, volledig getypeerd pakket en de elementcode blijft vanzelf up-to-date.
Installatie
Vereisten
Content Security Policy
contentSecurityPolicy() uit @whop/elements retourneert elke bron in deze tabel, voor de omgeving die je meegeeft. De rijen voor werk aan de paginazijde worden op je pagina uitgevoerd, niet in een frame. De scripts die elementen laden voor Apple Pay, Google Pay en PayPal en voor Plaid-bankrekeningkoppeling komen van andere bedrijven en kunnen resources laden die buiten deze rijen vallen. Raadpleeg ook de Content Security Policy-richtlijnen van elke provider.Een modaal element dimt je pagina erachter met een inline style. Een
style-src die geen inline styles toestaat, laat de pagina ongedimd, maar de modal werkt nog steeds.Voordat je begint
Je hebt twee dingen nodig:- Een
accountId. Een account-ID, met prefixbiz_, of een gebruikers-ID, met prefixuser_, voor de eigen gegevens van de gebruiker. Betaaloppervlakken accepteren in plaats daarvan een abonnement of bedrag, en elke elementpagina vermeldt wat die nodig heeft. - Een server-endpoint dat een toegangstoken aanmaakt, met een scope voor de elementen die je mount.
Je eerste element mounten
Gebruik je liever npm dan de scripttag? Het token is een waarde die je instelt, geen callback die de SDK aanroept. Stel een nieuw token in voordat het verloopt:In React gaat hetzelfde object mee met
loadWhop() injecteert hetzelfde gehoste script en levert de globale constructor op:Authenticatie
Geef eenaccessToken mee wanneer je de handle aanmaakt. Gebruik één token voor de hele handle, niet één per element. De handle stuurt dat token naar elk element eronder, dus vraag alle scopes die je nodig hebt aan voor dat ene token. Elke elementpagina vermeldt de scopes die het leest.Als je
accessToken weglaat, gebruiken verzoeken in plaats daarvan de sessiecookie van de kijker. Dit werkt alleen op whop.com. De API stuurt geen Access-Control-Allow-Credentials bij cross-origin preflights, dus een pagina op je eigen domein heeft geen sessie om op terug te vallen en moet een token meegeven.Globale configuratie
Alles wat je bij de constructie meegeeft, geldt voor elke elementgroep die vanuit die instantie wordt aangemaakt (de eigen opties van een handle kunnen dit per groep overschrijven):Visuele aanpassing voor elk element —
theme (licht/donker + paletten), variables (CSS custom properties) en classes (stijldeclaraties per onderdeel). Het kleurenschema wordt toegepast vóór de eerste weergave van een element, zodat donkere pagina’s nooit licht oplichten. Zie Appearance.Taalinstelling voor de UI-tekst van elementen — een van de ingebouwde taalinstellingen van de app; elke andere waarde valt terug op de standaardtaalinstelling. Standaard
"en".Een van "en", "es", "zh", "nl", "pt", "de", "hu", "it", "fr", "ja", "pl" of "tr".Met welke Whop API-omgeving de elementen communiceren —
"sandbox" richt zich op de sandbox-API (testgegevens; er wordt geen echt geld verplaatst). Het kiezen van een omgeving is de enige manier om te wijzigen waarheen de elementen versturen wat een koper typt, en beide omgevingen zijn van Whop zelf. De sandboxomgeving is nog niet algemeen beschikbaar. Standaard "production".Of elementen toastmeldingen op je pagina mogen tonen — korte statusberichten (“Payment method added”, “Payment failed”) die rechtsonder worden weergegeven. Stel in op
false om ze volledig uit te schakelen. Standaard true.Sla de Whop-pixel over. Standaard laden elementen de Whop-advertentiepixel op een pagina die deze nog niet uitvoert, met een scope voor het account waarvoor ze werken (de
accountId van een elementgroep, of de verkoper van het abonnement van een checkout), en koppelen ze elementanalytics aan de bezoekers-ID van de pixel, een eenmalige identiteitskoppeling die elementactiviteit koppelbaar maakt aan je advertentie-attributiegegevens in de identiteitsgraaf van Whop. Stel in op true om geen van beide te doen. Gebruiksanalytics zelf worden niet beïnvloed (schakel die per handle uit met analytics: false). Standaard false.<WhopElements appearance={…} locale={…}>.De globale instelling toasts is live op deze pagina — de knop hieronder verstuurt er een via dezelfde rail die elementen gebruiken, met het thema van de appearance van deze pagina:Wat de elementen afhandelen en wat jij beheert
Elk element haalt zijn eigen gegevens op en geeft zijn eigen laad-, lege en foutstatussen weer.Jij verzorgt navigatie en opslag. Elementen melden selecties en resultaten als events en schrijven nooit naar je database.De uitzondering is een flow die de pagina verlaat. Wanneer een element eenreturnUrl accepteert, navigeert het het tabblad daarheen, zodat de koper buiten je pagina kan belanden. De koper komt daar terecht na een mislukte of afgebroken externe stap en ook na een geslaagde, met status (succeeded, failed of canceled) en het ID van de poging toegevoegd aan de URL, dus de pagina op returnUrl moet status lezen voordat die een succesmelding toont. Lever via webhooks in plaats van via een browsercallback.Elementen draaien in frames, dus alleen serialiseerbare waarden gaan over de grens. Er is geen gedeelde DOM en objectidentiteit blijft niet behouden.Probleemoplossing
Beschikbare elementen
Payments
Int een betaling op basis van een
plan_-ID of een inline valuta en bedrag, of sla een betaalmethode op zonder af te schrijven met mode: "setup".Verifications
Verzamelt en verifieert identiteitsgegevens voor een account.
Checkout
Stuurt een volledige gehoste checkout aan voor een of meer abonnementen — gespecificeerd prijsoverzicht, promotiecodes, de valuta waarin de koper betaalt en het volledige oppervlak voor het innen van betalingen (de betaalelementen, daarbinnen samengesteld) — via de Whop checkout sessions API.
Ads
Een advertentieaccount.
Tracking
Het gevolgde publiek van een account: iedereen die de pixel heeft gezien, en elk event dat ze hebben uitgevoerd.
Wallet
Stuurt de geldoppervlakken van een account aan.
Websites
De websites van een account: elke site die op whop.site is gebouwd plus elk domein dat de Whop Pixel rapporteert, met verkeer en toegeschreven omzet per domein.
Dashboard
De eigen dashboardoppervlakken van een account, ingesloten op je site.
Delivery
Leveringstracking voor klanten van een bedrijf.
Chat
Realtime chat met een kanalenlijst en zoeken in berichten.
Volgende
- Appearance: thema’s, CSS-variabelen en restyling per onderdeel
- Create Access Token: het endpoint waarmee je server tokens aanmaakt

