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

# Encaisser des paiements pour des sous-comptes

> Encaissez des paiements pour des sous-comptes avec des débits directs et des frais d'application, ou avec des transferts depuis le compte de votre plateforme, ainsi que les limites et les échecs.

Il existe deux façons d'encaisser des paiements pour des sous-comptes :

1. **Débits directs** : créez un checkout pour le sous-compte et prélevez des frais d'application.
2. **Transferts** : encaissez le paiement sur le compte de votre plateforme et transférez ultérieurement les fonds aux sous-comptes.

## Débits directs

Créez une configuration de checkout avec l'ID d'un sous-compte pour débiter les clients directement sur ce sous-compte. Le sous-compte prend en charge les frais Whop, les remboursements et les litiges.

### Fonctionnement

1. Créez une configuration de checkout pour votre sous-compte avec un `application_fee_amount`
2. Lorsqu'un client effectue un achat, Whop crée le débit directement sur le sous-compte
3. Votre plateforme perçoit les frais d'application, et le montant restant revient au sous-compte
4. Le sous-compte gère les éventuels litiges ou remboursements liés à la transaction

### Exemple

Créez une variante en ligne à l'aide de l'entrée de compatibilité nommée `plan`.

```typescript TypeScript theme={null}
import { WhopClient } from "@whop/sdk";

const client = new WhopClient({
	token: "Account API Key",
});

const checkoutConfig = await client.checkoutConfigurations.create({
	account_id: "biz_xxxxxxxxxxxxx", // Subaccount's ID
	variant: {
		initial_price: 10.0,
		billing_type: "one_time",
		application_fee_amount: 1.23,
	},
});

console.log(checkoutConfig.purchase_url);
```

```python Python theme={null}
from whop_sdk import Whop

client = Whop(
    token="Account API Key",
)

checkout_config = client.checkout_configurations.create(
    account_id="biz_xxxxxxxxxxxxx",  # Subaccount's ID
    variant={
        "initial_price": 10.0,
        "billing_type": "one_time",
        "application_fee_amount": 1.23,
    },
)

print(checkout_config.purchase_url)
```

```rust Rust theme={null}
use whop_sdk::prelude::*;

let config = ClientConfig {
    token: Some("Account API Key".to_string()),
    ..Default::default()
};
let client = Whop::new(config).expect("Failed to build client");

let checkout_config = client
    .checkout_configurations
    .create(
        &CreateCheckoutConfigurationsRequest {
            account_id: Some("biz_xxxxxxxxxxxxx".to_string()), // Subaccount's ID
            variant: Some(CreateCheckoutConfigurationsRequestVariant {
                initial_price: Some(10.0),
                billing_type: Some(CreateCheckoutConfigurationsRequestVariantBillingType::OneTime),
                application_fee_amount: Some(1.23),
                ..Default::default()
            }),
            ..Default::default()
        },
        None,
    )
    .await?;

println!("{}", checkout_config.purchase_url.unwrap());
```

```go Go theme={null}
import (
    "context"
    "fmt"
    "log"

    whopsdk "github.com/whopio/whopsdk-go/v2"
    "github.com/whopio/whopsdk-go/v2/client"
    "github.com/whopio/whopsdk-go/v2/option"
)

client := client.NewWhop(option.WithToken("Account API Key"))

checkoutConfig, err := client.CheckoutConfigurations.Create(context.TODO(), &whopsdk.CreateCheckoutConfigurationsRequest{
    AccountID: whopsdk.String("biz_xxxxxxxxxxxxx"), // Subaccount's ID
    Variant: &whopsdk.CreateCheckoutConfigurationsRequestVariant{
        InitialPrice:         whopsdk.Float64(10.0),
        BillingType:          whopsdk.CreateCheckoutConfigurationsRequestVariantBillingTypeOneTime.Ptr(),
        ApplicationFeeAmount: whopsdk.Float64(1.23),
    },
})
if err != nil {
    log.Fatal(err)
}

fmt.Println(*checkoutConfig.PurchaseURL)
```

Dans cet exemple :

* `account_id` est l'ID du sous-compte sur lequel Whop créera le débit
* `variant.initial_price` est le montant total du paiement de la variante (10,00 dollars américains)
* `variant.application_fee_amount` correspond aux frais perçus par votre plateforme (1,23 dollar américain)
* Le sous-compte reçoit 8,77 dollars américains (10,00 - 1,23)

### Limites

* `application_fee_amount` doit être positif et inférieur au montant total du paiement
* Les frais d'application ne peuvent pas dépasser le montant du paiement capturé

## Transferts

Utilisez les transferts lorsque votre plateforme encaisse d'abord le paiement, ou lorsque votre backend décide du montant et du moment du versement à chaque sous-compte.

### Avant de transférer

