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

# AddressElement

> Collecte une adresse de facturation ou de livraison. Les champs, leur ordre et leur validation suivent le pays sélectionné. Inclut l'autocomplétion de la rue (en plein écran sur téléphone) et des méthodes pour lire ou valider 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 `validate()` et `getValues()`.

> [!NOTE]
>
> **Un par `mode`.** Montez un `<AddressElement />` pour chaque valeur de `mode` sous un même handle Payments. Un second montage avec le même `mode` est refusé. Le `mode` d'un élément est défini à sa création ; pour le modifier, détruisez l'élément et créez-en un nouveau.

Se monte à l'intérieur d'un scope `WhopPayments`. Collecte l'adresse de facturation au format propre au pays sélectionné, et le contrôleur la lit pour la génération du jeton, que vous la liiez ou non.

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 l'adresse de facturation au format du pays de l'acheteur et la publie auprès du provider, de sorte que `createConfirmationToken` la récupère sans qu'on lui transmette quoi que ce soit.

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

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

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

export function BillingStep() {
  return (
    <Payments accountId="biz_xxxxxxxx" plan="plan_xxxxxxxx">
      <ScrollView>
        <AddressElement
          layout="full"
          scope="full"
          name="combined"
          line2="toggle"
          onChange={({ complete, address }) => console.log(complete, address.country)}
        />
      </ScrollView>
    </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('address', { onChange: (e) => console.log(e) }).mount('#payments-address');
</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 address = PostalAddress()
    @State private var addressComplete = false

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

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

[AddressElement exécuté sur Android, dans l'application d'exemple React Native](https://app.revyl.ai/embed/d5ebb0fa-b4cb-48b7-8fd4-033f844518c0?controls=0)

## Props

**mode** `"billing" | "shipping"`

L'adresse collectée : `billing` (par défaut) ou `shipping`. Définit aussi la finalité de l'autocomplétion du navigateur. Vous pouvez en monter un de chaque sous un même handle. Les informations de facturation proviennent de l'élément de facturation, ou de l'élément de livraison lorsqu'aucun élément de facturation n'est monté. Par défaut : `"billing"`.

**name** `"split" | "none" | "combined"`

La ligne du nom : un seul champ de nom complet (par défaut), des champs prénom/nom séparés, ou aucun. Par défaut : `"combined"`.

**line2** `"never" | "toggle" | "always"`

Ligne d'adresse 2 : toujours visible (par défaut), révélée par un bouton texte (`toggle`), ou jamais collectée. Par défaut : `"always"`.

**defaultValues** `object`

Valeurs initiales appliquées une fois avant le premier affichage (`address.country` est un code pays ISO 3166-1 alpha-2). Prévalent sur la détection du pays par IP.

**propriétés**

**name** `string`

**address** `object`

**propriétés**

**name** `string`

**first\_name** `string`

**last\_name** `string`

**organization** `string`

**organization\_type** `"business" | "individual"`

**line1** `string`

**line2** `string`

**city** `string`

**state** `string`

**postal\_code** `string`

**country** `string`

**layout** `"full" | "compact" | "wrap"`

`full` (par défaut) empile des champs avec libellé. `compact` regroupe des champs dont le libellé sert de placeholder dans une seule bordure. `wrap` conserve les champs séparés de `full` et place aussi la ville, l'État et le code postal côte à côte. Ceux-ci, ainsi que les paires que `full` place déjà côte à côte (prénom et nom, organisation), tiennent autant que possible sur une ligne selon la largeur et passent à la ligne lorsqu'elle se réduit. Par défaut : `"full"`.

**labelMode** `"above" | "floating"`

`above` (par défaut) garde chaque libellé en dehors de son champ : au-dessus dans la disposition `full`, comme placeholder dans `compact`. `floating` utilise chaque libellé comme placeholder de son champ, dans les deux dispositions, puis affiche un petit libellé au-dessus du texte saisi dès que le champ a une valeur. Par défaut : `"above"`. Depuis `v1.5.0`.

**scope** `"minimal" | "full"`

`full` (par défaut) suit le format d'adresse complet du pays sélectionné. `minimal` ne collecte que le pays et le code postal. `name` ajoute indépendamment les champs de nom requis. Définissez `name` sur `none` pour les omettre. Cet élément n'ajoute pas les champs requis par un moyen de paiement. La confirmation par carte nécessite un nom, un pays et un code postal, donc gardez `name` activé ou transmettez `billingDetails.name`. Par défaut : `"full"`.

**organization** `"none" | "name" | "name_with_type"`

Champs d'organisation : aucun (par défaut), nom uniquement, ou nom avec un sélecteur entreprise/particulier. Par défaut : `"none"`.

**detectCountry** `boolean`

Définit le pays par défaut à partir de l'IP de l'acheteur (résolue avant le premier affichage). Se rabat sur le `countryHint` du contrôleur, puis sur US. Par défaut : `true`.

**allowedCountries** `string[]`

Codes pays ISO 3166-1 alpha-2 autorisés. Avec un seul code, le sélecteur reste visible mais ne propose que ce pays.

**autocomplete** `boolean`

Active les suggestions Google Places pour l'adresse postale. Si aucune correspondance n'apparaît ou si Places est bloqué, la liste indique l'absence de correspondance et permet aux acheteurs de saisir l'adresse manuellement. Sur téléphone, les suggestions s'ouvrent en plein écran depuis un bouton de recherche dans le champ de rue plutôt qu'en dessous, où le clavier les masquerait. Définissez `false` pour un champ de saisie simple. Par défaut : `true`.

**expanded** `boolean`

Affiche tous les champs d'adresse dès le départ. Par défaut (`false`), le formulaire s'ouvre avec l'adresse postale et révèle le reste une fois que l'acheteur choisit une suggestion, saisit une adresse ou choisit de la saisir manuellement. Par défaut : `false`. Depuis `v1.6.0`.

**customFields** `object[]`

Champs supplémentaires affichés avec le formulaire d'adresse. Les valeurs sont validées et émises dans la map `custom` distincte.

**propriétés**

**key** `string` *required*

**label** `string` *required*

**type** `"phone" | "text" | "select" | "date"` *required*

**position** `string` *required*

L'une des valeurs `"after_name"`, `"after_organization"`, `"before_country"` ou `"after_address"`.

**required** `boolean`

**options** `string[]`

**format** `string`

**autocomplete** `string`

**countryHint** `string`

Pays de repli après `defaultValues` et la détection par IP. Utilisez un code ISO 3166-1 alpha-2. Une valeur vide se rabat sur `US`. Par défaut : `""`.

## Événements

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

### `onChange`

Se déclenche lorsque l'adresse change. `complete` vaut true lorsque tous les champs propres au pays et les champs personnalisés requis sont valides. `address` suit les noms de `billing_details` du jeton de confirmation, y compris `postal_code`. `country` est un code ISO 3166-1 alpha-2. Les valeurs personnalisées se trouvent dans `custom`.

**payload** `object`

**propriétés**

**complete** `boolean` *required*

**address** `object` *required*

**propriétés**

**name** `string`

**first\_name** `string`

**last\_name** `string`

**organization** `string`

**organization\_type** `"business" | "individual"`

**line1** `string`

**line2** `string`

**city** `string`

**state** `string`

**postal\_code** `string`

**country** `string` *required*

**custom** `Record\<string, 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.

### `validate`

Valide le formulaire, révèle toutes les erreurs inline et ne lève jamais d'exception. Renvoie `complete`, `address` et `errors`. `errors` est vide exactement lorsque `complete` vaut true. Les clés utilisent les noms du contrat comme `postal_code` et `line1`, `custom:<key>` pour les champs personnalisés, et `form` de manière transitoire pendant le chargement.

**Renvoie** `Promise<object>`

**complete** `boolean` *required*

**address** `object` *required*

**propriétés**

**name** `string`

**first\_name** `string`

**last\_name** `string`

**organization** `string`

**organization\_type** `"business" | "individual"`

**line1** `string`

**line2** `string`

**city** `string`

**state** `string`

**postal\_code** `string`

**country** `string` *required*

**errors** `Record\<string, string\>` *required*

### `getValues`

Renvoie `address` et `custom` sans validation ni affichage des erreurs.

**Renvoie** `Promise<object>`

**address** `object` *required*

**propriétés**

**name** `string`

**first\_name** `string`

**last\_name** `string`

**organization** `string`

**organization\_type** `"business" | "individual"`

**line1** `string`

**line2** `string`

**city** `string`

**state** `string`

**postal\_code** `string`

**country** `string` *required*

**custom** `Record\<string, string\>` *required*

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

```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' }
    }
  }
});

