Skip to main content
Deze pagina documenteert @whop/elements@1.10.0 en @whop/elements-react@1.10.0.
Sinds v1.0.0.
Wordt gemount binnen Checkout. Geef props en callbacks mee via de create-opties of als React-props.
Exclusief. ExpressCheckoutElement is een alternatief voor CheckoutElement in deze Checkout-handle. Mount er één tegelijk. Verwijder het voordat je een ander mount.
Mount binnen <Checkout>, dat de checkoutsessie opent op basis van je plan, items of checkoutConfiguration en de referentie voor zichzelf houdt. <Checkout> zelf wordt gemount binnen <WhopElements>. Eén druk op de knop is de hele aankoop: er is geen bevestigingstoken om aan je server door te geven.

Voorbeeldgegevens. Open de Playground.

Props

object | ("apple_pay" | "google_pay" | "paypal_express")[]
wallets als array is verouderd en wordt verwijderd in de volgende hoofdversie. Geef in plaats daarvan { applePay, googlePay, payPal } mee met "auto" of "never".
Welke wallets mogen worden weergegeven. Stel applePay, googlePay of payPal in op 'never' om die knop weg te laten; elke sleutel is standaard 'auto', een filter op wat het apparaat van de koper en de verkoper daadwerkelijk aanbieden. Het element toont nooit een wallet die het apparaat, de geleverde matrix of de betaalmethodeconfiguratie van de checkout niet kan ondersteunen, en de weergavevolgorde blijft best-native-first, met PayPal als laatste. Een lijst met wallettypen (['apple_pay', 'google_pay']) wordt nog geaccepteerd als allowlist, maar is verouderd en wordt verwijderd in de volgende hoofdversie; een lege lijst geeft niets weer (met een waarschuwing in dev-builds). Elke wallet vereist dat Apple Pay gereed is op het domein van de pagina via de Domains API — first-party whop.com-pagina’s zijn vooraf goedgekeurd; voeg op elke andere site Apple Pay toe aan het domein, anders blijven de knoppen verborgen. Het aanbieden van Google Pay op je eigen site is onderworpen aan de Google Pay API Terms of Service. Standaard {}.
"auto" | "horizontal" | "vertical"
Hoe de knoppen worden gestapeld. auto volgt de eigen container van het element — gestapeld in smalle containers, naast elkaar in brede; horizontal en vertical dwingen één indeling af. Standaard "auto".

Events

Geef callbacks mee in de create-opties of als React-props.

onLoaderStart

Wordt uitgevoerd nadat het laadskelet voor het eerst is weergegeven en vóór onReady.

onReady

Wordt uitgevoerd na de eerste volledige weergave van het element.

onError

Wordt uitgevoerd wanneer het element niet kan laden of crasht. De fallback blijft zichtbaar. Gebruik code voor programmatische afhandeling. sourceKey identificeert een mislukte host-state-bron.
object

Methoden

Roep deze aan op de handle die create retourneert, of via een React-ref.

mount

Mount het element in target en begint met laden. React-componenten mounten zichzelf.Parameters
string | HTMLElement
vereist

destroy

Verwijdert het element en geeft het frame en de abonnementen vrij. Je kunt het meerdere keren aanroepen. React verwijdert het element automatisch.

update

Voegt nieuwe props samen in het gemounte element. Wijzig in React in plaats daarvan de componentprops.Parameters
Partial<ExpressCheckoutElementProps>
vereist

Styling

Style deze onderdelen via appearance.classes. Gebruik camelCase of kebab-case voor eigenschapsnamen en vermeld eenheden. Stylesheets van de pagina kunnen het frame van het element niet bereiken. Het framework valideert elke declaratie voordat die wordt geïnjecteerd.
Geef in React appearance mee aan <Checkout>. Stel het globaal in met WhopElements({ appearance }).

Props

