Vooraf gerangschikte velden voor kaartnummer, vervaldatum en beveiligingscode. Maak het aan met payments.create("card"), schakel je betaalknop in vanuit onChange en bevestig met payments.createConfirmationToken(). Kaartnummers blijven in PCI-geïsoleerde gehoste velden. layout ondersteunt stacked (standaard) en compact.
Deze pagina documenteert @whop/elements@1.10.0 en @whop/elements-react@1.10.0.
Sinds v1.0.0.
Wordt gemount binnen Payments. Geef props en callbacks mee via de create-opties of als React-props.
Exclusief.CardElement is een alternatief voor PaymentElement of CardFields in deze Payments-handle. Mount er één tegelijk. Verwijder het voordat je een ander mount.
Wacht op BrandingElement. Dit element blijft in zijn laadstatus totdat BrandingElement is gemount in dezelfde Payments-handle.
Wordt gemount binnen een WhopPayments-scope. De drie kaartinvoervelden als één eenheid, PCI-geïsoleerd door de tokenizer, zodat het nummer, de vervaldatum en de beveiligingscode nooit in je proces terechtkomen.
Mount binnen <Payments>, dat de afschrijving en het bevestigingstoken beheert. <Payments> zelf wordt gemount binnen <WhopElements>. Gebruik het wanneer het formulier een kaart accepteert en verder niets: het registreert zichzelf als het verzameloppervlak, zodat createConfirmationToken het tokeniseert zonder dat je verder iets hoeft te koppelen.
stacked (standaard) plaatst het kaartnummer boven de vervaldatum en beveiligingscode. compact plaatst alle drie op één rij. Standaard "stacked".
Events
Geef callbacks mee in de create-opties of als React-props.
onChange
Wordt geactiveerd wanneer de kaartvelden veranderen. complete wordt true nadat de koper alle drie heeft ingevuld. Gebruik het om bevestigen mogelijk te maken. brand is het herkende kaartnetwerk. funding is het herkende financieringstype (credit, debit of prepaid), null totdat het nummer er een identificeert. issuingCountry is de tweeletterige code in kleine letters van het land waarin de kaart is uitgegeven, null totdat het nummer er een identificeert.
object
Verbergen eigenschappen
boolean
vereist
string
vereist
string | null
vereist
string | null
vereist
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
Verbergen eigenschappen
string
vereist
string
string
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<CardElementProps>
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.
Klasse
Doel
.whop-Card
Root van het kaartelement
.whop-CardError
Foutpaneel voor de kaartconfiguratie
.whop-CardField
Veld voor kaartnummer, vervaldatum of beveiligingscode
.whop-CardFieldError
Validatiemelding van de kaart
.whop-CardFieldGroup
Gestapelde velden voor kaartnummer, vervaldatum en beveiligingscode
.whop-CardFieldInput
Omrande PCI-invoercontainer
.whop-CardFieldInputFocused
PCI-invoercontainer met focus
.whop-CardFieldInputInvalid
Ongeldige of onvolledige PCI-invoercontainer
.whop-CardFieldRow
Compacte rij voor kaartnummer, vervaldatum en beveiligingscode
Geef in React appearance mee aan <Payments>. Stel het globaal in met WhopElements({ appearance }).
Parameters
WhopCardElement.Layout
.stacked plaatst het nummer boven de vervaldatum en beveiligingscode; .compact plaatst alle drie op één rij. Standaard .stacked.
String?
Een geavanceerde publiceerbare sleutel. Laat je die weg, dan wordt de eigen sleutel van het account opgehaald.
Binding<WhopCardState>?
Leest de volledigheid en het herkende merk terug.
WhopCardState
Wat een selectie teruggeeft:
isComplete: Bool: alle drie de velden zijn geldig
brand: String?: het herkende netwerk, zodra het nummer er een identificeert
Statussen
Wordt direct weergegeven en valideert terwijl de koper typt. Het merk verschijnt zodra het nummer er een identificeert. state.isComplete wordt true wanneer alle drie de velden geldig zijn.
Goed om te weten
Gebruik het in plaats van WhopPaymentElement wanneer kaart de enige methode is die je accepteert. Beide mounten is een conflict: de controller maakt het token aan vanuit één verzameloppervlak.
createConfirmationToken(billingDetails:) heeft een naam van de kaarthouder nodig voor de kaartroute, dus geef er een mee of mount een adreselement dat die verzamelt.
publicKey is een geavanceerde uitwijkmogelijkheid. Laat je die weg, dan haalt de SDK de tokenizersleutel van het account op.
Mount het binnen een WhopPayments(accountID:charge:)-scope, die de controller aanmaakt en aan de inhoud doorgeeft. payments.buyer is de ingelogde koper zodra een inlog via e-mail er een heeft bevestigd. WhopBrandingElement moet ook op het scherm staan, omdat Whop merchant of record is bij deze verkopen en createConfirmationToken zonder dit element weigert. Style met .whopElementsAppearance(_:). De module is Elements, niet WhopElements van de wallet-SDK. Zie Aan de slag en Appearance.
Props
'stacked' | 'compact'
stacked plaatst het nummer boven de vervaldatum en beveiligingscode. compact plaatst alle drie op één rij. Standaard stacked.
(payload: CardFieldsChangePayload) => void
Wordt bij elke wijziging geactiveerd met de volledigheid en fouten per veld.
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 zodra het element interactief is. <Payments> groepeert deze, dus de eigen onLoadingChange daarvan is meestal wat je nodig hebt.
Een laad- of configuratiefout voor dit element. Het element geeft in beide gevallen zijn eigen foutscherm weer.
CardFieldsChangePayload
Wat onChange teruggeeft:
complete: boolean: elk veld is ingevuld en geldig
errors: Record<string, string>: meldingen per veld, precies leeg wanneer complete true is
Statussen
De drie velden worden samen weergegeven zodra de publiceerbare sleutel is opgehaald. onChange meldt complete wanneer alle drie geldig zijn, en het element toont zijn eigen fouten per veld.
Goed om te weten
Kaartnummers gaan nooit door je code. De velden zijn PCI-geïsoleerde native invoervelden en de SDK geeft Whop een token, zodat je app buiten de PCI-scope blijft.
Door dit te mounten wordt de kaart het verzameloppervlak van de provider, zodat createConfirmationToken het tokeniseert zonder extra koppeling. Mount het niet naast een PaymentElement: er is precies één verzameloppervlak tegelijk actief.
Gebruik voor een formulier waarin de drie velden in je eigen lay-out staan in plaats daarvan CardFields.
Wikkel je app eenmaal in <WhopElements getToken={…}> en mount daarna <Payments> rond de elementen. Zie Aan de slag en Appearance.
Assistant
Responses are generated using AI and may contain mistakes.