// 18 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

**address** `Binding\<PostalAddress\>?`

Relit l'adresse collectée. Le contrôleur la collecte dans tous les cas.

**isComplete** `Binding\<Bool\>?`

Vaut true dès que chaque champ requis par le pays est rempli et valide.

**mode** `WhopAddressElement.Mode`

`.billing` ou `.shipping`. Shipping demande au clavier des champs de livraison. Par défaut : `.billing`.

**layout** `WhopAddressElement.Layout`

`.full` ajoute un libellé à chaque champ et les empile ; `.compact` déplace les libellés dans les placeholders. Par défaut : `.full`.

**scope** `WhopAddressElement.Scope`

`.full` collecte le format complet du pays ; `.minimal` ne collecte que le pays et le code postal. Par défaut : `.full`.

**name** `WhopAddressElement.NameFields`

`.combined` pour un seul champ de nom complet, `.split` pour le prénom et le nom, `.none` pour omettre le nom. Par défaut : `.combined`.

**organization** `WhopAddressElement.OrganizationFields`

`.none`, `.name` pour un nom d'organisation, ou `.nameWithType` pour demander aussi s'il s'agit d'une entreprise ou d'un particulier. Par défaut : `.none`.

**line2** `WhopAddressElement.Line2Field`

`.always` affiche la deuxième ligne, `.toggle` la révèle avec un bouton, `.never` l'omet. Par défaut : `.toggle`.

