> ## 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.

# PaymentElement

> Affiche les moyens de paiement disponibles et collecte les champs obligatoires et les mentions du moyen sélectionné. Utilisez `change` pour activer votre bouton de paiement. Dans son gestionnaire d'activation, appelez `payments.createConfirmationToken()`. Confirmez le jeton côté serveur, puis transmettez toute étape en attente à `payments.handleNextAction(…)`. Utilisez `addressChange` pour les mises à jour qui dépendent de l'adresse.

> [!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 [`Payments`](https://docs.whop.com/fr/elements/latest/payments/overview). Transmettez les props et les callbacks via les options de création ou les props React. Conservez le handle créé, ou la `ref` React, pour appeler `select()`.

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

> [!NOTE]
>
> **Attend `BrandingElement`.** Cet élément reste dans son état de chargement jusqu'à ce que `BrandingElement` soit monté dans le même handle Payments.

Se monte à l'intérieur d'un scope `WhopPayments`. Affiche les tuiles des moyens proposés par le débit, puis ce que collecte le moyen sélectionné : les champs de carte, les champs qu'il déclare ou le bouton Apple Pay.

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>`. Il affiche les tuiles des moyens du débit et collecte tout ce que déclare le moyen sélectionné : une carte, une feuille de wallet et une redirection bancaire tiennent donc en une seule et même ligne.

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

function Example() {
  return (
    <WhopElements elements={loadWhop()}>
      <Payments /* options */>
        <PaymentElement onChange={(e) => console.log(e)} onAddressChange={(e) => console.log(e)} />
        <BrandingElement />
      </Payments>
    </WhopElements>
  );
}
```

```tsx React Native theme={null}
import { useRef, useState } from 'react';
import { Button, ScrollView } from 'react-native';
import { EmailElement, PaymentElement, Payments, type PaymentsHandle } from '@whop/elements-react-native';

export function PaymentStep() {
  const payments = useRef<PaymentsHandle | null>(null);
  const [ready, setReady] = useState(false);

  return (
    <Payments
      ref={payments}
      accountId="biz_xxxxxxxx"
      plan="plan_xxxxxxxx"
      returnUrl="https://example.com/checkout/return"
    >
      <ScrollView>
        <EmailElement />
        <PaymentElement onChange={(p) => setReady(p.complete)} />
      </ScrollView>
      <Button
        title="Pay"
        disabled={!ready}
        onPress={async () => {
          const token = await payments.current!.createConfirmationToken();
          console.log(token.confirmationToken, token.type);
        }}
      />
    </Payments>
  );
}
```

```html JavaScript theme={null}
<script src="https://cdn.whop.com/elements/amber/elements.js" data-whop-elements></script>
<script type="module">
  const payments = window.WhopElements().payments.create({ /* options */ });
  payments.create('payment', {
    onChange: (e) => console.log(e),
    onAddressChange: (e) => console.log(e)
  }).mount('#payments-payment');
  payments.create('branding').mount('#payments-branding');
</script>
```

```swift Swift theme={null}
import Elements
import SwiftUI

// .whopElements(environment:) runs once at the app root. See Getting started.
struct CheckoutScreen: View {
    @State private var selection = WhopPaymentSelection(isComplete: false, type: nil, displayName: nil, category: nil)

    var body: some View {
        WhopPayments(accountID: "biz_xxxx", charge: .plan(id: "plan_xxxx")) { payments in
            ScrollView {
                VStack(alignment: .leading, spacing: 20) {
                WhopPaymentElement(selection: $selection)
                    WhopBrandingElement()
                }
                .padding()
            }
        }
    }
}
```

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

[PaymentElement exécuté sur Android, dans l'application d'exemple React Native](https://app.revyl.ai/embed/c05028fb-0d33-4f36-b6f9-5339a4b9a054?controls=0)

## Props

**order** `string[]`

Contrôle l'ordre d'affichage dans les deux dispositions. Les types listés apparaissent en premier, dans l'ordre. Les types non listés conservent leur ordre relatif. N'affecte pas la disponibilité. Par défaut : `[]`.

**wallets** `object`

Contrôle les wallets proposés par l'élément. Chaque clé vaut par défaut `'auto'`, qui propose le wallet partout où le compte, l'appareil de l'acheteur et le débit le prennent en charge. `'never'` retire ce wallet de la liste des moyens. Utilisez-le lorsque votre page affiche ses propres boutons Apple Pay, Google Pay ou PayPal avec `paymentRequest`, afin que les acheteurs ne voient chaque wallet qu'une fois. `payPal: 'never'` retire le moyen PayPal. Les moyens de paiement enregistrés ne sont pas concernés. Par défaut : `{}`. Depuis `v1.8.0`.

**propriétés**

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

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

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

**fields** `object`

Contrôle la collecte des informations de facturation. `billingDetails: 'minimal'` (par défaut) suit la matrice de chaque moyen. Par défaut, les moyens collectent le nom et le format complet du pays. Une surcharge peut ne collecter que le minimum déclaré, ou rien du tout. Pour les cartes, le minimum est le nom sur la carte, le pays et le code postal. `'full'` exige le nom et le format complet du pays pour chaque nouveau moyen. `'never'` masque le bloc. `address: 'minimal'` ne collecte que le minimum déclaré de chaque moyen, plus un pays lorsque ce minimum n'en comporte pas (et aussi le code postal lorsque `billingDetails: 'full'` indique que le checkout est soumis à taxe), sauf pour les wallets, la crypto, les prélèvements bancaires, les virements bancaires, les paiements par carte en présentiel et les achats intégrés, qui ne collectent aucune adresse, et sauf pour un moyen dont le prestataire exige l'adresse de facturation complète (`requires_full_billing_address`), dont la tuile suit les mêmes règles qu'un checkout sans indicateur ; dans les autres cas, il l'emporte sur `billingDetails: 'full'` ; utilisez-le lorsque le vendeur ne collecte pas d'adresse de facturation complète. `phone: 'never'` masque uniquement le champ de téléphone de facturation lorsque votre formulaire le collecte déjà ; transmettez `billingDetails.phone` à `createConfirmationToken` pour les moyens qui l'exigent. Transmettez plutôt l'adresse à `createConfirmationToken`. Le sélecteur de pays n'inclut que les pays pris en charge par le moyen et la devise de paiement. Lorsqu'un plan de paiement échelonné est sélectionné, il se limite aux pays desservis par ce plan — le pays de facturation est le pays de transaction sous lequel le débit est traité. Il se verrouille lorsqu'un seul pays est disponible. Par défaut : `{"billingDetails":"minimal"}`.

**propriétés**

**billingDetails** `"minimal" | "full" | "never"`

**address** `"minimal" | "auto"`

**phone** `"never" | "auto"`

**defaultValues** `object`

Préremplit les informations de facturation lors du premier affichage du bloc de facturation de chaque moyen. L'acheteur peut modifier chaque champ prérempli. `address.country` est un code ISO 3166-1 alpha-2 et ne s'applique que lorsque le moyen sélectionné l'accepte. `phone` remplit le champ de téléphone de facturation pour les moyens qui en collectent un, au format E.164 comme `+14155552671` ; un numéro hors des pays de téléphone pris en charge par le moyen est ignoré. Seuls les champs affichés par le bloc sont préremplis et envoyés. Transmettez tout le reste à `createConfirmationToken` dans `billingDetails`. Depuis `v1.1.0`.

**propriétés**

**billingDetails** `object`

**propriétés**

**name** `string`

**phone** `string`

**address** `object`

**propriétés**

**line1** `string`

**line2** `string`

**city** `string`

**state** `string`

**postal\_code** `string`

**country** `string`

**layout** `"accordion" | "horizontal"`

Disposition du sélecteur. `accordion` (par défaut) empile les moyens et déplie les détails inline. `horizontal` affiche des tuiles de largeur égale, sans défilement, avec les détails du moyen sélectionné en dessous. Au-delà de quatre moyens, une tuile More ouvre un sélecteur natif. Le moyen choisi à cet endroit occupe la dernière tuile jusqu'à la sélection suivante. La sélection et la confirmation se comportent de la même manière. Par défaut : `"accordion"`.

**separated** `boolean`

`accordion` uniquement. Ajoute de l'espacement et un style de carte distinct entre les moyens. Ignoré lorsque `layout` vaut `horizontal`. Par défaut : `false`.

**autoSelect** `boolean`

Indique s'il faut sélectionner le premier moyen proposé après la résolution. La valeur par défaut `true` respecte `order` et émet `selected` et `change` comme une interaction de l'acheteur. Elle s'exécute une seule fois avant toute interaction de l'acheteur et ne fait rien lorsqu'aucun moyen n'est proposé. Définissez `false` pour monter l'élément sans sélection. Indépendamment, si une mise à jour retire le moyen sélectionné, la sélection revient au premier moyen proposé. Un élément déjà sans sélection le reste. Par défaut : `true`.

## Événements

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

### `onChange`

Se déclenche lorsque la sélection change. `complete: true` signifie que l'acheteur a sélectionné un moyen et rempli ses champs de carte ou ses champs obligatoires. Utilisez-le pour activer la confirmation. `paymentMethod` est le moyen de paiement sélectionné, enregistré ou nouveau, ou `null` tant que rien n'est sélectionné : `displayName` et `icons` nomment le choix tel que l'élément l'affiche (avec `balance.imageUrl`, l'image du propriétaire d'un solde), `card` contient le réseau d'une carte, ses quatre derniers chiffres et son type de financement, `requiresBillingPhone` indique si le moyen nécessite un téléphone dans les informations de facturation, et `countries` liste les pays depuis lesquels le moyen peut payer dans la devise du débit. `type`, `requiresBillingPhone` et `method` au niveau supérieur sont dépréciés : lisez-les depuis `paymentMethod`. `supportsBuyerFee` au niveau supérieur est également déprécié, sans remplacement : Whop fixe lui-même le prix de ses frais de service acheteur.

**payload** `PaymentElementChangeEvent`

**propriétés**

**complete** `boolean` *required*

Indique si l'acheteur a sélectionné un moyen et rempli ses champs de carte ou ses champs obligatoires. Utilisez-le pour activer la confirmation.

**paymentMethod** `PaymentElementPaymentMethod | null` *required*

Le moyen de paiement sélectionné, ou `null` tant que rien n'est sélectionné.

**propriétés**

**id** `string | null` *required*

Le moyen de paiement enregistré choisi par l'acheteur, ou `null` pour un moyen que l'acheteur est en train de saisir ou pour un solde.

**type** `string` *required*

Le type de moyen de paiement : `card`, `klarna`, `apple_pay`, `balance`, etc.

**category** `string` *required*

La famille à laquelle appartient le type, comme `card`, `wallet`, `bnpl` ou `balance`.

**displayName** `string` *required*

Le nom à donner au choix : le libellé propre d'un moyen enregistré ("Visa •••• 4242", "Cash App \$tag"), le nom d'un solde ("Acme", "Personal Balance"), le réseau et les quatre derniers chiffres d'une carte pendant que l'acheteur la saisit, ou sinon le nom propre du moyen ("Klarna").

**icons** `PaymentMethodIcons`

Les icônes du choix : les icônes propres d'un moyen enregistré, le visuel du réseau d'une carte saisie, ou sinon les icônes du moyen. Toujours un jeu d'icônes, avec des versions SVG et PNG.

**propriétés**

**square** `PaymentMethodIconVariants | null`

**propriétés**

**light** `object` *required*

**propriétés**

**svg** `string` *required*

**dark** `object` *required*

**propriétés**

**svg** `string` *required*

**card** `PaymentMethodIconVariants | null`

**propriétés**

**light** `object` *required*

**propriétés**

**svg** `string` *required*

**dark** `object` *required*

**propriétés**

**svg** `string` *required*

**balance** `object`

Ce que l'on sait d'un solde choisi au-delà de son type : `imageUrl` est l'image du propriétaire du solde, une URL d'image matricielle unique plutôt qu'un jeu d'icônes, à afficher à la place de `icons`. Absent pour les autres moyens, et pour un solde dont le propriétaire n'a pas d'image.

**propriétés**

**imageUrl** `string`

**card** `object`

Ce que l'on sait d'une carte choisie : les détails d'une carte enregistrée, ou ceux d'une carte saisie au fil de la frappe de l'acheteur. Absent pour les autres moyens.

**propriétés**

**network** `string`

**last4** `string`

**funding** `string`

**requiresBillingPhone** `boolean` *required*

Indique si le moyen nécessite un téléphone dans les informations de facturation, y compris lorsque `fields.phone` désactive le champ de téléphone propre à l'élément.

**countries** `string[]` *required*

Les codes pays à deux lettres en minuscules depuis lesquels le moyen peut payer dans la devise du débit.

**type** `string` *deprecated*

> [!WARNING]
>
> Déprécié. Utilisez `paymentMethod.type`.

**supportsBuyerFee** `boolean` *deprecated*

> [!WARNING]
>
> Déprécié. Whop fixe lui-même le prix de ses frais de service acheteur, une page n'en a donc aucun usage. Sera supprimé dans la prochaine version majeure.

**requiresBillingPhone** `boolean` *deprecated*

> [!WARNING]
>
> Déprécié. Utilisez `paymentMethod.requiresBillingPhone`.

**method** `object` *deprecated*

> [!WARNING]
>
> Déprécié. Utilisez `paymentMethod`. Absent lorsque l'acheteur choisit un moyen enregistré.

**propriétés**

**type** `string` *required*

**category** `string` *required*

**template** `string` *required*

**display\_name** `string` *required*

**countries** `object[]` *required*

**propriétés**

**country** `string` *required*

**min\_amount** `number | null` *required*

**max\_amount** `number | null` *required*

**min\_amount** `number | null` *required*

**max\_amount** `number | null` *required*

### `onAddressChange`

Se déclenche environ 300 ms après la modification de l'adresse de facturation interne. Utilisez-le pour les taxes, la livraison ou d'autres mises à jour dépendant de l'adresse. `country` est un code ISO 3166-1 alpha-2. Le payload omet les autres clés d'adresse lorsqu'elles sont vides ou inutilisées pour ce pays. `complete: true` signifie que le bloc de facturation est valide et complet. Cet événement ne se déclenche que tant que l'élément de paiement gère la collecte de l'adresse. Avec `fields.billingDetails: 'never'`, utilisez votre propre source d'adresse. Avec un `AddressElement` monté, utilisez son événement `change`.

**payload** `object`

**propriétés**

**complete** `boolean` *required*

**address** `object` *required*

**propriétés**

**line1** `string`

**line2** `string`

**city** `string`

**state** `string`

**postal\_code** `string`

**country** `string` *required*

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

### `select`

Sélectionne un moyen par le même chemin qu'une interaction de l'acheteur. Par exemple, `select('cashapp')` déplie la tuile et émet `selected` et `change`. Les cartes restent à `complete: false` tant que leurs champs ne sont pas remplis. Les moyens inconnus, indisponibles ou soumis à une condition de montant sont rejetés avec le code `METHOD_NOT_OFFERED`. `select(null)` efface la sélection et émet `change` avec `complete: false`. À utiliser avec `autoSelect={false}` pour un contrôle externe complet.

**Paramètres**

**input** `string | null` *required*

**Renvoie** `Promise<void>`

### `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\<PaymentElementProps\>` *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-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-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-CardLabel` | Libellé des informations de carte |
| `.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 |

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

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

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

## Paramètres

**order** `[WhopPaymentMethodType]`

Ordre des tuiles pour ce montage, qui remplace le `methodOrder` du contrôleur. Les types listés prennent leur position dans la liste ; les autres conservent leur ordre d'origine derrière eux.

**selection** `Binding\<WhopPaymentSelection\>?`

Relit la sélection actuelle et son état de complétude. Le contrôleur suit les deux dans tous les cas.

## `WhopPaymentSelection`

Ce que renvoie une sélection :

* `isComplete: Bool` : le moyen sélectionné dispose de tout ce dont il a besoin
* `type: WhopPaymentMethodType?` : le moyen sélectionné
* `displayName: String?` : son libellé, tel que l'écrit la matrice
* `category: String?` : `card`, `wallet`, `bank_debit`, …

## États

Affiche des tuiles squelettes pendant le chargement de la matrice des moyens, et le message d'échec lorsque la lecture échoue. Un moyen dont cette build ne peut pas exécuter la catégorie est ignoré plutôt qu'affiché sous forme de tuile défectueuse. Sélectionner un wallet remplace la surface de confirmation par Apple Pay.

## Bon à savoir

* Apple Pay n'a besoin de rien de la part de votre application : ni identifiant marchand, ni capacité `In-App Payments`. Le marchand est celui enregistré sur le compte Whop, et la tuile s'affiche dès que l'appareil peut payer.
* Un moyen qui déclare un champ `secure` l'affiche sous forme de champ hébergé. Ces valeurs n'entrent jamais dans votre processus.
* Les moyens enregistrés d'un acheteur connecté apparaissent au-dessus des nouveaux. Montez [`WhopEmailElement`](https://docs.whop.com/fr/elements/latest/payments/email#swift) pour proposer la connexion qui produit l'identifiant ; choisir une ligne enregistrée ne collecte rien et génère une référence.
* Un débit par carte qui publie des paliers de paiement échelonné affiche un sélecteur de plan dans le panneau de carte. Un plan que la carte de l'acheteur ne peut pas prendre est replié plutôt que grisé, et un plan dont la région ne correspond pas au pays de facturation est refusé avant l'exécution de tout tokenizer.
* Un marché qui exige un document d'identité (un débit en `ars`, aujourd'hui) affiche le sélecteur de type et le champ de numéro dans le panneau. Ce numéro transite par votre application en route vers le tokenizer, contrairement à la carte, et n'atteint toujours jamais Whop.
* Les valeurs de carte et des champs sécurisés sont tokenisées avant la génération du jeton, de sorte que le jeton de confirmation est la seule chose qui traverse votre application.
* Montez [`WhopAddressElement`](https://docs.whop.com/fr/elements/latest/payments/address#swift) à côté lorsqu'un moyen nécessite un pays de facturation : la liste des tuiles se limite aux moyens autorisés par ce pays.

## Installation

```swift theme={null}
dependencies: [
    .package(url: "https://github.com/whopio/elements-swift.git", from: "0.1.0")
]
```

> [!NOTE]
>
> 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](https://docs.whop.com/fr/elements/latest/getting-started.md) et [Apparence](https://docs.whop.com/fr/elements/latest/appearance.md).

## Props

**order** `string[]`

Ordre d'affichage des moyens, avec la sémantique de `paymentMethodOrder` de Stripe. Les types non listés conservent leur ordre relatif d'origine derrière les types listés. Peut aussi être défini une fois sur `<Payments>`.

**onChange** `(payload: PaymentChangePayload) =\> void`

Se déclenche à chaque changement de sélection et de complétude. Conditionnez votre bouton d'envoi à `complete`.

**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 interactif. `<Payments>` les regroupe, 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.

## `PaymentChangePayload`

Ce que renvoie `onChange` :

* `complete: boolean` : le moyen sélectionné dispose de tout ce dont il a besoin
* `type?: string` : le type du moyen sélectionné, par exemple `card`
* `method?: { type, category, template, display_name }` : l'entrée de matrice du moyen sélectionné

## États

Trois lignes squelettes jusqu'à l'arrivée de la matrice des moyens, puis les tuiles. Sélectionner une tuile déplie sa zone de détail en dessous. `onChange` signale `complete` lorsque le moyen sélectionné dispose de tout ce dont il a besoin, ce qui conditionne votre bouton d'envoi. Un débit sans moyen éligible affiche un état vide explicatif plutôt que rien.

## Bon à savoir

* Les numéros de carte ne passent jamais par votre code. Les champs sont des champs natifs isolés PCI, et le SDK transmet un jeton à Whop : votre application reste donc hors du périmètre PCI.
* Apple Pay et Google Pay présentent tous deux la feuille native de la plateforme. Aucun des deux n'a besoin de quoi que ce soit de votre part : Apple Pay utilise le marchand enregistré sur le compte Whop, il n'y a donc aucun identifiant marchand à transmettre ni aucune capacité à ajouter dans Xcode, et `googlePayMerchantName` définit uniquement le nom affiché dans la feuille, qui vaut Whop par défaut.
* Les moyens à redirection et 3D Secure ouvrent `ASWebAuthenticationSession` sur iOS et Custom Tabs sur Android. C'est le navigateur système, jamais une WebView, de sorte que la page de l'émetteur reste en dehors du périmètre de confiance de votre application.
* Définissez `returnUrl` sur `<Payments>` avec une URL **https** que vous hébergez. L'API refuse tout ce qui n'est pas https ou loopback (`PaymentsApi::ValidateReturnUrl`), un schéma d'application personnalisé n'est donc pas disponible ici. Vous n'enregistrez pas de lien profond : après la redirection de l'émetteur, `handleNextAction` interroge le paiement jusqu'à son état final et ferme lui-même le navigateur.

> [!NOTE]
>
> Enveloppez votre application dans `<WhopElements getToken={…}>` une seule fois, puis montez `<Payments>` autour des éléments. 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

- [Payments](https://docs.whop.com/fr/elements/latest/payments/overview.md)
- [Créer un checkout avec les Payment Elements](https://docs.whop.com/fr/developer/guides/payment-elements.md)
- [CardElement](https://docs.whop.com/fr/elements/latest/payments/card.md)
