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

# Añadir fondos a tu saldo

> Crea una primera recarga en el panel para guardar un método de pago y luego lista los métodos de pago, crea recargas a través de la API y gestiona los webhooks de pago.

**1. Guarda un método de pago en tu cuenta**

Crea una recarga desde el [panel](https://whop.com/dashboard/balance/) o guarda una tarjeta a través de la API con [Create setup intent](https://docs.whop.com/es/api-reference/setup-intents/create-setup-intent.md) y `owner_id` establecido en el ID de tu cuenta. Cualquiera de las dos opciones guarda en tu cuenta un método de pago que puedes reutilizar mediante programación.

**2. Obtén los métodos de pago**

Lista los métodos de pago guardados de tu cuenta:

```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. Crea una recarga**

Crea un depósito en tu cuenta y pasa el método de pago guardado al que se debe cobrar:

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

En este ejemplo:

* `destination` es el ID de la cuenta de tu plataforma
* `amount` es el importe en USD que se añadirá a tu saldo
* `payment_method_id` es el método de pago guardado al que se cobrará

El `methods.card.payment_id` de la respuesta es el pago que creó el cobro. La solicitud necesita una clave de API con el scope `payment:charge`.

**4. Gestiona los eventos de pago**

Escucha los webhooks de pago para confirmar que la recarga se completó correctamente:

```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);
}
```

## Recursos relacionados

> [card] [Cobrar pagos para subcuentas](https://docs.whop.com/es/developer/platforms/collect-payments-for-subaccounts.md)
>
> Transfiere fondos a subcuentas

> [card] [Renderizar el portal de pagos salientes](https://docs.whop.com/es/developer/platforms/render-payout-portal.md)
>
> Permite que los usuarios retiren sus fondos


## Related topics

- [Cobrar pagos para subcuentas](https://docs.whop.com/es/developer/platforms/collect-payments-for-subaccounts.md)
- [Pagos salientes y movimiento de dinero](https://docs.whop.com/es/developer/payouts/overview.md)
- [Saldos](https://docs.whop.com/es/elements/latest/wallet/balances.md)