**defaultValues** `PostalAddress?`

Valeurs de départ. Son `country` est un code ISO 3166-1 alpha-2 et prévaut sur la détection.

**detectCountry** `Bool`

Démarre sur le pays de l'acheteur lorsque vaut true. Se rabat sur `countryHint`, puis sur le pays de la devise du débit, puis sur US. Par défaut : `true`.

**allowedCountries** `[String]?`

Limite le sélecteur à ces codes ISO 3166-1 alpha-2, à l'intersection de la contrainte propre au moyen sélectionné.

**countryHint** `String?`

Valeur de repli ISO 3166-1 alpha-2 pour la chaîne de détermination du pays.

**autocomplete** `Bool`

Suggestions de rue pendant la saisie de l'acheteur. Lorsqu'elle est désactivée, il n'y a rien à choisir, donc tous les champs s'affichent dès le départ. Par défaut : `true`.

## `PostalAddress`

Ce que renvoie une sélection :

* `country: String` : ISO 3166-1 alpha-2, en majuscules
* `line1` / `line2` / `city` / `state` / `postalCode` : `String?`, au format propre au pays
* `name` / `firstName` / `lastName` : `String?`, selon le mode `name`
* `organization` / `organizationType` : `String?`, selon le mode `organization`

## États

Le formulaire s'affiche immédiatement. Avec l'autocomplétion activée et le scope `.full`, les champs de localité apparaissent après une suggestion ou une saisie manuelle ; désactivez-la et tous les champs s'affichent d'un coup. Les erreurs apparaissent à la première tentative de confirmation, puis en direct.

## Bon à savoir

* MapKit fournit les suggestions de rue directement sur l'appareil. Whop ne voit jamais la requête de l'acheteur pendant la saisie.
* `defaultValues.country` prévaut sur la détection. La détection se rabat sur `countryHint`, puis sur le pays de la devise du débit, puis sur US.
* `allowedCountries` est croisé avec la contrainte de pays de facturation propre au moyen sélectionné, de sorte qu'un moyen qui n'accepte qu'un seul pays restreint le sélecteur de lui-même.
* `PostalAddress` utilise les clés `billing_details` du jeton de confirmation, donc le même JSON fonctionne sur toutes les plateformes.

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

**mode** `'billing' | 'shipping'`

Finalité de l'autocomplétion. Par défaut : `billing`.

**layout** `'full' | 'compact'`

