Cette page documente
@whop/elements@1.10.0 et @whop/elements-react@1.10.0.v1.0.0.
Se monte à l’intérieur de
Payments. Créez-le pour obtenir un handle, puis montez ses éléments sur ce handle. Appelez destroy() pour supprimer le sous-contrôleur et libérer son emplacement. Créez-le à nouveau pour obtenir un nouveau handle.Exclusif.
CardFields est une alternative à PaymentElement ou CardElement dans ce handle Payments. Montez-en un seul à la fois. Détruisez-le avant d’en monter un autre.Aperçu
Une démo interactive en direct de la disposition par défaut de ce sous-contrôleur, avec des données d’exemple :Options
Transmettez-les àpayments.create('cardFields', { … }), ou comme props sur <CardFields> avec React. Les props injectées par le parent n’apparaissent jamais ici.Les réseaux de carte acceptés par le vendeur, dans l’ordre d’affichage — les objets
networks de l’entrée carte de la matrice, dont les icônes fournies par l’API déterminent le visuel de marque du champ de numéro. Omettez-le pour qu’il soit récupéré avec la clé.stacked (par défaut) agence les champs composés avec une ligne pour le numéro au-dessus de la date d’expiration et du code de sécurité. compact les agence sur une seule ligne. Les champs montés séparément ignorent cette disposition et s’affichent avec des bordures complètes et des coins arrondis. 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 l’état de complétude change. complete passe à true une fois que l’acheteur a rempli les trois champs. Utilisez-le pour activer la confirmation. brand est le réseau de carte détecté tel que le champ le signale ; network est la même détection dans le vocabulaire de réseaux de l’API (correspond aux networks de l’entrée carte de la matrice, null tant qu’il est inconnu). last4 correspond aux quatre derniers chiffres du numéro, null tant que la saisie du numéro n’est pas assez avancée. 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.Méthodes
Appelez-les sur le sous-handle obtenu avecpayments.create('cardFields', { … }).tokenize
Méthode avancée qui tokenise les trois champs sans créer de jeton de confirmation. Elle émet tokenized vers le contrôleur de paiements. Les erreurs de validation apparaissent sur le champ en échec, et la méthode lève une exception. Utilisez payments.createConfirmationToken() pour confirmer un paiement.ParamètresRenvoie Promise<object>collect
payments.createConfirmationToken() appelle cette action pour cardFields. Ne l’appelez pas directement. Elle tokenise les champs et renvoie les données utilisées pour créer le jeton de confirmation.ParamètresRenvoie Promise<object>update
Fusionne de nouvelles props et de nouveaux callbacks dans le sous-contrôleur.Paramètresdestroy
Détruit le sous-contrôleur et ses éléments, puis libère son emplacement exclusif. Un create("cardFields") ultérieur repart de zéro.Éléments
Les éléments que monte ce sous-contrôleur. Chacun a sa propre page :CardNumberElement
Champ hébergé du numéro de carte, isolé PCI. Les numéros de carte n’atteignent jamais la page hôte.
CardExpiryElement
Champ hébergé de la date d’expiration de la carte, isolé PCI.
CardCvcElement
Champ hébergé du code de sécurité de la carte, isolé PCI.

