La mention de marchand officiel (merchant of record) de Whop : l’acceptation par l’acheteur des conditions d’utilisation acheteur et de la politique de confidentialité de Whop, avec le logotype Whop. Obligatoire — les éléments de paiement, de carte et de champs de carte restent dans leur état de chargement tant qu’il n’est pas monté, et les paiements ne peuvent pas être confirmés sans lui.
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.
Obligatoire. Les autres éléments d’un handle Payments, à l’exception de AddressElement, EmailElement et TaxIdElement, restent dans leur état de chargement tant que BrandingElement n’est pas monté — montez-le à côté d’eux.
Se monte à l’intérieur d’un scope WhopPayments. La ligne de marchand officiel que chaque interface de paiement doit afficher, avec le logotype Whop dessiné sous forme de tracé.
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>. Obligatoire sur chaque formulaire de collecte : createConfirmationToken refuse tant qu’aucun n’est monté, et il adopte le thème du reste de votre formulaire.
import { BrandingElement, Payments } from '@whop/elements-react-native';<Payments accountId="biz_xxxxxxxx" plan="plan_xxxxxxxx"> {/* your form */} <BrandingElement /></Payments>
Transmettez les callbacks dans les options de création ou dans les props React.
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<BrandingElementProps>
requis
Style
Cet élément n’expose pas de noms de classes pour le style. Utilisez appearance (thème, couleur d’accent, variables) pour modifier son apparence.
États
S’affiche immédiatement. Il ne récupère rien et n’a pas d’état d’échec.
Bon à savoir
createConfirmationToken refuse tant qu’il n’est pas monté. Whop est le marchand officiel de ces ventes, l’acheteur doit donc en être informé sur l’écran où il paie.
Le logotype est un tracé vectoriel, pas un fichier, donc le framework n’embarque aucun bundle d’images.
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
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.
États
S’affiche immédiatement. Il n’a aucune donnée à charger ni d’états propres.
Bon à savoir
Obligatoire. createConfirmationToken refuse avec une BrandingRequiredError tant qu’aucun BrandingElement n’est monté, exactement comme les éléments web retardent leur affichage jusqu’à ce que la mention de marque soit attachée.
Montez-le une seule fois n’importe où à l’intérieur de <Payments>, généralement sous votre bouton de soumission.
Le logotype suit de lui-même l’apparence claire ou sombre du thème résolu.
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.