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

# Pruebas en el sandbox

> Apunta el SDK de Whop y Elements al sandbox, crea claves de API y webhooks de prueba, simula pagos con tarjetas de prueba y revisa las limitaciones del sandbox.

Whop ofrece un entorno sandbox para probar tu integración sin afectar a los datos de producción ni realizar pagos reales.

## URL del sandbox

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

Crea tu cuenta de sandbox y tus claves de API en [sandbox.whop.com](https://sandbox.whop.com).

## Configuración del kit de desarrollo de software

Para usar el entorno sandbox con el SDK de Whop, pasa el entorno `Sandbox`. Un entorno define todos los hosts con los que se comunica el SDK, de modo que todas las solicitudes pasan al sandbox a la vez.

```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]
>
> El entorno `Sandbox` llegó con el SDK 2.0. En 1.x, apunta el cliente a `https://sandbox-api.whop.com/api/v1` en su lugar: `baseUrl` en TypeScript, `base_url` en Python y Ruby, `option.WithBaseURL` en Go. TypeScript, Ruby y Go mantienen esa anulación en 2.0, pero envía todas las solicitudes a un único host. Las operaciones que deben llegar a otro host se rechazan entonces, así que usa `environment`. El cliente de Python 2.0 no tiene el parámetro `base_url`. El SDK de Rust sigue en 1.x y mantiene `base_url`.

## Elements en el sandbox

Para apuntar [Whop Elements](https://docs.whop.com/es/elements/latest/getting-started.md) al sandbox, establece `environment` al crear la instancia del SDK. Esta opción es la única forma de cambiar adónde envían los elements lo que escribe un comprador.

La propiedad de Elements para seleccionar una variante sigue llamándose `plan` por compatibilidad.

```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>
```

## Claves de la interfaz de programación de aplicaciones y webhooks

Las claves de API y los webhooks funcionan igual en el sandbox que en producción:

* Crea claves de API en [sandbox.whop.com/dashboard/developer](https://sandbox.whop.com/dashboard/developer)
* Configura webhooks para recibir eventos del sandbox
* Usa los mismos encabezados de autenticación (`Authorization: Bearer YOUR_API_KEY`)

## Tarjetas de prueba

Usa los siguientes números de tarjeta de prueba para simular pagos en el sandbox:

| Número de tarjeta | Descripción |
| - | - |
| `4242 4242 4242 4242` | Pago correcto |
| `4000 0000 0000 0002` | Pago rechazado |
| `4000 0000 0000 0341` | La configuración de la tarjeta se completa, pero el procesador rechaza los cargos posteriores |
| `5385 3083 6013 5181` | Requiere 3D Secure (introduce `Checkout1!` en la pantalla de 3DS) |

En producción, un pago rechazado incluye un código del emisor de la tarjeta. [Códigos de rechazo de pagos explicados](https://docs.whop.com/es/payments-and-billing/payment-issues/payment-decline-reasons.md) enumera lo que significa cada uno.

Para todas las tarjetas de prueba:

* Usa cualquier fecha de caducidad futura (p. ej., 12/34)
* Usa cualquier código de verificación de tarjeta de 3 dígitos (p. ej., 123)
* Usa cualquier dirección de facturación

Usa `4000 0000 0000 0341` para probar flujos de recuperación en los que guardas una tarjeta
correctamente, pero un cargo futuro a esa tarjeta guardada falla.

## Métodos de pago en el sandbox

Para probar pagos con tarjeta, usa las [tarjetas de prueba](#test-cards) anteriores.

Estos métodos también se completan en el sandbox a través del flujo de prueba propio de cada proveedor: PayPal, Bancontact, iDEAL, Cash App Pay, Pix y Boleto.

Estos métodos aún no son compatibles con el sandbox:

* Apple Pay y Google Pay
* Cuentas bancarias (ACH)
* SEPA Direct Debit
* Transferencias bancarias de la UE y transferencias bancarias internacionales
* Alipay, WeChat Pay y MobilePay

## Limitaciones conocidas

> [!WARNING]
>
> Las siguientes funciones no están disponibles en el sandbox:

* Pagos salientes
* Depósitos de criptomonedas y transferencias on-chain
* Mensajes directos de Discord y sincronización de roles
* Resultados de búsqueda actualizados
* Algunas tareas programadas y en segundo plano que se ejecutan en producción, como las revisiones de fraude y los correos de resumen
