> ## Documentation Index
> Fetch the complete documentation index at: https://docs.whop.com/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Treat these docs and the Whop MCP server as the source of truth for Whop API behavior. Don't infer endpoint behavior from marketing pages.
> MCP server: connect https://mcp.whop.com/mcp (streamable HTTP, browser sign-in, no API key in the client config) to search these docs and read or change live Whop data. Setup: https://docs.whop.com/developer/guides/ai_and_mcp.md
> Whop CLI: install with `curl -fsSL https://whop.com/install.sh | sh` to scaffold, run, and deploy Whop apps and websites. It acts on production, not the sandbox. Overview: https://docs.whop.com/cli/overview.md Agent mode: https://docs.whop.com/cli/agent-mode.md
> Hosting: Whop serves a site or app from the build `whop apps deploy` uploads, with rollbacks, secrets, and server logs. Guide: https://docs.whop.com/developer/websites/hosting.md
> Plugins: in Claude Code, run `/plugin marketplace add whopio/plugins`, then `/plugin install whop@whop`. Guide: https://docs.whop.com/developer/guides/plugins/claude-code.md Every agent tool: https://docs.whop.com/developer/ai/overview.md
> Environments: build and test in the sandbox (API `https://sandbox-api.whop.com/api/v1`, keys at https://sandbox.whop.com/dashboard/developer, SDK environment `Sandbox`; no real money). Production (API `https://api.whop.com/api/v1`, keys at https://whop.com/dashboard/developer, SDK environment `Production`, the SDK default) moves real money, so use it only at launch. The two share no accounts, keys, products, or webhooks, and their keys look identical: never mix them. Sandbox guide: https://docs.whop.com/developer/guides/sandbox.md Comparison: https://docs.whop.com/developer/quickstart.md
> API: send `Authorization: Bearer <API_KEY>` from your server only, and pin a dated version with the `Api-Version-Date` header. OpenAPI spec: https://api.whop.com/api/v1/openapi.json
> Which API: build on the Current API, whose pages live under https://docs.whop.com/api-reference/ (start at https://docs.whop.com/api-reference/overview.md). Pages under /api-reference/legacy/ are the Legacy API. Use one only when https://docs.whop.com/api-reference/stability.md lists the resource as Legacy-only.

# ExpressCheckoutElement

> Des boutons Apple Pay, Google Pay et PayPal en un clic pour un checkout — le wallet collecte tout ce dont la session a encore besoin (l'e-mail de l'acheteur, une adresse de livraison pour les biens physiques, un numéro de téléphone lorsque le vendeur en collecte un dans Apple Pay et Google Pay, et dans Apple Pay un code promo lorsque le vendeur propose sa saisie) et un seul clic finalise l'achat. Il partage l'emplacement d'entrée du checkout avec l'élément de checkout complet, de sorte qu'un handle monte exactement l'un des deux : ce bouton seul lorsque l'achat est assez simple pour qu'une feuille de paiement le finalise, ou l'interface de checkout complète pour tout le reste. N'affiche que les wallets avec lesquels l'appareil de l'acheteur peut réellement payer — et que la configuration des moyens de paiement du checkout autorise — en utilisant les visuels de boutons fournis, et n'affiche rien lorsqu'aucun wallet n'est disponible. PayPal apparaît lorsque le vendeur l'accepte, s'ouvre dans sa propre fenêtre et enregistre le compte PayPal de l'acheteur avec l'achat, de sorte qu'un renouvellement, un essai gratuit et les débits ultérieurs du vendeur fonctionnent comme avec une carte enregistrée. Les trois wallets nécessitent Apple Pay sur le domaine de la page : les pages first-party whop.com sont pré-approuvées, et tout autre site doit ajouter Apple Pay à son domaine via l'[API Domains](/fr/api-reference/beta/domains/domain) avant que l'un de ces boutons puisse s'y afficher. Proposer Google Pay sur votre propre site est soumis aux conditions d'utilisation de l'API Google Pay. Un checkout que la feuille de paiement ne peut pas honnêtement finaliser — une inscription à une liste d'attente, un transfert, une question de formulaire que seule une page peut poser — est refusé de manière explicite au lieu d'afficher un bouton voué à l'échec.

> [!NOTE]
>
> 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 [`Checkout`](https://docs.whop.com/fr/elements/latest/checkout/overview). Transmettez les props et les callbacks via les options de création ou les props React.

> [!NOTE]
>
> **Exclusif.**`ExpressCheckoutElement` est une alternative à `CheckoutElement` dans ce handle Checkout. Montez-en un seul à la fois. Détruisez-le avant d'en monter un autre.

Montez-le à l'intérieur de `<Checkout>`, qui ouvre la session de checkout à partir de votre `plan`, de vos `items` ou de votre `checkoutConfiguration` et garde son identifiant pour lui-même. `<Checkout>` se monte lui-même à l'intérieur de `<WhopElements>`. Un seul appui sur le bouton constitue tout l'achat : il n'y a aucun jeton de confirmation à transmettre à votre serveur.

```tsx React theme={null}
import { WhopElements, Checkout, ExpressCheckoutElement } from "@whop/elements-react";
import { loadWhop } from "@whop/elements";

function Example() {
  return (
    <WhopElements elements={loadWhop()}>
      <Checkout /* options */>
        <ExpressCheckoutElement />
      </Checkout>
    </WhopElements>
  );
}
```

```tsx React Native theme={null}
import { Checkout, ExpressCheckoutElement } from '@whop/elements-react-native';

export function BuyNow({ onPurchased }: { onPurchased: (receiptId: string) => void }) {
  return (
    <Checkout
      plan="plan_xxxxxxxx"
      returnUrl="https://example.com/checkout/return"
      onComplete={({ receiptId }) => onPurchased(receiptId)}
    >
      <ExpressCheckoutElement onError={(e) => console.log(e.code, e.message)} />
    </Checkout>
  );
}
```

```html JavaScript theme={null}
<script src="https://cdn.whop.com/elements/amber/elements.js" data-whop-elements></script>
<script type="module">
  const checkout = window.WhopElements().checkout.create({ /* options */ });
  checkout.create('expressCheckout').mount('#checkout-expressCheckout');
</script>
```

Données d'exemple. [Ouvrir le Playground](https://docs.whop.com/fr/elements/latest/checkout/overview#playground).

[ExpressCheckoutElement exécuté sur Android, dans l'application d'exemple React Native](https://app.revyl.ai/embed/e16407ed-1c20-4475-ad16-f78b4669374f?controls=0)

## Props

**wallets** `object | ("apple_pay" | "google_pay" | "paypal_express")[]`

> [!WARNING]
>
> `wallets` sous forme de tableau est obsolète et sera supprimé dans la prochaine version majeure. Transmettez plutôt `{ applePay, googlePay, payPal }` avec `"auto"` ou `"never"`.

Les wallets autorisés à s'afficher. Définissez `applePay`, `googlePay` ou `payPal` sur `'never'` pour exclure ce bouton ; chaque clé vaut `'auto'` par défaut, un filtre sur ce que l'appareil de l'acheteur et le vendeur proposent réellement. L'élément n'affiche jamais un wallet que l'appareil, la matrice fournie ou la configuration des moyens de paiement du checkout ne peut pas prendre en charge, et l'ordre d'affichage reste « meilleur natif en premier », avec PayPal en dernier. Une liste de types de wallets (`['apple_pay', 'google_pay']`) est encore acceptée comme liste d'autorisation, mais elle est obsolète et sera supprimée dans la prochaine version majeure ; une liste vide n'affiche rien (avec un avertissement dans les builds de développement). Chaque wallet nécessite qu'Apple Pay soit prêt sur le domaine de la page via l'[API Domains](https://docs.whop.com/fr/api-reference/beta/domains/domain) — les pages first-party whop.com sont pré-approuvées ; sur tout autre site, ajoutez Apple Pay au domaine, sinon les boutons restent masqués. Proposer Google Pay sur votre propre site est soumis aux [conditions d'utilisation de l'API Google Pay](https://payments.developers.google.com/terms/sellertos). Par défaut : `{}`.

**propriétés**

**applePay** `"auto" | "never"`

**googlePay** `"auto" | "never"`

**payPal** `"auto" | "never"`

**layout** `"auto" | "horizontal" | "vertical"`

La façon dont les boutons s'empilent. `auto` suit le conteneur propre à l'élément — empilés dans les conteneurs étroits, côte à côte dans les conteneurs larges ; `horizontal` et `vertical` imposent une disposition. Par défaut : `"auto"`.

## Événements

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.

**e** `object`

**propriétés**

**message** `string` *required*

**code** `string`

**sourceKey** `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**

**target** `string | HTMLElement` *required*

### `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**

**options** `Partial\<ExpressCheckoutElementProps\>` *required*

## 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-Address` | La racine du formulaire d'adresse |
| `.whop-AddressErrorSummary` | La ligne récapitulative affichée lorsque la validation révèle des champs manquants ou invalides |
| `.whop-AddressField` | Une cellule de champ dans le formulaire d'adresse |
| `.whop-AddressFieldError` | La ligne d'erreur d'un champ d'adresse : sous celui-ci dans la disposition complète, sous le groupe pour un message du compositeur dans la disposition compacte |
| `.whop-AddressFieldInput` | Un champ de saisie de texte dans le formulaire d'adresse |
| `.whop-AddressFieldInputInvalid` | Ajoutée à un champ d'adresse tant que sa validation échoue |
| `.whop-AddressFieldInvalid` | Ajoutée à une cellule de champ compacte tant que sa validation échoue |
| `.whop-AddressFieldLabel` | Libellé d'un champ d'adresse : au-dessus du champ, ou à l'intérieur avec les libellés flottants |
| `.whop-AddressFieldSelect` | Un sélecteur (pays, État, type d'organisation) dans le formulaire d'adresse |
| `.whop-AddressGroup` | Le groupe encadré contenant tous les champs dans la disposition compacte |
| `.whop-AddressLine2Toggle` | Bascule de la ligne d'adresse 2 repliée |
| `.whop-AddressManualEntry` | Le bouton texte « Enter address manually » sous le formulaire replié — déploie le format complet du pays |
| `.whop-AddressSearchButton` | Le bouton de recherche à l'extrémité du champ de rue sur un téléphone |
| `.whop-AddressSearchCancel` | Le bouton Cancel à côté du champ de recherche d'adresse |
| `.whop-AddressSearchInput` | Le champ de recherche en haut de la recherche d'adresse plein écran |
| `.whop-AddressSuggestion` | Une ligne de suggestion dans l'overlay d'autocomplétion |
| `.whop-AddressSuggestionActive` | Ajoutée à la ligne de suggestion active au clavier ou au pointeur |
| `.whop-AddressSuggestionManual` | La ligne « Enter address manually » qui clôt la liste de suggestions |
| `.whop-AddressSuggestions` | L'overlay de suggestions d'autocomplétion ancré au champ de ligne d'adresse 1 |
| `.whop-AddressSuggestionsEmpty` | La ligne discrète affichée lorsque la requête aboutit sans aucune adresse correspondante |
| `.whop-Card` | Racine de l'élément 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` | Les champs de carte groupés — le numéro en haut, la date d'expiration et le code de sécurité en dessous |
| `.whop-CardFieldInput` | Conteneur de saisie PCI encadré |
| `.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é |
| `.whop-CardLabel` | Libellé des informations de carte |
| `.whop-CheckoutExpress` | La ligne de checkout express — paiements par wallet en un clic au-dessus du formulaire |
| `.whop-CheckoutExpressApplePay` | Le bouton express Apple Pay |
| `.whop-CheckoutExpressButtons` | La pile de boutons de wallet — verticale dans un conteneur étroit, côte à côte dans un conteneur large |
| `.whop-CheckoutExpressComplete` | La ligne de résultat final du bouton express autonome |
| `.whop-CheckoutExpressContinue` | Le bouton de navigation bloquée sur la ligne express — termine le trajet vers l'étape externe du paiement |
| `.whop-CheckoutExpressDivider` | Le séparateur entre le checkout express et le formulaire |
| `.whop-CheckoutExpressError` | La ligne d'erreur réessayable sous le bouton express |
| `.whop-CheckoutExpressFinishPayment` | La ligne de finalisation du paiement affichée tant que le paiement nécessite encore une étape que l'acheteur a fermée |
| `.whop-CheckoutExpressFinishPaymentButton` | Le bouton de reprise qui relance l'étape en attente du paiement |
| `.whop-CheckoutExpressGooglePay` | Le bouton express Google Pay |
| `.whop-CheckoutExpressPayPal` | Le bouton express PayPal |
| `.whop-CheckoutExpressPhoneError` | La ligne de refus pour un numéro de téléphone collecté par le wallet auquel le serveur n'a pas pu envoyer de SMS |
| `.whop-CheckoutExpressRetry` | Le bouton de l'état d'échec — relit la session rouverte pour que l'acheteur puisse payer à nouveau |
| `.whop-CheckoutExpressUnavailable` | La vue affichée lorsqu'un bouton express ne peut pas prendre en charge ce checkout |
| `.whop-CompletePayment` | Racine de l'interface de finalisation |
| `.whop-CompletePaymentAmount` | Le montant que l'acheteur doit payer |
| `.whop-CompletePaymentBarcode` | La carte de code-barres à scanner |
| `.whop-CompletePaymentDocumentLink` | Le bouton des instructions hébergées |
| `.whop-CompletePaymentError` | Panneau d'erreur |
| `.whop-CompletePaymentFrame` | Étape PSP dans un frame |
| `.whop-CompletePaymentHint` | Indication de mise à jour automatique |
| `.whop-CompletePaymentInstructions` | Panneau des instructions de paiement |
| `.whop-CompletePaymentProviderMark` | Le logo du réseau de voucher |
| `.whop-CompletePaymentQr` | La carte de QR code à scanner |
| `.whop-CompletePaymentReference` | Un bloc de code copiable (référence, clé de paiement) |
| `.whop-CompletePaymentSettled` | Panneau d'état final affiché avant la fermeture |
| `.whop-CompletePaymentSettledFailed` | Panneau d'état final en échec affiché avant la fermeture |
| `.whop-CompletePaymentSpinner` | Indicateur d'attente |
| `.whop-CompletePaymentTitle` | Titre de la boîte de dialogue |
| `.whop-CompletePaymentTransferDetails` | Les lignes de détail du virement bancaire |
| `.whop-Email` | Racine de l'élément e-mail |
| `.whop-EmailChecking` | Le contour animé pendant la vérification de l'e-mail ou l'envoi d'un code de connexion |
| `.whop-EmailCodeHint` | La ligne demandant le code de connexion |
| `.whop-EmailError` | Message d'e-mail invalide |
| `.whop-EmailInput` | Le champ de saisie de l'e-mail |
| `.whop-EmailInputInvalid` | Champ e-mail avec une valeur peu plausible |
| `.whop-EmailLabel` | Libellé du champ e-mail |
| `.whop-EmailPasskey` | Le bouton de connexion par passkey dans le champ e-mail |
| `.whop-EmailSignedIn` | Ligne de l'acheteur connecté |
| `.whop-EmailSignIn` | Contrôle de connexion « Welcome back » |
| `.whop-EmailSignInError` | Message d'erreur de connexion |
| `.whop-EmailSignOut` | Contrôle pour choisir un autre e-mail |
| `.whop-EmailWelcome` | Le message d'accueil au-dessus de l'e-mail du compte |
| `.whop-Payment` | La racine de l'élément de paiement |
| `.whop-PaymentBalance` | Un wallet dans la tuile de solde |
| `.whop-PaymentBalanceHint` | Le montant disponible du wallet dans la devise du débit |
| `.whop-PaymentBalanceList` | La liste défilante des wallets de l'acheteur dans la tuile de solde |
| `.whop-PaymentBalanceMore` | La ligne sentinelle qui charge davantage de soldes lorsqu'elle devient visible au défilement |
| `.whop-PaymentBalanceRow` | La ligne de solde cliquable |
| `.whop-PaymentBalanceRowSelected` | Ligne de solde sélectionnée |
| `.whop-PaymentBalanceRowUnavailable` | Un wallet qui ne peut pas payer pour le moment — bloqué ou vide — grisé et désactivé |
| `.whop-PaymentBillingBlock` | Le bloc d'adresse de facturation interne de l'élément de paiement |
| `.whop-PaymentCardFields` | Le panneau des champs de carte inline |
| `.whop-PaymentCompactBalance` | Le solde sélectionné sur un checkout direct compact |
| `.whop-PaymentCompactSavedMethod` | Le moyen enregistré sélectionné sur un checkout direct compact |
| `.whop-PaymentCurrencyFallback` | Le basculement vers la devise de repli lorsque rien n'est proposé |
| `.whop-PaymentDetailIcon` | L'icône du modèle à côté du texte explicatif de la zone de détail |
| `.whop-PaymentDetailRegion` | La zone de détail dépliée d'un moyen sélectionné — d'abord les interfaces de collecte (champs de carte inline, champs déclarés), puis le texte explicatif et les mentions en bloc inférieur |
| `.whop-PaymentDetailSubtext` | Le sous-texte de consentement sous le texte explicatif pour les moyens de type wallet |
| `.whop-PaymentDetailText` | La ligne explicative de la zone de détail |
| `.whop-PaymentError` | Panneau d'erreur des moyens de paiement indisponibles |
| `.whop-PaymentFieldError` | Le message Invalid sous un champ déclaré |
| `.whop-PaymentFieldInput` | Un champ de moyen de paiement déclaré dans la zone de détail |
| `.whop-PaymentFieldInputInvalid` | Ajoutée à un champ déclaré tant que sa valeur ne respecte pas le format déclaré |
| `.whop-PaymentFieldLabel` | Libellé d'un champ de paiement déclaré |
| `.whop-PaymentInstallmentDetail` | Le montant par échéance d'une ligne d'option de paiement échelonné |
| `.whop-PaymentInstallmentLabel` | Le libellé d'une ligne d'option de paiement échelonné |
| `.whop-PaymentInstallmentList` | La liste d'options du sélecteur de paiement échelonné |
| `.whop-PaymentInstallmentRadio` | L'indicateur radio sur une ligne d'option de paiement échelonné |
| `.whop-PaymentInstallmentRow` | Une ligne d'option de paiement échelonné |
| `.whop-PaymentInstallmentRowSelected` | La ligne d'option de paiement échelonné sélectionnée |
| `.whop-PaymentInstallments` | Le sélecteur de paiement échelonné du moyen de paiement |
| `.whop-PaymentInstallmentsLabel` | Le titre du sélecteur de paiement échelonné |
| `.whop-PaymentInstallmentsNotice` | L'avertissement sur les frais de l'émetteur sous un palier sélectionné sans frais déclarés |
| `.whop-PaymentMandateLink` | Le lien vers les conditions du mandat dans l'avis de mandat |
| `.whop-PaymentMandateNotice` | L'avis d'autorisation de mandat sur les moyens dont la configuration de matrice déclare un mandat |
| `.whop-PaymentMethod` | Un moyen de paiement — la ligne et sa zone de détail dépliable |
| `.whop-PaymentMethodDetail` | La zone dépliable qui révèle le détail du moyen sélectionné — champs de carte inline, texte explicatif ou champs déclarés |
| `.whop-PaymentMethodIcon` | L'icône du moyen sur une ligne |
| `.whop-PaymentMethodLabel` | Le nom affiché du moyen sur une ligne |
| `.whop-PaymentMethodMoreSelect` | Le sélecteur natif invisible étendu sur la tuile More |
| `.whop-PaymentMethodMoreTile` | Tuile de débordement avec les icônes des moyens et un sélecteur natif |
| `.whop-PaymentMethodPanel` | Le panneau de détail du moyen sélectionné sous la rangée de tuiles (disposition horizontale) |
| `.whop-PaymentMethodRadio` | L'indicateur radio sur une ligne de moyen |
| `.whop-PaymentMethodRadioSelected` | Radio du moyen de paiement sélectionné |
| `.whop-PaymentMethodRow` | La ligne de moyen de paiement cliquable |
| `.whop-PaymentMethodRowSelected` | Ligne du moyen de paiement sélectionné |
| `.whop-PaymentMethods` | La liste des moyens de paiement |
| `.whop-PaymentMethodSelected` | Ajoutée au moyen de paiement sélectionné — sa ligne et sa zone de détail dépliée |
| `.whop-PaymentMethodSeparated` | Ajoutée à un élément de moyen, ou à un dépliant « autres moyens », lorsqu'il s'affiche comme sa propre carte séparée |
| `.whop-PaymentMethodsSeparated` | Liste des moyens en accordéon séparé |
| `.whop-PaymentMethodTile` | Une tuile de moyen dans la rangée horizontale de tuiles |
| `.whop-PaymentMethodTileRow` | Rangée horizontale de tuiles de moyens avec les moyens en débordement dans la dernière tuile More |
| `.whop-PaymentMethodTileSelected` | Tuile du moyen de paiement sélectionné |
| `.whop-PaymentMoreRow` | La ligne dépliable « N more payment methods » |
| `.whop-PaymentPayerDocument` | Champs du document d'identité de l'acheteur propres à la devise |
| `.whop-PaymentPayerDocumentError` | Erreur du document d'identité de l'acheteur |
| `.whop-PaymentPayerDocumentLabel` | Libellé du document d'identité de l'acheteur |
| `.whop-PaymentPayerDocumentType` | Sélecteur du type de document d'identité de l'acheteur |
| `.whop-PaymentSavedMethod` | Spécifiquement un moyen de paiement enregistré — porte aussi PaymentMethod |
| `.whop-PaymentSavedMethodHint` | Le détail final du moyen enregistré — la date d'expiration d'une carte |
| `.whop-PaymentSavedMethodRow` | Spécifiquement la ligne cliquable d'un moyen enregistré — porte aussi PaymentMethodRow |
| `.whop-PaymentSavedMethodRowSelected` | Ligne du moyen de paiement enregistré sélectionné |
| `.whop-PaymentSavedMethods` | Spécifiquement la liste des moyens enregistrés — porte aussi PaymentMethods, pour qu'une seule règle style les deux listes |
| `.whop-PaymentSavedMethodSeparated` | Le marqueur séparé, spécifiquement sur un moyen enregistré |
| `.whop-PaymentSavedMore` | Le contrôle qui récupère la page suivante des moyens de paiement enregistrés |
| `.whop-PaymentSavedMoreSpinner` | L'indicateur affiché pendant le chargement de la page suivante des moyens de paiement enregistrés |
| `.whop-PaymentSettlementNotice` | L'indication du délai de règlement sur les moyens dont la configuration de matrice en déclare un |
| `.whop-TaxId` | Racine de l'immatriculation fiscale |
| `.whop-TaxIdError` | Erreur de validation de l'API |
| `.whop-TaxIdInput` | Champ de saisie de la valeur d'immatriculation |
| `.whop-TaxIdLabel` | Libellé de la valeur d'immatriculation |
| `.whop-TaxIdTypeLabel` | Libellé du type d'immatriculation |
| `.whop-TaxIdTypeSelect` | Sélecteur du type d'immatriculation |
| `.whop-Verification` | Corps de la boîte de dialogue du code de vérification |
| `.whop-VerificationDismiss` | Contrôle « continuer en tant qu'invité » lorsque la connexion est indisponible |
| `.whop-VerificationError` | Le message d'échec dans la boîte de dialogue |
| `.whop-VerificationExpired` | Panneau de connexion expirée |
| `.whop-VerificationHeading` | Titre et explication de la boîte de dialogue du code |
| `.whop-VerificationHint` | Explication de l'envoi du code |
| `.whop-VerificationInput` | Le champ de saisie du code à usage unique |
| `.whop-VerificationInputInvalid` | Ajoutée au champ du code après une tentative échouée |
| `.whop-VerificationInputSlot` | Une case de chiffre du champ de code à usage unique |
| `.whop-VerificationInputSlotActive` | Ajoutée à la case du code dans laquelle l'acheteur est en train de saisir |
| `.whop-VerificationPasskey` | Contrôle « utiliser plutôt une passkey » |
| `.whop-VerificationPending` | La ligne « vérification… » pendant qu'une soumission est en cours |
| `.whop-VerificationResend` | Contrôle de renvoi du code avec compte à rebours |
| `.whop-VerificationRestart` | Contrôle de redémarrage du panneau expiré |
| `.whop-VerificationTitle` | Logotype de l'en-tête de la boîte de dialogue |

```ts theme={null}
const checkout = whop.checkout.create({
  appearance: {
    classes: {
      'whop-Address': { borderRadius: '8px', fontWeight: '600' },
      'whop-AddressErrorSummary': { borderRadius: '8px', fontWeight: '600' },
      'whop-AddressField': { borderRadius: '8px', fontWeight: '600' }
    }
  }
});

// 159 classes use this shape
checkout.update({
  appearance: { classes: { 'whop-Address': { fontWeight: '700' } } }
});
```

Avec React, transmettez `appearance` à `<Checkout>`. Définissez-la globalement avec `WhopElements({ appearance })`.

## Props

**wallets** `('apple_pay' | 'google_pay')[]`

Les wallets autorisés à s'afficher, sous forme de filtre sur ce que l'appareil propose. L'élément n'affiche jamais un wallet que l'appareil, le compte ou la configuration des moyens de paiement du checkout ne peut pas prendre en charge. Une liste vide n'affiche rien. Par défaut : les deux.

**style** `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.

**fallback** `ReactNode`

Affiché à la place du squelette intégré pendant le chargement de l'élément.

**onReady** `() =\> void`

Se déclenche une fois que l'élément est stabilisé : le bouton est affiché, ou l'élément sait qu'il n'affiche rien. `<Checkout>` l'attend, donc c'est généralement son propre `onLoadingChange` qu'il vous faut.

**onError** `(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.

## États

Une pastille de squelette pendant l'ouverture de la session et pendant que l'appareil indique s'il peut payer, puis le bouton Apple Pay ou Google Pay propre à la plateforme au-dessus de la mention Powered by Whop. Un appareil sans wallet, un wallet désactivé par la configuration des moyens de paiement du checkout, ou un plan épuisé ou archivé n'affiche rien. Un checkout qu'une feuille de paiement ne peut pas honnêtement finaliser (une configuration, une inscription à une liste d'attente, un transfert, une question de formulaire que seule une page peut poser) affiche une vue explicative et signale `EXPRESS_CHECKOUT_UNAVAILABLE` via `onError`. Après l'achat, l'élément affiche son résultat : terminé, en cours de traitement, ou un bouton Finish payment ou Try again lorsque le paiement a encore besoin de l'acheteur.

## Bon à savoir

* Un appareil propose un seul wallet : Apple Pay sur iOS, Google Pay sur Android. C'est pourquoi il n'y a pas de prop `layout` ici : il n'y a jamais de second bouton à disposer.
* La feuille de paiement collecte ce dont la session a encore besoin : l'e-mail lorsque la session n'en a pas, un numéro de téléphone lorsque le vendeur en collecte un, et une adresse de livraison pour les biens physiques. Un vendeur qui vérifie les numéros de téléphone obtient une étape de code dans une modale native après la fermeture de la feuille.
* Sur iOS, la feuille recalcule le prix lorsque l'acheteur change de carte, de sorte que les taxes suivent l'adresse de facturation, et propose un champ de code promo lorsque le vendeur autorise les codes. La feuille Android de Google affiche le total du checkout et n'a pas de champ de code.
* Votre application n'est jamais redirigée. `onComplete` sur `<Checkout>` se déclenche une fois lorsque l'achat est confirmé, avec `sessionId` et `receiptId` : c'est là que vous faites avancer l'acheteur. Exécutez les commandes à partir des webhooks, pas de ce callback.
* 3D Secure et les autres étapes externes ouvrent `ASWebAuthenticationSession` sur iOS et Custom Tabs sur Android, et l'élément interroge le paiement jusqu'à son état final. `returnUrl` sur `<Checkout>` doit être une URL **https** que vous hébergez.
* Chaque option de `<Checkout>` est définie à la création. En modifier une après le montage signale `CHECKOUT_OPTIONS_FROZEN` et conserve la commande d'origine ; donnez une nouvelle `key` à `<Checkout>` pour vendre autre chose.

> [!NOTE]
>
> Enveloppez votre application dans `<WhopElements getToken={…}>` une seule fois, puis montez `<Checkout>` autour de l'élément. `<Checkout>` accepte `plan`, `items`, `checkoutConfiguration`, `quantity`, `promoCode`, `affiliateCode`, `attribution`, `metadata` et `returnUrl`, ainsi que `onComplete`, `onError`, `onLoadingChange` et `fallback`. Consultez [Premiers pas](https://docs.whop.com/fr/elements/latest/getting-started.md) et [Apparence](https://docs.whop.com/fr/elements/latest/appearance.md).


## Related topics

- [CheckoutElement](https://docs.whop.com/fr/elements/latest/checkout/checkout.md)
- [Ajouter Express Checkout](https://docs.whop.com/fr/developer/guides/express-checkout.md)
- [Checkout](https://docs.whop.com/fr/elements/latest/checkout/overview.md)
