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

# Ajouter des fonds à votre solde

> Effectuez un premier approvisionnement dans le tableau de bord pour enregistrer un moyen de paiement, puis listez les moyens de paiement, créez des approvisionnements via l'API et gérez les webhooks de paiement.

**1. Enregistrer un moyen de paiement sur votre compte**

Effectuez un approvisionnement depuis le [tableau de bord](https://whop.com/dashboard/balance/), ou enregistrez une carte via l'API avec [Create setup intent](https://docs.whop.com/fr/api-reference/setup-intents/create-setup-intent.md) en définissant `owner_id` sur l'ID de votre compte. Dans les deux cas, un moyen de paiement est enregistré sur votre compte et vous pouvez le réutiliser par programmation.

**2. Obtenir les moyens de paiement**

Listez les moyens de paiement enregistrés pour votre compte :

```typescript TypeScript theme={null}
const paymentMethods = await client.paymentMethods.list({
  account_id: "biz_xxxxxxxxxxxxx",
});

const paymentMethod = paymentMethods.data[0];
```

```python Python theme={null}
payment_methods = client.payment_methods.list(
    account_id="biz_xxxxxxxxxxxxx",
)

payment_method = payment_methods.items[0]
```

```rust Rust theme={null}
let payment_methods = client
    .payment_methods
    .list(
        &PaymentMethodsListQueryRequest {
            account_id: Some("biz_xxxxxxxxxxxxx".to_string()),
            ..Default::default()
        },
        None,
    )
    .await?;

let payment_method = &payment_methods.data[0];
println!("{payment_method:?}");
```

```go Go theme={null}
page, err := client.PaymentMethods.List(context.TODO(), &whopsdk.ListPaymentMethodsRequest{
    AccountID: whopsdk.String("biz_xxxxxxxxxxxxx"),
})
if err != nil {
    log.Fatal(err)
}

paymentMethod := page.Results[0]
fmt.Println(paymentMethod)
```

**3. Créer un approvisionnement**

Créez un dépôt sur votre compte et transmettez le moyen de paiement enregistré à débiter :

```typescript TypeScript theme={null}
const deposit = await client.deposits.create({
  destination: "biz_xxxxxxxxxxxxx",
  amount: 1000.0,
  payment_method_id: paymentMethod.id,
});

console.log(deposit.methods.card?.payment_id);
```

```python Python theme={null}
deposit = client.deposits.create(
    destination="biz_xxxxxxxxxxxxx",
    amount=1000.0,
    payment_method_id=payment_method.id,
)

print(deposit.methods.card.payment_id)
```

Dans cet exemple :

* `destination` est l'ID du compte de votre plateforme
* `amount` est le montant en USD à ajouter à votre solde
* `payment_method_id` est le moyen de paiement enregistré à débiter

Le champ `methods.card.payment_id` de la réponse correspond au paiement créé par le débit. La requête nécessite une clé API disposant du scope `payment:charge`.

**4. Gérer les événements de paiement**

Écoutez les webhooks de paiement pour confirmer que l'approvisionnement a réussi :

```typescript theme={null}
if (webhookData.type === "payment.succeeded") {
  const payment = webhookData.data;
  console.log("Top up successful:", payment.id);
}

if (webhookData.type === "payment.failed") {
  const payment = webhookData.data;
  console.log("Top up failed:", payment.failure_message);
}
```

## Ressources associées

> [card] [Encaisser des paiements pour des sous-comptes](https://docs.whop.com/fr/developer/platforms/collect-payments-for-subaccounts.md)
>
> Transférez des fonds vers des sous-comptes

> [card] [Afficher le portail de versement](https://docs.whop.com/fr/developer/platforms/render-payout-portal.md)
>
> Permettez aux utilisateurs de retirer leurs fonds
