Skip to main content
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.
Se monte à l’intérieur d’un scope WhopPayments. Un sélecteur de type d’immatriculation à côté de son champ de valeur, présélectionné à partir du pays de l’acheteur.
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>. Un sélecteur de type d’immatriculation à côté d’un champ de valeur, afin qu’un acheteur saisissant un numéro de TVA ou de CUIT choisisse d’abord le bon type.

Données d’exemple. Ouvrir le Playground.

Props

boolean
Désactive les deux champs pendant que l’hôte enregistre la dernière immatriculation validée. Par défaut : false.
string
Pays de l’acheteur au format ISO 3166-1 alpha-2, utilisé pour présélectionner le type. AR sélectionne ar_cuit, LI sélectionne li_uid. Les pays de l’UE et les valeurs non mappées ou vides sélectionnent eu_vat. Les autres pays mappés sélectionnent leur propre premier type. Une sélection manuelle est conservée lors des changements de pays. Par défaut : "".
object
type et value initiaux provenant d’une session reprise. Un type non pris en charge se rabat sur la valeur par défaut du pays.
string
Erreur de validation de l’API affichée sous le champ de valeur. Vide (par défaut), rien n’est affiché. Par défaut : "".

Événements

Transmettez les callbacks dans les options de création ou dans les props React.

onChange

Se déclenche à la perte du focus ou sur Entrée lorsque la valeur n’est pas vide, ou lorsque le type change alors qu’une valeur est présente. Des valeurs consécutives identiques ne déclenchent qu’une fois. Effacer la valeur ne déclenche rien. L’hôte doit effacer les immatriculations enregistrées.
object

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

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<TaxIdElementProps>
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.
Avec React, transmettez appearance à <Payments>. Définissez-la globalement avec WhopElements({ appearance }).

Paramètres

Binding<WhopTaxID?>?
Reçoit chaque immatriculation validée.
String?
Pays de l’acheteur au format ISO 3166-1 alpha-2, utilisé pour présélectionner le type.
WhopTaxID?
Une paire initiale provenant d’une session reprise. Un type non pris en charge se rabat sur la valeur par défaut.
Bool
Désactive les deux champs pendant que vous enregistrez la dernière immatriculation validée. Par défaut : false.
String?
Une erreur de validation de l’API, affichée sous le champ de valeur.

WhopTaxID

Ce que renvoie une sélection :
  • type: WhopTaxIDType : le type d’immatriculation, eu_vat, ar_cuit, …
  • value: String : l’immatriculation elle-même

États

S’affiche immédiatement. Une valeur qui ne correspond pas au format du type sélectionné affiche son erreur. error affiche un échec de validation de l’API sous le champ de valeur.

Bon à savoir

  • AR présélectionne ar_cuit ; les membres de l’UE et tout pays non mappé présélectionnent eu_vat. Un choix manuel est conservé lors des changements de pays.
  • Transmettez le pays issu de l’élément d’adresse pour que les deux restent synchronisés.
  • Le binding se déclenche à chaque immatriculation validée, et non à chaque frappe.

Installation

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

string
Pays de l’acheteur au format ISO 3166-1 alpha-2, utilisé pour présélectionner le type. AR sélectionne ar_cuit ; les valeurs UE et non mappées sélectionnent eu_vat.
{ type: string; value: string }
Paire initiale provenant d’une session reprise. Un type non pris en charge se rabat sur la valeur par défaut.
boolean
Désactive les deux champs, le temps que vous enregistriez la dernière immatriculation validée.
string
Un message de validation provenant de votre API, affiché sous le champ de valeur.
(payload: TaxIdChangePayload) => void
Se déclenche à chaque changement de type ou de valeur.
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.
(error: { message: string; code?: string }) => void
Un échec de chargement ou de configuration pour cet élément. L’élément affiche sa propre vue d’erreur dans tous les cas.

TaxIdChangePayload

Ce que renvoie onChange :
  • taxId: { type: TaxIdType; value: string } : le type d’immatriculation sélectionné et ce que l’acheteur a saisi

États

S’affiche immédiatement. Le type est présélectionné à partir de country et le champ de valeur est validé selon le format de ce type. onChange se déclenche avec la paire courante.

Bon à savoir

  • country ne fait que présélectionner. Un acheteur qui choisit un type manuellement le conserve lors des changements de pays.
  • Transmettez error pour afficher un message issu de votre propre validation d’API sous le champ de valeur.
  • L’élément signale la paire. Son envoi vous revient : associez-la à votre propre commande ou fiche client.
Enveloppez votre application dans <WhopElements getToken={…}> une seule fois, puis montez <Payments> autour des éléments. Consultez Premiers pas et Apparence.