* **Compte d'origine** : le compte qui envoie les fonds doit avoir réussi la vérification Know Your Customer (KYC) et disposer d'un solde suffisant pour le transfert. Vous pouvez approvisionner le solde depuis le tableau de bord ou via [Ajouter des fonds à votre solde](https://docs.whop.com/fr/developer/platforms/add-funds-to-your-balance.md).
* **Compte de destination** : le destinataire doit déjà avoir un compte Whop. Si ce n'est pas le cas, intégrez-le d'abord avec [Inscrire des sous-comptes](https://docs.whop.com/fr/developer/platforms/enroll-subaccounts.md).
* **Responsabilité du règlement** : avec les transferts, votre plateforme est le marchand officiel (merchant of record) du paiement d'origine. Votre plateforme gère les frais, les litiges et les remboursements liés à ce paiement.

### Exemple

Encaissez le paiement sur le compte de votre plateforme, puis transférez la part du sous-compte :

```typescript TypeScript theme={null}
import { WhopClient } from "@whop/sdk";

const client = new WhopClient({
	token: "Account API Key",
});

const transfer = await client.transfers.create({
	type: "balance",
	amount: 90.0,
	currency: "usd",
	origin_id: "biz_yyyyyyyyyyyyy", // Platform's account ID
	destination_id: "biz_xxxxxxxxxxxxx", // Subaccount's ID
	metadata: {
		order_id: "order_12345",
	},
});

if (transfer.object === "transfer") {
	console.log(transfer.id);
}
```

```python Python theme={null}
from whop_sdk import Whop

client = Whop(
    token="Account API Key",
)

transfer = client.transfers.create(
    type="balance",
    amount=90.0,
    currency="usd",
    origin_id="biz_yyyyyyyyyyyyy",  # Platform's account ID
    destination_id="biz_xxxxxxxxxxxxx",  # Subaccount's ID
    metadata={
        "order_id": "order_12345",
    },
)

if transfer.object == "transfer":
    print(transfer.id)
```

```rust Rust theme={null}
use whop_sdk::prelude::*;

let config = ClientConfig {
    token: Some("Account API Key".to_string()),
    ..Default::default()
};
let client = Whop::new(config).expect("Failed to build client");

let transfer = client
    .transfers
    .create(
        &CreateTransfersRequest {
            amount: 90.0,
            currency: Some("usd".to_string()),
            origin_id: "biz_yyyyyyyyyyyyy".to_string(), // Platform's account ID
            destination_id: Some("biz_xxxxxxxxxxxxx".to_string()), // Subaccount's ID
            metadata: Some(HashMap::from([("order_id".to_string(), json!("order_12345"))])),
            ..Default::default()
        },
        None,
    )
    .await?;

if let CreateTransfersResponse::Transfer { id, .. } = &transfer {
    println!("{id}");
}
```

```go Go theme={null}
import (
    "context"
    "fmt"
    "log"

    whopsdk "github.com/whopio/whopsdk-go/v2"
    "github.com/whopio/whopsdk-go/v2/client"
    "github.com/whopio/whopsdk-go/v2/option"
)

client := client.NewWhop(option.WithToken("Account API Key"))

transfer, err := client.Transfers.Create(context.TODO(), &whopsdk.CreateTransfersRequest{
    Amount:        90.0,
    Currency:      whopsdk.String("usd"),
    OriginID:      "biz_yyyyyyyyyyyyy",                 // Platform's account ID
    DestinationID: whopsdk.String("biz_xxxxxxxxxxxxx"), // Subaccount's ID
    Metadata:      map[string]any{"order_id": "order_12345"},
})
if err != nil {
    log.Fatal(err)
}

if transfer.Object == "transfer" {
    fmt.Println(transfer.Transfer.ID)
}
```

Dans cet exemple :

* `origin_id` est l'ID du compte de votre plateforme (sur lequel Whop prélève les fonds)
* `destination_id` est l'ID du sous-compte (sur lequel Whop crédite les fonds)
* `amount` est le montant à transférer
* `metadata` stocke des données personnalisées pour votre référence

### Gérer les échecs de transfert

Les transferts échouent si le compte d'origine n'est pas vérifié, si son solde est insuffisant ou si le compte de destination ne peut pas encore recevoir de fonds. Corrigez la cause sous-jacente avant de réessayer. Ne relancez pas un transfert échoué sans en avoir examiné la cause.

### Usages courants

* Versements planifiés aux créateurs
* Versements aux affiliés
* Répartitions de marketplace après le règlement d'une commande

## Choisir un flux de paiement

| | Débits directs | Transferts |
| - | - | - |
| **Frais** | Le sous-compte paie les frais Whop | La plateforme paie les frais Whop |
| **Litiges** | Le sous-compte gère les litiges | La plateforme gère les litiges |
| **Remboursements** | Le sous-compte gère les remboursements | La plateforme gère les remboursements |

Utilisez les transferts lorsque votre backend contrôle le calendrier et le montant des versements. Utilisez les débits directs lorsque le sous-compte doit assumer les frais, les litiges et les remboursements de l'achat d'origine.

## Référence de l'API

> [card] [Create Checkout Configuration](https://docs.whop.com/fr/api-reference/legacy/checkout-configurations/create-checkout-configuration.md)
>
> Créez des configurations de checkout avec des frais d'application

> [card] [Create Transfer](https://docs.whop.com/fr/api-reference/transfers/create-transfer.md)
>
> Transférez des fonds entre comptes

## Ressources associées

> [card] [Accepter des paiements](https://docs.whop.com/fr/developer/guides/accept-payments.md)
>
> Découvrez les liens de checkout et l'élément Checkout

> [card] [Inscrire des sous-comptes](https://docs.whop.com/fr/developer/platforms/enroll-subaccounts.md)
>
> Créez les comptes destinataires et finalisez leur onboarding avant de leur verser des fonds


## Related topics

- [Ajouter des fonds à votre solde](https://docs.whop.com/fr/developer/platforms/add-funds-to-your-balance.md)
- [Inscrire des sous-comptes](https://docs.whop.com/fr/developer/platforms/enroll-subaccounts.md)
- [Activer les versements des sous-comptes](https://docs.whop.com/fr/developer/platforms/render-payout-portal.md)