('apple_pay' | 'google_pay')[]
Welke wallets mogen worden weergegeven, als filter op wat het apparaat aanbiedt. Het element toont nooit een wallet die het apparaat, het account of de betaalmethodeconfiguratie van de checkout niet kan ondersteunen. Een lege lijst geeft niets weer. Standaard beide.
StyleProp<ViewStyle>
Toegepast op de buitenste View van het element. Gebruik voor thema’s bij voorkeur appearance.parts op de provider, dat elk element op dit oppervlak dekt. Let op: de namen van React Native-onderdelen vormen momenteel een eigen set, niet de whop-*-klassenamen van het web, dus een appearance-object voor het web is niet ongewijzigd over te zetten.
ReactNode
Wordt weergegeven in plaats van het ingebouwde skelet terwijl het element laadt.
() => void
Wordt eenmaal geactiveerd wanneer het element gereed is: de knop staat klaar, of het element weet dat het niets weergeeft. <Checkout> wacht erop, dus de eigen onLoadingChange daarvan is meestal wat je nodig hebt.
(error: { message: string; code?: string }) => void
Een laad- of configuratiefout voor dit element. Het element geeft in beide gevallen zijn eigen foutscherm weer.

Statussen

Eén skeletpil terwijl de sessie opent en het apparaat wordt gevraagd of het kan betalen, daarna de eigen Apple Pay- of Google Pay-knop van het platform boven de melding Powered by Whop. Een apparaat zonder wallet, een wallet die de betaalmethodeconfiguratie van de checkout uitschakelt, of een abonnement dat is uitverkocht of gearchiveerd, geeft niets weer. Een checkout die een sheet niet eerlijk kan afronden (een setup, aanmelding voor een wachtlijst, een overdracht, een formuliervraag die alleen een pagina kan stellen) geeft een verklarend scherm weer en meldt EXPRESS_CHECKOUT_UNAVAILABLE via onError. Na de aankoop toont het element de uitkomst: voltooid, in verwerking, of een knop Finish payment of Try again wanneer de betaling de koper nog nodig heeft.

Goed om te weten

  • Een apparaat biedt één wallet: Apple Pay op iOS, Google Pay op Android. Daarom is er hier geen layout-prop: er is nooit een tweede knop om te schikken.
  • De sheet verzamelt wat de sessie nog nodig heeft: het e-mailadres wanneer de sessie er geen heeft, een telefoonnummer wanneer de verkoper er een verzamelt, en een verzendadres voor fysieke goederen. Een verkoper die telefoonnummers verifieert, krijgt een codestap in een native modal nadat de sheet is gesloten.
  • Op iOS herberekent de sheet de prijs wanneer de koper van kaart wisselt, zodat de belasting het factuuradres volgt, en biedt een promotiecodeveld aan wanneer de verkoper codes toestaat. De Android-sheet van Google toont het totaal van de checkout en heeft geen codeveld.
  • Er wordt nooit door je app genavigeerd. onComplete op <Checkout> wordt eenmaal geactiveerd wanneer de aankoop vaststaat, met sessionId en receiptId; daar stuur je de koper verder. Lever via webhooks, niet vanuit deze callback.
  • 3D Secure en andere externe stappen openen ASWebAuthenticationSession op iOS en Custom Tabs op Android, en het element pollt de betaling tot die in rust is. returnUrl op <Checkout> moet een https-URL zijn die je zelf host.
  • Elke <Checkout>-optie wordt bij het aanmaken vastgelegd. Als je er een wijzigt na het mounten, wordt CHECKOUT_OPTIONS_FROZEN gemeld en blijft de oorspronkelijke bestelling behouden; geef <Checkout> een nieuwe key om iets anders te verkopen.
Wikkel je app eenmaal in <WhopElements getToken={…}> en mount daarna <Checkout> rond het element. <Checkout> accepteert plan, items, checkoutConfiguration, quantity, promoCode, affiliateCode, attribution, metadata en returnUrl, plus onComplete, onError, onLoadingChange en fallback. Zie Aan de slag en Appearance.