`full` ajoute un libellé à chaque champ et les empile. `compact` déplace les libellés dans les placeholders. Par défaut : `full`.

**scope** `'full' | 'minimal'`

`full` suit le format complet du pays. `minimal` ne collecte que le pays et le code postal. Par défaut : `full`.

**name** `'combined' | 'split' | 'none'`

Un seul champ de nom complet, prénom et nom, ou aucun champ de nom. Par défaut : `combined`.

**organization** `'none' | 'name' | 'name_with_type'`

Indique s'il faut collecter une organisation, et s'il faut aussi demander s'il s'agit d'une entreprise ou d'un particulier. Par défaut : `none`.

**line2** `'toggle' | 'always' | 'never'`

La façon dont la deuxième ligne d'adresse apparaît. Par défaut : `toggle`, qui affiche un bouton « Add address line 2 ».

**allowedCountries** `string[]`

Limite le sélecteur de pays à ces codes ISO 3166-1 alpha-2. La liste de pays propre à un moyen de paiement sélectionné la restreint davantage, sans jamais l'élargir.

**detectCountry** `boolean`

Définit le pays par défaut à partir de l'IP de l'acheteur.

**countryHint** `string`

Pays de repli après `defaultValues` et la détection par IP. ISO 3166-1 alpha-2.

**defaultValues** `\{ name?: string; address?: Partial\<EmittedAddress\> \}`

Valeurs initiales appliquées une fois au montage, pour une session reprise.

**customFields** `CustomFieldSpec[]`

Champs supplémentaires affichés à une position déclarée (`after_name`, `after_organization`, `before_country`, `after_address`). Un champ obligatoire conditionne `complete`.

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

Se déclenche à chaque modification avec l'instantané courant.

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

## `AddressChangePayload`

Ce que renvoie `onChange` :

* `complete: boolean` : chaque champ requis par le pays est rempli et valide
* `address: EmittedAddress` : ce que l'acheteur a saisi jusqu'à présent
* `custom: Record<string, string>` : les valeurs des `customFields` que vous avez déclarés

## États

Un squelette de trois champs pendant le chargement du catalogue de pays, puis le formulaire. Changer de pays réorganise les champs, car le format est celui du pays, et non un ensemble fixe. `onChange` signale `complete` lorsque chaque champ requis par le pays est rempli et valide.

## Bon à savoir

* Le pays est défini par défaut à partir de l'IP de l'acheteur lorsque `detectCountry` est activé, puis `countryHint`, puis US. `defaultValues.address.country` prévaut sur les trois.
* `autocomplete` est activé par défaut, comme sur le web, mais il est fourni par le **géocodeur de la plateforme** plutôt que par Google Places : il ne nécessite donc ni clé API, ni compte, ni dépendance supplémentaire. iOS utilise `MKLocalSearchCompleter`, une véritable API de saisie prédictive qui répond à un fragment avec plusieurs candidats. Android utilise `android.location.Geocoder`, qui résout une adresse *complète* plutôt que de prédire à partir d'une adresse partielle : attendez-vous à environ un résultat, et à un résultat moins précis pour une rue à moitié saisie. Android ne fournit aucune saisie prédictive sans clé, et l'alternative — le SDK Places — ajouterait plusieurs mégaoctets et imposerait les autorisations de localisation à chaque application intégrant ce SDK.
* Les défaillances de l'une ou l'autre plateforme sont silencieuses par conception : un géocodeur sans backend, sans réseau ou sans correspondance n'affiche rien et l'acheteur saisit l'adresse à la main, comme au départ. L'autocomplétion ne bloque jamais un checkout.
* L'adresse émise utilise les mêmes clés que l'élément web et que les `billing_details` du jeton de confirmation, donc une seule forme de payload fonctionne sur toutes les plateformes.
* Un élément d'adresse monté est la source de facturation du provider. Démontez-le et `createConfirmationToken` se rabat sur ce que vous lui transmettez directement.

> [!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

- [PaymentElement](https://docs.whop.com/fr/elements/latest/payments/payment.md)
- [Premiers pas avec Elements](https://docs.whop.com/fr/elements/latest/getting-started.md)
- [BrandingElement](https://docs.whop.com/fr/elements/latest/payments/branding.md)
