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

# Tester dans le sandbox

> Pointez le SDK Whop et Elements vers le sandbox, créez des clés API et des webhooks de test, simulez des paiements avec des cartes de test et passez en revue les limites du sandbox.

Whop fournit un environnement sandbox pour tester votre intégration sans affecter les données de production ni effectuer de paiements réels.

## URL du sandbox

| Environnement | URL |
| - | - |
| Frontend | `https://sandbox.whop.com` |
| API | `https://sandbox-api.whop.com/api/v1` |

Créez votre compte sandbox et vos clés API sur [sandbox.whop.com](https://sandbox.whop.com).

## Configuration du kit de développement logiciel

Pour utiliser l'environnement sandbox avec le SDK Whop, transmettez l'environnement `Sandbox`. Un environnement désigne chaque hôte avec lequel le SDK communique, de sorte que toutes les requêtes basculent vers le sandbox en une seule fois.

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

const client = new WhopClient({
	token: process.env["WHOP_API_KEY"],
	environment: WhopEnvironment.Sandbox,
});
```

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

client = Whop(
    token=os.environ.get("WHOP_API_KEY"),
    environment=WhopEnvironment.SANDBOX,
)
```

```ruby Ruby theme={null}
require "whop_sdk"

client = Whop_sdk::Client.new(
  token: ENV.fetch("WHOP_API_KEY"),
  environment: Whop_sdk::Environment::SANDBOX,
)
```

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

let config = ClientConfig {
    token: Some(std::env::var("WHOP_API_KEY").unwrap()),
    base_url: "https://sandbox-api.whop.com/api/v1".to_string(),
    ..Default::default()
};
let client = Whop::new(config).expect("Failed to build client");
```

```go Go theme={null}
import (
    "os"

    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(os.Getenv("WHOP_API_KEY")),
    option.WithEnvironment(whopsdk.Environments.Sandbox),
)
```

> [!NOTE]
>
> L'environnement `Sandbox` est arrivé avec le SDK 2.0. En 1.x, pointez plutôt le client vers `https://sandbox-api.whop.com/api/v1` : `baseUrl` en TypeScript, `base_url` en Python et Ruby, `option.WithBaseURL` en Go. TypeScript, Ruby et Go conservent cette surcharge en 2.0, mais elle envoie toutes les requêtes vers un seul hôte. Les opérations qui doivent atteindre un autre hôte sont alors refusées : utilisez donc `environment`. Le client Python 2.0 n'a pas de paramètre `base_url`. Le SDK Rust est toujours en 1.x et conserve `base_url`.

## Elements dans le sandbox

Pour pointer [Whop Elements](https://docs.whop.com/fr/elements/latest/getting-started.md) vers le sandbox, définissez `environment` lors de la création de l'instance du SDK. Cette option est le seul moyen de changer la destination de ce qu'un acheteur saisit dans les éléments.

La propriété Elements permettant de sélectionner une variante reste nommée `plan` pour des raisons de compatibilité.

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

function App() {
	return (
		<WhopElements elements={loadWhop()} environment="sandbox">
			<Payments accountId="biz_xxxxxxxxxxxxx" plan="plan_xxxxxxxxxxxxx">
				<PaymentElement />
				<BrandingElement />
			</Payments>
		</WhopElements>
	);
}
```

```html JavaScript theme={null}
<script src="https://cdn.whop.com/elements/amber/elements.js" data-whop-elements></script>
<script type="module">
  const whop = window.WhopElements({ environment: "sandbox" });
  const payments = whop.payments.create({
    accountId: "biz_xxxxxxxxxxxxx",
    plan: "plan_xxxxxxxxxxxxx",
  });
  payments.create("payment").mount("#payment");
  payments.create("branding").mount("#branding");
</script>
```

## Clés d'interface de programmation et webhooks

Les clés API et les webhooks fonctionnent de la même façon dans le sandbox qu'en production :

* Créez des clés API sur [sandbox.whop.com/dashboard/developer](https://sandbox.whop.com/dashboard/developer)
* Configurez des webhooks pour recevoir les événements du sandbox
* Utilisez les mêmes en-têtes d'authentification (`Authorization: Bearer YOUR_API_KEY`)

## Cartes de test

Utilisez les numéros de carte de test suivants pour simuler des paiements dans le sandbox :

| Numéro de carte | Description |
| - | - |
| `4242 4242 4242 4242` | Paiement réussi |
| `4000 0000 0000 0002` | Paiement refusé |
| `4000 0000 0000 0341` | L'enregistrement de la carte réussit, mais le processeur refuse les débits ultérieurs |
| `5385 3083 6013 5181` | Nécessite 3D Secure (saisissez `Checkout1!` sur l'écran 3DS) |

En production, un paiement refusé comporte un code de l'émetteur de la carte. La page [Codes de refus de paiement expliqués](https://docs.whop.com/fr/payments-and-billing/payment-issues/payment-decline-reasons.md) indique la signification de chacun.

Pour toutes les cartes de test :

* Utilisez n'importe quelle date d'expiration future (par exemple 12/34)
* Utilisez n'importe quel cryptogramme visuel à 3 chiffres (par exemple 123)
* Utilisez n'importe quelle adresse de facturation

Utilisez `4000 0000 0000 0341` pour tester les parcours de récupération dans lesquels vous enregistrez une carte
avec succès, mais où un débit ultérieur sur cette carte enregistrée échoue.

## Moyens de paiement dans le sandbox

Pour tester les paiements par carte, utilisez les [cartes de test](#test-cards) ci-dessus.

Ces moyens de paiement aboutissent également dans le sandbox via le parcours de test propre à chaque fournisseur : PayPal, Bancontact, iDEAL, Cash App Pay, Pix et Boleto.

Ces moyens de paiement ne sont pas encore pris en charge dans le sandbox :

* Apple Pay et Google Pay
* Comptes bancaires (ACH)
* Prélèvement SEPA
* Virements bancaires européens et virements télégraphiques
* Alipay, WeChat Pay et MobilePay

## Limites connues

> [!WARNING]
>
> Les fonctionnalités suivantes ne sont pas disponibles dans le sandbox :

* Versements
* Dépôts crypto et transferts on-chain
* Messages directs Discord et synchronisation des rôles
* Résultats de recherche à jour
* Certaines tâches planifiées et en arrière-plan exécutées en production, comme les examens anti-fraude et les e-mails récapitulatifs


## Related topics

- [Authentification et clés API](https://docs.whop.com/fr/developer/guides/auth-scoping.md)
- [IA et MCP](https://docs.whop.com/fr/developer/guides/ai_and_mcp.md)
- [Intégrer un checkout](https://docs.whop.com/fr/developer/guides/embed-checkout.md)
