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

# Majorations de frais et subventions

> Configurez des majorations de frais de plateforme et des subventions de versement pour les sous-comptes, avec des exemples, les limites prises en charge et les exigences de solde disponible.

Les majorations de frais permettent à votre plateforme d'ajuster ce que paient les sous-comptes en plus des frais de Whop. Les majorations positives génèrent des revenus pour votre plateforme. Les majorations de versement négatives subventionnent les frais de retrait d'un sous-compte à partir du solde de votre plateforme. Whop perçoit toujours l'intégralité de ses frais.

## Configurer les majorations

Utilisez la clé API de votre plateforme avec la permission `company:update_child_fees`. [Récupérez les frais du compte](https://docs.whop.com/fr/api-reference/accounts/retrieve-account-fees.md) pour voir les taux effectifs, les valeurs par défaut et si chaque majoration est ajustable.

[Mettez à jour les frais du compte](https://docs.whop.com/fr/api-reference/accounts/update-account-fees.md) avec `PATCH /api/v1/accounts/{account_id}/fees` :

| S'applique à | ID de compte dans l'URL | Section de la requête |
| - | - | - |
| Sous-comptes sans taux personnalisé | Votre plateforme | `child_markups` |
| Un seul sous-compte | Ce sous-compte | `markups` |

Chaque majoration comporte un `percentage` et un montant `fixed`. `percentage: 1` signifie 1 %. Définissez `fixed` en dollars américains. Les majorations de versement sont converties dans la devise du retrait au moment où elles sont prélevées.

Cet exemple définit pour un sous-compte une majoration de versement par virement bancaire de 1 % moins 0,60 \$ :

```bash theme={null}
curl --request PATCH \
  --url https://api.whop.com/api/v1/accounts/biz_SUBACCOUNT_ID/fees \
  --header "Authorization: Bearer $WHOP_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "markups": {
      "payouts": {
        "bank_wire": { "percentage": 1, "fixed": -0.60 }
      }
    }
  }'
```

Pour une valeur par défaut de plateforme, envoyez le même objet `payouts` sous `child_markups` à l'ID de compte de votre plateforme. Définissez un taux pour chaque méthode de versement à l'aide des clés renvoyées par l'endpoint des frais.

## Majorations de paiement par moyen de paiement

`payments` est la majoration appliquée à chaque paiement qu'un sous-compte reçoit sans frais d'application de checkout. Pour facturer différemment un moyen de paiement, définissez-le sous `payment_methods` :

| Clé | Moyens de paiement |
| - | - |
| `card` | Cartes, y compris Apple Pay et Google Pay |
| `ach` | Paiements par compte bancaire américain et virements bancaires américains |
| `wire` | Virements bancaires, nationaux et internationaux |

Tous les autres moyens de paiement utilisent la majoration `payments`.

```json theme={null}
{
  "child_markups": {
    "payments": { "percentage": 2, "fixed": 0.30 },
    "payment_methods": {
      "card": { "percentage": 3, "fixed": 0.30 },
      "ach": { "percentage": 1, "fixed": 0 }
    }
  }
}
```

### Majorations de carte par région

Le taux de carte propre à Whop dépend de la région de l'acquéreur qui traite le paiement. Pour tarifer différemment les cartes selon la région, définissez `card_regions`. Un paiement par carte provenant d'une région sans majoration propre utilise `payment_methods.card`.

| Clé | Paiements par carte traités par un acquéreur situé |
| - | - |
| `usa` | Aux États-Unis |
| `eu` | En Europe |
| `uk` | Au Royaume-Uni |
| `ca` | Au Canada |
| `au` | En Australie |

```json theme={null}
{
  "child_markups": {
    "card_regions": {
      "usa": { "percentage": 0.55, "fixed": 0.30 },
      "uk": { "percentage": 0.5, "fixed": 0.20 }
    }
  }
}
```

Un paiement utilise la première majoration trouvée, dans cet ordre :

1. La majoration du sous-compte pour la région du paiement par carte.
2. La majoration du sous-compte pour son moyen de paiement.
3. La majoration `payments` du sous-compte.
4. La valeur par défaut de la plateforme pour la région du paiement par carte.
5. La valeur par défaut de la plateforme pour son moyen de paiement.
6. La valeur par défaut `payments` de la plateforme.

Les étapes 1 et 4 ne s'appliquent qu'aux paiements par carte. Un taux défini pour un sous-compte l'emporte toujours sur une valeur par défaut de la plateforme.

## Modifier ou supprimer une majoration

* Les champs omis conservent leurs valeurs effectives. Pour une majoration uniquement en pourcentage, définissez explicitement `fixed: 0`.
* Définissez à la fois `percentage: 0` et `fixed: 0` pour désactiver une majoration pour ce compte. Le sous-compte paie toujours les frais de Whop.
* Envoyez `null` pour l'ensemble du taux, par exemple `markups: { payouts: { bank_wire: null } }`, pour supprimer la surcharge d'un sous-compte et rétablir la valeur par défaut de sa plateforme, ou zéro s'il n'en existe pas.

## Fonctionnement des subventions de versement

La majoration combine le pourcentage du montant retiré avec le montant fixe. Si le résultat est négatif, votre plateforme paie ce montant au titre des frais de Whop. La subvention s'arrête lorsque les frais totaux du sous-compte atteignent zéro. Elle n'augmente jamais le versement au-delà du montant retiré.

Ces exemples utilisent un retrait de 10 $et des frais Whop de 0,60$. Ces 0,60 \$ sont un taux d'exemple, et non un prix standard pour toutes les méthodes de versement.

| Pourcentage | Fixe | Frais du sous-compte | Versement net | Whop perçoit | Variation du solde de la plateforme |
| - | - | - | - | - | - |
| 0,4 % | 2,00 \$ | 2,64 \$ | 7,36 \$ | 0,60 \$ | +2,04 \$ |
| 1 % | −0,60 \$ | 0,10 \$ | 9,90 \$ | 0,60 \$ | −0,50 \$ |
| −5 % | 0,00 \$ | 0,10 \$ | 9,90 \$ | 0,60 \$ | −0,50 \$ |
| 0 % | −100,00 \$ | 0,00 \$ | 10,00 \$ | 0,60 \$ | −0,60 \$ |

## Limites et financement

| Règle | Comportement |
| - | - |
| Limites des majorations de versement | Chaque composante peut être négative : de −100 % à 100 %, et de −100 $à 100$ pour le montant fixe. La subvention réelle ne peut pas dépasser les frais de Whop. |
| Limites des autres majorations | De 0 % à 100 %, et de 0 $à 100$ pour le montant fixe. Les valeurs négatives sont rejetées pour les majorations autres que de versement. |
| Solde de la plateforme | Conservez un solde disponible suffisant dans la devise du retrait pour couvrir la subvention. La vérification du solde et le débit ont lieu simultanément. |
| Solde insuffisant | Le versement reste en attente pendant que Whop réessaie. Approvisionnez la plateforme avant la date limite de création, environ 10 minutes. Sinon, le versement échoue sans déplacer de fonds. |
| Couverture totale des frais | Lorsque `covered_payout_fees` couvre la méthode de versement, la plateforme paie l'intégralité des frais de Whop et la majoration est ignorée. |

Pour un retrait depuis un solde en EUR, votre plateforme a besoin d'EUR pour financer la subvention. Un solde en USD ne la couvre pas automatiquement.

Consultez un [devis de versement](https://docs.whop.com/fr/api-reference/payouts/create-payout-quote.md) avant de créer le versement. Un devis indique les frais mais ne réserve pas de fonds de la plateforme. Le solde de la plateforme est vérifié au moment où le versement est débité. Les frais réels dépendent de la méthode de versement et de la tarification de votre compte.


## Related topics

- [API Accounts](https://docs.whop.com/fr/api-reference/accounts/account.md)
- [Majoration de frais](https://docs.whop.com/fr/api-reference/legacy/fee-markups/fee-markup.md)
- [Référence de l'API Stats](https://docs.whop.com/fr/api-reference/stats/stats.md)
