Champs préagencés pour le numéro de carte, la date d’expiration et le code de sécurité. Créez-le avec payments.create("card"), activez votre bouton de paiement depuis onChange et confirmez avec payments.createConfirmationToken(). Les numéros de carte restent dans des champs hébergés isolés PCI. layout prend en charge stacked (par défaut) et compact.
Cette page documente @whop/elements@1.10.0 et @whop/elements-react@1.10.0.
Depuis v1.0.0.
Se monte à l’intérieur de Payments. Transmettez les props et les callbacks via les options de création ou les props React.
Exclusif.CardElement est une alternative à PaymentElement ou CardFields dans ce handle Payments. Montez-en un seul à la fois. Détruisez-le avant d’en monter un autre.
Attend BrandingElement. Cet élément reste dans son état de chargement tant que BrandingElement n’est pas monté dans le même handle Payments.
Se monte à l’intérieur d’un scope WhopPayments. Les trois saisies de carte réunies en une seule unité, isolées PCI par le tokenizer : le numéro, la date d’expiration et le code de sécurité n’entrent donc jamais dans votre processus.
Montez-le à l’intérieur de <Payments>, qui gère le débit et le jeton de confirmation. <Payments> se monte lui-même à l’intérieur de <WhopElements>. Utilisez-le lorsque le formulaire accepte une carte et rien d’autre : il s’enregistre lui-même comme surface de collecte, de sorte que createConfirmationToken le tokenise sans aucun autre branchement.
stacked (par défaut) place le numéro de carte au-dessus de la date d’expiration et du code de sécurité. compact place les trois sur une seule ligne. Par défaut : "stacked".
Événements
Transmettez les callbacks dans les options de création ou dans les props React.
onChange
Se déclenche lorsque les champs de carte changent. complete passe à true une fois que l’acheteur a rempli les trois. Utilisez-le pour activer la confirmation. brand est le réseau de carte détecté. funding est le type de financement détecté (credit, debit ou prepaid), null tant que le numéro n’en identifie pas un. issuingCountry est le code à deux lettres en minuscules du pays d’émission de la carte, null tant que le numéro n’en identifie pas un.
object
Masquer propriétés
boolean
requis
string
requis
string | null
requis
string | null
requis
onLoaderStart
S’exécute après le premier affichage du squelette de chargement et avant onReady.
onReady
S’exécute après le premier affichage complet de l’élément.
onError
S’exécute lorsque l’élément ne parvient pas à se charger ou plante. L’affichage de repli reste visible. Utilisez code pour une gestion programmatique. sourceKey identifie une source d’état hôte en échec.
object
Masquer propriétés
string
requis
string
string
Méthodes
Appelez-les sur le handle renvoyé par create, ou via une ref React.
mount
Monte l’élément dans target et démarre le chargement. Les composants React se montent eux-mêmes.Paramètres
string | HTMLElement
requis
destroy
Supprime l’élément et libère son frame et ses abonnements. Vous pouvez l’appeler plusieurs fois. React supprime l’élément automatiquement.
update
Fusionne de nouvelles props dans l’élément monté. Avec React, modifiez plutôt les props du composant.Paramètres
Partial<CardElementProps>
requis
Style
Stylisez ces parties via appearance.classes. Utilisez le camel case ou le kebab case pour les noms de propriétés et incluez les unités. Les feuilles de style de la page ne peuvent pas atteindre le frame de l’élément. Le framework valide chaque déclaration avant de l’injecter.
Classe
Cible
.whop-Card
Racine de l’élément de carte
.whop-CardError
Panneau d’erreur de configuration de la carte
.whop-CardField
Champ du numéro de carte, de la date d’expiration ou du code de sécurité
.whop-CardFieldError
Message de validation de la carte
.whop-CardFieldGroup
Champs empilés du numéro de carte, de la date d’expiration et du code de sécurité
.whop-CardFieldInput
Conteneur de saisie PCI avec bordure
.whop-CardFieldInputFocused
Conteneur de saisie PCI ayant le focus
.whop-CardFieldInputInvalid
Conteneur de saisie PCI invalide ou incomplet
.whop-CardFieldRow
Ligne compacte du numéro de carte, de la date d’expiration et du code de sécurité
Avec React, transmettez appearance à <Payments>. Définissez-la globalement avec WhopElements({ appearance }).
Paramètres
WhopCardElement.Layout
.stacked place le numéro au-dessus de la date d’expiration et du code de sécurité ; .compact place les trois sur une seule ligne. Par défaut : .stacked.
String?
Une clé publiable avancée. Omettez-la et celle du compte est récupérée.
Binding<WhopCardState>?
Relit l’état de complétude et la marque détectée.
WhopCardState
Ce que renvoie une sélection :
isComplete: Bool : les trois champs sont valides
brand: String? : le réseau détecté, dès que le numéro en identifie un
États
S’affiche immédiatement et valide au fil de la saisie de l’acheteur. La marque apparaît dès que le numéro en identifie une. state.isComplete passe à true lorsque les trois champs sont valides.
Bon à savoir
Utilisez-le à la place de WhopPaymentElement lorsque la carte est le seul moyen de paiement que vous acceptez. Monter les deux crée un conflit : le contrôleur génère le jeton à partir d’une seule surface de collecte.
createConfirmationToken(billingDetails:) nécessite le nom du titulaire de la carte pour le paiement par carte : transmettez-en un ou montez un élément d’adresse qui le collecte.
publicKey est une option avancée de contournement. Omettez-la et le SDK récupère la clé de tokenizer du compte.
Montez-le à l’intérieur d’un scope WhopPayments(accountID:charge:), qui crée le contrôleur et le transmet à son contenu. payments.buyer est l’acheteur connecté dès qu’une connexion par e-mail en a authentifié un. WhopBrandingElement doit aussi être à l’écran, car Whop est le marchand officiel (merchant of record) de ces ventes et createConfirmationToken refuse sans lui. Stylisez avec .whopElementsAppearance(_:). Le module est Elements, et non WhopElements du SDK wallet. Consultez Premiers pas et Apparence.
Props
'stacked' | 'compact'
stacked place le numéro au-dessus de la date d’expiration et du code de sécurité. compact place les trois sur une seule ligne. Par défaut : stacked.
(payload: CardFieldsChangePayload) => void
Se déclenche à chaque modification avec l’état de complétude et les erreurs par champ.
StyleProp<ViewStyle>
Appliqué à la View externe de l’élément. Pour la personnalisation du thème, préférez appearance.parts sur le provider, qui couvre tous les éléments de cette interface. Notez que les noms de parties React Native forment aujourd’hui leur propre ensemble, distinct des noms de classes whop-* du web : un objet appearance web ne peut donc pas être repris tel quel.
ReactNode
Affiché à la place du squelette intégré pendant le chargement de l’élément.
() => void
Se déclenche une fois que l’élément est interactif. <Payments> les regroupe, donc c’est généralement son propre onLoadingChange qu’il vous faut.
Un échec de chargement ou de configuration pour cet élément. L’élément affiche sa propre vue d’erreur dans tous les cas.
CardFieldsChangePayload
Ce que renvoie onChange :
complete: boolean : chaque champ est rempli et valide
errors: Record<string, string> : messages par champ, vide exactement lorsque complete vaut true
États
Les trois champs s’affichent ensemble une fois la clé publiable résolue. onChange signale complete lorsque les trois sont valides, et l’élément affiche ses propres erreurs par champ.
Bon à savoir
Les numéros de carte ne passent jamais par votre code. Les champs sont des saisies natives isolées PCI, et le SDK transmet un jeton à Whop : votre application reste donc hors du périmètre PCI.
Le monter fait de la carte la surface de collecte du provider, de sorte que createConfirmationToken la tokenise sans branchement supplémentaire. Ne le montez pas à côté d’un PaymentElement : une seule surface de collecte est active à la fois.
Pour un formulaire où les trois champs s’insèrent dans votre propre mise en page, utilisez plutôt CardFields.
Enveloppez votre application dans <WhopElements getToken={…}> une seule fois, puis montez <Payments> autour des éléments. Consultez Premiers pas et Apparence.
Assistant
Responses are generated using AI and may contain mistakes.