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 Payments. Maak het aan om een handle te krijgen en mount vervolgens de elementen op die handle. Roep destroy() aan om de subcontroller te verwijderen en zijn plek vrij te maken. Maak het opnieuw aan om een nieuwe handle te krijgen.
Exclusief. CardFields is een alternatief voor PaymentElement of CardElement in deze Payments-handle. Mount er één tegelijk. Verwijder het voordat je een ander mount.

Voorbeeld

Een live, interactieve demo van de standaardindeling van deze subcontroller met voorbeeldgegevens:
Wordt gemount binnen een WhopPayments-scope. Dezelfde drie gehoste invoervelden als WhopCardElement, één voor één geplaatst binnen de content-builder, zodat jouw eigen lay-out bepaalt waar elk veld staat.
De provider voor afzonderlijk geplaatste kaartvelden. Wikkel het deel van je formulier dat ze bevat erin en plaats CardNumberElement, CardExpiryElement en CardCvcElement waar je lay-out ze nodig heeft.

Voorbeeld

Draaiend in de React Native-voorbeeldapp:

Opties

Geef deze mee aan payments.create('cardFields', { … }), of als props op <CardFields> in React. Props die door de parent worden geïnjecteerd, verschijnen hier nooit.
CardNetworkArt[]
De door de verkoper geaccepteerde kaartnetwerken in weergavevolgorde — de networks-objecten van de kaartvermelding in de matrix, waarvan de door de API geleverde iconen de merkafbeelding van het nummerveld bepalen. Laat het weg om het samen met de sleutel op te halen.
"compact" | "stacked"
stacked (standaard) vormt samengestelde velden als een nummerrij boven de vervaldatum en beveiligingscode. compact vormt één rij. Afzonderlijk gemounte velden negeren deze lay-out en worden weergegeven met volledige randen en afgeronde hoeken. Standaard "stacked".
string
Geavanceerde publiceerbare sleutel van Basis Theory. Laat deze weg om de sleutel automatisch op te halen.

Events

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

onChange

Wordt geactiveerd wanneer de volledigheid verandert. complete wordt true nadat de koper alle drie de velden heeft ingevuld. Gebruik het om bevestigen mogelijk te maken. brand is het herkende kaartnetwerk zoals het veld het meldt; network is dezelfde herkenning in de netwerkterminologie van de API (komt overeen met de networks van de kaartvermelding in de matrix, null zolang onbekend). last4 zijn de laatste vier cijfers van het nummer, null totdat het nummer ver genoeg is ingevuld. 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

Methoden

Roep deze aan op de subhandle van payments.create('cardFields', { … }).

tokenize

Geavanceerde methode die de drie velden tokeniseert zonder een bevestigingstoken aan te maken. Het verstuurt tokenized naar de payments-controller. Validatiefouten verschijnen bij het veld dat faalt, en de methode gooit een fout. Gebruik payments.createConfirmationToken() om een betaling te bevestigen.Parameters
object
vereist
Retourneert Promise<object>
string
vereist

collect

payments.createConfirmationToken() roept deze actie aan voor cardFields. Roep haar niet rechtstreeks aan. Ze tokeniseert de velden en retourneert de gegevens die worden gebruikt om het bevestigingstoken aan te maken.Parameters
object
vereist
Retourneert Promise<object>
object
vereist
object
vereist

update

Voegt nieuwe props en callbacks samen in de subcontroller.Parameters
Partial<CardFieldsSubOptions>
vereist

destroy

Verwijdert de subcontroller en zijn elementen en maakt daarna zijn exclusieve plek vrij. Een latere create("cardFields") begint opnieuw.

Parameters

String?
Een geavanceerde publiceerbare sleutel. Laat je die weg, dan wordt de eigen sleutel van het account opgehaald.
WhopCardElement.Layout
Wordt alleen gelezen wanneer een samenstellende eenheid de velden zelf rangschikt. Afzonderlijk gemounte velden negeren het.
Binding<WhopCardState>?
Leest de volledigheid en het herkende merk terug.
() -> Content
vereist
Waar de drie veldweergaven komen. Al het andere hierin wordt normaal weergegeven.

WhopCardState

Wat een selectie teruggeeft:
  • isComplete: Bool: alle drie de velden zijn geldig
  • brand: String?: het herkende netwerk

Statussen

Elk veld wordt direct weergegeven en valideert terwijl de koper typt. state.isComplete wordt true wanneer alle drie geldig zijn, waar je ze ook plaatst.

Goed om te weten

  • De drie veldweergaven werken alleen binnen een WhopCardFields-builder: ze lezen de eenheid die die aanmaakt. Elders gemount geven ze niets weer.
  • Mount alle drie. Een eenheid waarin er een ontbreekt, wordt nooit volledig, dus de bevestigingsknop wordt nooit ingeschakeld.

Installatie

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

ReactNode
vereist
Je lay-out, met de drie veldelementen ergens daarbinnen.
string
Een geavanceerde publiceerbare sleutel voor de tokenizer. Laat je die weg, dan haalt de SDK de sleutel van het account zelf op.
'stacked' | 'compact'
Vormt velden die samen zijn samengesteld. Afzonderlijk gemounte velden negeren het en worden weergegeven met volledige randen. Standaard stacked.
(payload: CardFieldsChangePayload) => void
Wordt bij elke wijziging geactiveerd met de gecombineerde status van de gemounte velden.

CardFieldsChangePayload

Wat onChange teruggeeft:
  • complete: boolean: elk gemount veld is ingevuld en geldig
  • errors: Record<string, string>: meldingen per veld, met de sleutels cardNumber, cardExpiry, cardCvc

Statussen

De children worden weergegeven zodra de publiceerbare sleutel is opgehaald. onChange meldt de gecombineerde status van elk gemount veld, zodat één handler de hele kaart dekt.

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.
  • Elk veld moet binnen dezelfde CardFields staan. Ze delen één tokenisatie, dus een veld dat daarbuiten is gemount, verzamelt niets.
  • CardFields registreert het verzameloppervlak, zodat createConfirmationToken de kaart tokeniseert zonder extra koppeling.
  • Het ophalen van de publiceerbare sleutel gebeurt automatisch. Geef publicKey alleen mee als je er al een hebt.
Wikkel je app eenmaal in <WhopElements getToken={…}> en mount daarna <Payments> rond de elementen. Zie Aan de slag en Appearance.

Elementen

De elementen die deze subcontroller mount. Elk heeft een eigen pagina:

CardNumberElement

PCI-geïsoleerd gehost veld voor het kaartnummer. Kaartnummers bereiken de hostpagina nooit.

CardExpiryElement

PCI-geïsoleerd gehost veld voor de vervaldatum van de kaart.

CardCvcElement

PCI-geïsoleerd gehost veld voor de beveiligingscode van de kaart.