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

# Devise de règlement préférée

> Convertissez chaque nouvelle vente en USD, EUR, GBP, CAD ou AUD. Découvrez quelles ventes sont converties et comment les remboursements, les litiges et les frais de plateforme sont réglés.

Définissez une devise de règlement préférée pour regrouper tous les nouveaux revenus dans un seul solde. Whop convertit chaque nouvelle vente dans cette devise au moment où l'acheteur paie, ce qui vous évite de convertir de petits soldes avant un versement.

| | Devise d'origine (par défaut) | Devise de règlement préférée |
| - | - | - |
| **Où une vente est réglée** | Un solde dans la devise du plan | Un solde dans la devise de votre choix |
| **Soldes à gérer** | Un par devise de plan | Un seul |
| **Frais supplémentaires** | Aucun | 0,5 % sur chaque vente convertie |

## Choisir une devise

> [tab] Tableau de bord
>
> 1. Dans les paramètres de votre tableau de bord, sélectionnez **Payments**.
> 2. Sous **Preferred settlement currency**, sélectionnez une devise dans **Settle every new sale in**.
> 3. Sélectionnez **Save changes**.

> [tab] API
>
> Envoyez un code de devise en minuscules à [Update Account Preferences](https://docs.whop.com/fr/api-reference/accounts/update-account-preferences.md). Envoyez `null` pour désactiver le paramètre.
>
> ```typescript TypeScript theme={null}
> import { WhopClient } from "@whop/sdk";
>
> const client = new WhopClient({ token: process.env.WHOP_API_KEY });
>
> const preferences = await client.accounts.preferences.update({
> 	account_id: "biz_xxxxxxxxxxxxx",
> 	preferred_settlement_currency: "usd",
> });
>
> console.log(preferences.preferred_settlement_currency_changeable_at);
> ```
>
> ```python Python theme={null}
> import os
>
> from whop_sdk import Whop
>
> client = Whop(token=os.environ["WHOP_API_KEY"])
>
> preferences = client.accounts.preferences.update(
>     account_id="biz_xxxxxxxxxxxxx",
>     preferred_settlement_currency="usd",
> )
>
> print(preferences.preferred_settlement_currency_changeable_at)
> ```
>
> ```ruby Ruby theme={null}
> require "whop_sdk"
>
> client = Whop_sdk::Client.new(token: ENV.fetch("WHOP_API_KEY"))
>
> preferences = client.accounts.preferences.update(
>   account_id: "biz_xxxxxxxxxxxxx",
>   preferred_settlement_currency: "usd"
> )
>
> puts preferences.preferred_settlement_currency_changeable_at
> ```
>
> ```bash cURL theme={null}
> curl -X PATCH "https://api.whop.com/api/v1/accounts/biz_xxxxxxxxxxxxx/preferences" \
>   -H "Authorization: Bearer $WHOP_API_KEY" \
>   -H "Content-Type: application/json" \
>   -d '{ "preferred_settlement_currency": "usd" }'
> ```
>
> La réponse renvoie les préférences du compte :
>
> ```json theme={null}
> {
> 	"preferred_settlement_currency": "usd",
> 	"preferred_settlement_currency_changeable_at": "2026-10-22T14:03:11.000Z"
> }
> ```

Un changement ne s'applique qu'aux nouvelles ventes. L'argent déjà présent dans vos soldes reste dans sa devise.

## Savoir quelles ventes sont converties

Une vente est convertie lorsque la devise de son plan n'est pas votre devise préférée. La devise dans laquelle l'acheteur paie n'y change rien.

Ces ventes ne sont jamais converties :

* Les ventes sur des plans déjà libellés dans votre devise préférée.
* Les achats via l'App Store. Apple les verse en USD.
* Les ventes réglées en dehors de votre solde Whop, comme les ventes passant par un compte Stripe que vous avez connecté.

Whop fixe le taux de change au moment où l'acheteur paie et l'enregistre sur le paiement. Le paramètre n'a aucun effet pour l'acheteur. L'acheteur paie le prix affiché lors du checkout, et le reçu indique ce montant.

## Structure des frais

Chaque vente convertie entraîne des frais de 0,5 %. Vos frais habituels s'appliquent également. Le paiement affiche les 0,5 % sur la ligne **Currency conversion**.

Whop ne facture pas les 0,5 % lorsque l'acheteur paie dans une devise différente de celle du plan. La [tarification adaptative](https://docs.whop.com/fr/payments-and-billing/fees/adaptive-pricing.md) facture déjà cette conversion lors du checkout.

Ces exemples utilisent l'USD comme devise préférée :

| Devise du plan | L'acheteur paie en | Réglée en | Frais de 0,5 % |
| - | - | - | - |
| USD | USD ou EUR | USD | Non. Le plan est déjà en USD. |
| GBP | GBP | USD | Oui |
| GBP | EUR ou USD | USD | Non. L'acheteur a payé dans une autre devise. |
| MXN | MXN | USD | Oui |
| GBP, App Store | GBP | USD | Non. Apple verse en USD. |

## Remboursements et litiges

Un remboursement ou un litige est prélevé sur le solde dans lequel la vente a été réglée.

* Les **remboursements** utilisent le taux de change enregistré sur le paiement. Une variation du taux après la vente ne modifie pas le montant.
* Les **litiges** utilisent le taux de change du jour d'ouverture du litige. Le montant peut différer de celui de la vente convertie.

## Plateformes et sous-comptes

Le paramètre ne s'applique qu'au compte qui le définit. Un sous-compte n'hérite pas du paramètre de sa plateforme, et une plateforme n'hérite pas des paramètres de ses sous-comptes.

Vos frais d'application suivent votre paramètre. Whop convertit chaque frais dans votre devise au taux de change du jour de la vente. La part du sous-compte suit le paramètre du sous-compte.

Whop vous facture 0,5 % sur des frais d'application convertis. Whop ne facture pas les 0,5 % lorsque le plan de la vente est déjà dans votre devise.

## Lire les montants d'un paiement

Un [paiement](https://docs.whop.com/fr/api-reference/payments/payment) indique les montants dans deux devises. Chaque montant inclut sa propre `currency`.

| Champs | Devise | À utiliser pour |
| - | - | - |
| `total`, `subtotal`, `tax_amount`, `refunded_amount`, `amount_after_fees` | La devise de règlement | Soldes, versements et rapprochement du grand livre |
| `presentment_total`, `presentment_tax_amount`, `presentment_refunded_amount` | La devise dans laquelle l'acheteur a payé | Totaux de commande, reçus et e-mails clients |

Pour faire correspondre un paiement à une commande de votre système, comparez `presentment_total`. Le paramètre ne le modifie pas. `presentment_total` n'inclut pas les frais acheteur. Les [webhooks de paiement](https://docs.whop.com/fr/developer/guides/webhooks.md) envoient les mêmes champs.

## Étapes suivantes

> [card] [Référence Account Preferences](https://docs.whop.com/fr/api-reference/accounts/update-account-preferences.md)
>
> Tous les champs de préférence et le scope requis pour chacun.

> [card] [Tarification adaptative](https://docs.whop.com/fr/payments-and-billing/fees/adaptive-pricing.md)
>
> Affichez aux acheteurs les prix dans leur devise locale lors du checkout.


## Related topics

- [SettlementElement](https://docs.whop.com/fr/elements/latest/wallet/balances-settlement.md)
- [ActivityDetailElement](https://docs.whop.com/fr/elements/latest/wallet/activityDetail.md)
- [Balances](https://docs.whop.com/fr/elements/latest/wallet/balances.md)
