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

# SendElement

> Envoie de l'argent depuis un compte vers un destinataire — un utilisateur, un autre compte ou un lien de réclamation public que n'importe qui peut utiliser. Les transferts directs utilisent le canal fiat ou crypto configuré du compte source. Affiche sa propre recherche de destinataires, résolue à partir de l'ID du compte, sans autre identifiant que le jeton propre du compte. Nécessite un `accessToken` limité à `payout:transfer_funds` pour les transferts directs et à `payout:withdraw_funds` pour les listes de destinataires ; la recherche de destinataires d'un compte nécessite en plus `company:authorized_user:read` et `member:basic:read`, et les liens de réclamation d'un compte nécessitent `airdrop_link:manage` — un hôte qui ne dispose pas de l'un de ces scopes doit désactiver la prop correspondante plutôt que de laisser une ligne qui renverra une erreur 403.

> [!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 [`Wallet`](https://docs.whop.com/fr/elements/latest/wallet/overview). `accountId` et `accessToken` proviennent de celui-ci. 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 `refresh()`.

> [!NOTE]
>
> Vous pouvez monter cet élément **inline** (`create`) ou l'ouvrir en overlay **modal** (`createOverlay`).

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

function Example() {
  return (
    <WhopElements elements={loadWhop()}>
      <Wallet /* options */>
        <SendElement onStepChanged={(e) => console.log(e)} onSendCompleted={(e) => console.log(e)} onLinkCreated={(e) => console.log(e)} onDone={(e) => console.log(e)} />
      </Wallet>
    </WhopElements>
  );
}
```

```html JavaScript theme={null}
<script src="https://cdn.whop.com/elements/amber/elements.js" data-whop-elements></script>
<script type="module">
  const wallet = window.WhopElements().wallet.create({ /* options */ });
  wallet.create('send', {
    onStepChanged: (e) => console.log(e),
    onSendCompleted: (e) => console.log(e),
    onLinkCreated: (e) => console.log(e),
    onDone: (e) => console.log(e)
  }).mount('#wallet-send');
</script>
```

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

## Props

**accessToken** `string`

Un jeton à portée limitée pour la lecture et l'écriture privilégiées — nécessite `payout:transfer_funds` pour les transferts directs, `payout:withdraw_funds` pour les listes de destinataires et `airdrop_link:manage` pour les liens de réclamation. S'il est omis, la lecture transporte la propre session du visiteur, qui ne répond qu'en same-origin.

**title** `string`

Remplace l'en-tête du sélecteur de destinataire. S'il est omis, l'en-tête est "Choose recipient".

**canSearchRecipients** `boolean`

Active la recherche de destinataires. Suggère des personnes et des entreprises lorsqu'il y a moins de six destinataires enregistrés, et lance la recherche depuis Add recipient après la saisie. Par défaut : `true`.

**canCreateLink** `boolean`

Affiche l'action de lien de réclamation dans le sélecteur de destinataire. À désactiver pour un hôte sans `airdrop_link:manage`. Par défaut : `true`.

**initialRecipient** `SendRecipient | null`

Ignore le sélecteur et s'ouvre directement sur l'écran du montant pour ce destinataire — pour une rangée d'action "payer cette personne". Aucun bouton retour n'est alors affiché, puisqu'il n'y a pas de sélecteur derrière. Par défaut : `null`.

**propriétés**

**id** `string` *required*

**name** `string | null` *required*

**username** `string | null` *required*

**profilePicUrl** `string | null` *required*

**kind** `"email" | "business" | "user"` *required*

**initialCurrency** `string`

Présélectionne une devise dans le sélecteur de l'écran du montant. Se rabat sur `currency`, puis sur USD. Par défaut : `""`.

## Événements

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

### `onStepChanged`

L'écran visible a changé.

**payload** `object`

**propriétés**

**step** `string` *required*

L'une des valeurs `"success"`, `"enter_amount"`, `"select_recipient"`, `"add_recipient"`, `"create_link"` ou `"link_success"`.

### `onSendCompleted`

Un transfert a réussi. Actualisez tout ce qui, de votre côté, lit le solde ou l'activité du compte.

**payload** `object`

**propriétés**

**recipient** `SendRecipient | Omit\<SendRecipient, "kind"\> & object` *required*

**SendRecipient**

**id** `string` *required*

**name** `string | null` *required*

**username** `string | null` *required*

**profilePicUrl** `string | null` *required*

**kind** `"email" | "business" | "user"` *required*

**shape 2**

**id** `string` *required*

**name** `string | null` *required*

**username** `string | null` *required*

**profilePicUrl** `string | null` *required*

**kind** `"bill_pay"` *required*

**nickname** `string | null`

**after** `string`

**methodName** `string` *required*

**destinationCurrency** `string` *required*

**amount** `number` *required*

**currency** `string` *required*

### `onLinkCreated`

Un lien de réclamation a été créé. Actualisez tout ce qui, de votre côté, lit le solde du compte.

**payload** `object`

**propriétés**

**claimUrl** `string` *required*

**amount** `number` *required*

**redeemableCount** `number` *required*

### `onDone`

Le visiteur a cliqué sur "Done" sur un écran de succès — fermez la surface qui le contient.

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

### `refresh`

Récupère à nouveau les soldes du compte et la liste des destinataires. Appelez-la après toute modification de votre côté de ce qui peut être proposé.

**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\<SendElementProps\>` *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-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 termine la liste des suggestions |
| `.whop-AddressSuggestionsEmpty` | La ligne discrète affichée lorsque la requête aboutit sans aucune adresse correspondante |
| `.whop-SendSurface` | La racine de l'élément d'envoi — un écran à la fois |

```ts theme={null}
const wallet = whop.wallet.create({
  appearance: {
    classes: {
      'whop-AddressSuggestion': { borderRadius: '8px', fontWeight: '600' },
      'whop-AddressSuggestionActive': { borderRadius: '8px', fontWeight: '600' },
      'whop-AddressSuggestionManual': { borderRadius: '8px', fontWeight: '600' }
    }
  }
});

// 5 classes use this shape
wallet.update({
  appearance: {
    classes: { 'whop-AddressSuggestion': { fontWeight: '700' } }
  }
});
```

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


## Related topics

- [Wallet](https://docs.whop.com/fr/elements/latest/wallet/overview.md)
- [ActionsElement](https://docs.whop.com/fr/elements/latest/wallet/actions.md)
- [Élément Chat](https://docs.whop.com/fr/developer/guides/chat/chat-element.md)
