Færdigarrangerede felter til kortnummer, udløbsdato og sikkerhedskode. Opret med payments.create("card"), aktivér din betalingsknap ud fra onChange, og bekræft med payments.createConfirmationToken(). Kortnumre forbliver i PCI-isolerede hostede felter. layout understøtter stacked (standard) og compact.
Denne side dokumenterer @whop/elements@1.10.0 og @whop/elements-react@1.10.0.
Siden v1.0.0.
Monteres inde i Payments. Angiv props og callbacks via create-indstillingerne eller som React-props.
Eksklusiv.CardElement er et alternativ til PaymentElement eller CardFields i dette Payments-handle. Montér ét ad gangen. Ødelæg det, før du monterer et andet.
Venter på BrandingElement. Dette element forbliver i sin indlæsningstilstand, indtil BrandingElement er monteret i det samme Payments-handle.
Monteres inde i et WhopPayments-scope. De tre kortinputs som én enhed, PCI-isoleret af tokenizeren, så nummer, udløbsdato og sikkerhedskode aldrig kommer ind i din proces.
Montér inde i <Payments>, som ejer opkrævningen og bekræftelsestokenet. <Payments> monteres selv inde i <WhopElements>. Brug det, når formularen tager imod kort og intet andet: det registrerer sig selv som indsamlingsflade, så createConfirmationToken tokeniserer det, uden at andet skal kobles på.
stacked (standard) placerer kortnummeret over udløbsdato og sikkerhedskode. compact placerer alle tre på én række. Standard er "stacked".
Events
Angiv callbacks i create-indstillingerne eller som React-props.
onChange
Udløses, når kortfelterne ændres. complete bliver true, når køberen har udfyldt alle tre. Brug det til at aktivere bekræftelse. brand er det registrerede kortnetværk. funding er den registrerede finansieringstype (credit, debit eller prepaid), null indtil nummeret identificerer en. issuingCountry er den to-bogstavs landekode med små bogstaver for det land, kortet er udstedt i, null indtil nummeret identificerer et.
object
Skjul egenskaber
boolean
påkrævet
string
påkrævet
string | null
påkrævet
string | null
påkrævet
onLoaderStart
Kører, efter at indlæsningsskelettet først er tegnet, og før onReady.
onReady
Kører efter elementets første fuldstændige rendering.
onError
Kører, når elementet ikke kan indlæses eller går ned. Fallback-visningen forbliver synlig. Brug code til programmatisk håndtering. sourceKey identificerer en host-state-kilde, der fejlede.
object
Skjul egenskaber
string
påkrævet
string
string
Metoder
Kald disse på det handle, som create returnerer, eller via en React-ref.
mount
Monterer elementet i target og begynder indlæsningen. React-komponenter monterer sig selv.Parametre
string | HTMLElement
påkrævet
destroy
Fjerner elementet og frigiver dets frame og abonnementer. Du kan kalde den mere end én gang. React fjerner elementet automatisk.
update
Fletter nye props ind i det monterede element. I React ændrer du i stedet komponentens props.Parametre
Partial<CardElementProps>
påkrævet
Styling
Style disse dele via appearance.classes. Brug camel case eller kebab case til egenskabsnavne, og medtag enheder. Sidens stylesheets kan ikke nå elementets frame. Frameworket validerer hver deklaration, før den indsættes.
Klasse
Rammer
.whop-Card
Rod for kortelementet
.whop-CardError
Fejlpanel for kortkonfiguration
.whop-CardField
Felt til kortnummer, udløbsdato eller sikkerhedskode
.whop-CardFieldError
Valideringsmeddelelse for kort
.whop-CardFieldGroup
Stablede felter til kortnummer, udløbsdato og sikkerhedskode
.whop-CardFieldInput
PCI-inputcontainer med kant
.whop-CardFieldInputFocused
PCI-inputcontainer med fokus
.whop-CardFieldInputInvalid
Ugyldig eller ufuldstændig PCI-inputcontainer
.whop-CardFieldRow
Kompakt række med kortnummer, udløbsdato og sikkerhedskode
I React angiver du appearance til <Payments>. Sæt den globalt med WhopElements({ appearance }).
Parametre
WhopCardElement.Layout
.stacked placerer nummeret over udløbsdato og sikkerhedskode; .compact placerer alle tre på én række. Standard er .stacked.
String?
En avanceret publishable key. Udelad den, så hentes kontoens egen.
Binding<WhopCardState>?
Læser fuldstændigheden og det registrerede kortmærke ud igen.
WhopCardState
Det, et valg returnerer:
isComplete: Bool: alle tre felter er gyldige
brand: String?: det registrerede netværk, så snart nummeret identificerer et
Tilstande
Renderes med det samme og validerer, mens køberen skriver. Kortmærket vises, så snart nummeret identificerer et. state.isComplete bliver true, når alle tre felter er gyldige.
Godt at vide
Brug det i stedet for WhopPaymentElement, når kort er den eneste metode, du tager imod. At montere begge giver en konflikt: controlleren opretter tokenet fra én indsamlende flade.
createConfirmationToken(billingDetails:) kræver et kortholdernavn til kortsporet, så angiv et, eller montér et adresseelement, der indsamler det.
publicKey er en avanceret nødudgang. Udelad den, så henter SDK’et kontoens tokenizer-nøgle.
Montér det inde i et WhopPayments(accountID:charge:)-scope, som opretter controlleren og giver den videre til sit indhold. payments.buyer er den indloggede køber, når en e-mail-login har bekræftet en. WhopBrandingElement skal også være på skærmen, fordi Whop er merchant of record på disse salg, og createConfirmationToken afviser uden det. Style med .whopElementsAppearance(_:). Modulet er Elements, ikke wallet-SDK’ets WhopElements. Se Kom godt i gang og Appearance.
Props
'stacked' | 'compact'
stacked placerer nummeret over udløbsdato og sikkerhedskode. compact placerer alle tre på én række. Standard er stacked.
(payload: CardFieldsChangePayload) => void
Udløses ved hver redigering med fuldstændighed og fejl pr. felt.
StyleProp<ViewStyle>
Anvendes på elementets ydre View. Til temaer bør du foretrække appearance.parts på provideren, som dækker alle elementer på denne flade. Bemærk, at React Native-delnavnene i dag er deres eget sæt, ikke webbens whop-*-klassenavne, så et web-appearance-objekt kan ikke overføres uændret.
ReactNode
Renderes i stedet for det indbyggede skelet, mens elementet indlæses.
() => void
Udløses, når elementet er interaktivt. <Payments> grupperer disse, så dens egen onLoadingChange er som regel den, du vil bruge.
En indlæsnings- eller konfigurationsfejl for dette element. Elementet renderer under alle omstændigheder sin egen fejlvisning.
CardFieldsChangePayload
Det, onChange returnerer:
complete: boolean: alle felter er udfyldt og gyldige
errors: Record<string, string>: meddelelser pr. felt, tom præcis når complete er true
Tilstande
De tre felter renderes samlet, så snart den publishable key er resolveret. onChange rapporterer complete, når alle tre er gyldige, og elementet viser sine egne fejl pr. felt.
Godt at vide
Kortnumre passerer aldrig gennem din kode. Felterne er PCI-isolerede native inputs, og SDK’et giver Whop et token, så din app holdes uden for PCI-scope.
Når dette monteres, bliver kortet providerens indsamlingsflade, så createConfirmationToken tokeniserer det uden ekstra opsætning. Montér det ikke ved siden af et PaymentElement: præcis én indsamlingsflade er aktiv ad gangen.
Til en formular, hvor de tre felter placeres i dit eget layout, skal du i stedet bruge CardFields.
Pak din app ind i <WhopElements getToken={…}> én gang, og montér derefter <Payments> omkring elementerne. Se Kom godt i gang og Appearance.
Assistant
Responses are generated using AI and may contain mistakes.