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

# Recargos y subvenciones de comisiones

> Configura recargos sobre las comisiones de plataforma y subvenciones de pagos salientes para subcuentas, con ejemplos, límites admitidos y requisitos de saldo disponible.

Los recargos sobre comisiones permiten que tu plataforma ajuste lo que pagan las subcuentas además de las comisiones de Whop. Los recargos positivos generan ingresos para tu plataforma. Los recargos negativos sobre pagos salientes subvencionan la comisión de retirada de una subcuenta con el saldo de tu plataforma. Whop sigue recibiendo su comisión completa.

## Configurar recargos

Usa la clave de API de tu plataforma con el permiso `company:update_child_fees`. [Obtén las comisiones de la cuenta](https://docs.whop.com/es/api-reference/accounts/retrieve-account-fees.md) para ver las tarifas efectivas, los valores predeterminados y si cada recargo es ajustable.

[Actualiza las comisiones de la cuenta](https://docs.whop.com/es/api-reference/accounts/update-account-fees.md) con `PATCH /api/v1/accounts/{account_id}/fees`:

| Se aplica a | ID de cuenta en la URL | Sección de la solicitud |
| - | - | - |
| Subcuentas sin una tarifa personalizada | Tu plataforma | `child_markups` |
| Una subcuenta | Esa subcuenta | `markups` |

Cada recargo tiene un `percentage` y un importe `fixed`. `percentage: 1` significa 1 %. Establece `fixed` en dólares estadounidenses. Los recargos sobre pagos salientes se convierten a la moneda de la retirada cuando se cobran.

Este ejemplo establece un recargo sobre pagos salientes por transferencia bancaria de 1 % menos 0,60 \$ para una subcuenta:

```bash theme={null}
curl --request PATCH \
  --url https://api.whop.com/api/v1/accounts/biz_SUBACCOUNT_ID/fees \
  --header "Authorization: Bearer $WHOP_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "markups": {
      "payouts": {
        "bank_wire": { "percentage": 1, "fixed": -0.60 }
      }
    }
  }'
```

Para un valor predeterminado de plataforma, envía el mismo objeto `payouts` dentro de `child_markups` al ID de cuenta de tu plataforma. Establece una tarifa para cada método de pago saliente usando las claves que devuelve el endpoint de comisiones.

## Recargos de pago por método de pago

`payments` es el recargo sobre cada pago que recibe una subcuenta sin comisión de aplicación en el checkout. Para cobrar de forma distinta un método de pago, configúralo dentro de `payment_methods`:

| Clave | Métodos de pago |
| - | - |
| `card` | Tarjetas, incluidos Apple Pay y Google Pay |
| `ach` | Pagos con cuenta bancaria de EE. UU. y transferencias bancarias de EE. UU. |
| `wire` | Transferencias bancarias, nacionales e internacionales |

Todos los demás métodos de pago usan el recargo `payments`.

```json theme={null}
{
  "child_markups": {
    "payments": { "percentage": 2, "fixed": 0.30 },
    "payment_methods": {
      "card": { "percentage": 3, "fixed": 0.30 },
      "ach": { "percentage": 1, "fixed": 0 }
    }
  }
}
```

### Recargos de tarjeta por región

La tarifa de tarjeta propia de Whop depende de la región del adquirente que procesa el pago. Para fijar precios distintos para las tarjetas en cada región, establece `card_regions`. Un pago con tarjeta de una región sin recargo propio usa `payment_methods.card`.

| Clave | Pagos con tarjeta procesados por un adquirente en |
| - | - |
| `usa` | Estados Unidos |
| `eu` | Europa |
| `uk` | Reino Unido |
| `ca` | Canadá |
| `au` | Australia |

```json theme={null}
{
  "child_markups": {
    "card_regions": {
      "usa": { "percentage": 0.55, "fixed": 0.30 },
      "uk": { "percentage": 0.5, "fixed": 0.20 }
    }
  }
}
```

Un pago usa el primer recargo que encuentra, en este orden:

1. El recargo de la subcuenta para la región del pago con tarjeta.
2. El recargo de la subcuenta para su método de pago.
3. El recargo `payments` de la subcuenta.
4. El valor predeterminado de la plataforma para la región del pago con tarjeta.
5. El valor predeterminado de la plataforma para su método de pago.
6. El valor predeterminado `payments` de la plataforma.

Los pasos 1 y 4 solo se aplican a los pagos con tarjeta. Una tarifa establecida para una subcuenta siempre prevalece sobre un valor predeterminado de la plataforma.

## Cambiar o borrar un recargo

* Los campos omitidos conservan sus valores efectivos. Para un recargo solo porcentual, establece explícitamente `fixed: 0`.
* Establece `percentage: 0` y `fixed: 0` para desactivar un recargo en esa cuenta. La subcuenta sigue pagando la comisión de Whop.
* Envía `null` para toda la tarifa, como `markups: { payouts: { bank_wire: null } }`, para eliminar una anulación de la subcuenta y restaurar el valor predeterminado de su plataforma, o cero si no existe ninguno.

## Cómo funcionan las subvenciones de pagos salientes

El recargo combina el porcentaje del importe de la retirada con el importe fijo. Si el resultado es negativo, tu plataforma paga ese importe a cuenta de la comisión de Whop. La subvención se detiene cuando la comisión total de la subcuenta llega a cero. Nunca aumenta el pago saliente por encima del importe de la retirada.

Estos ejemplos usan una retirada de 10 $y una comisión de Whop de 0,60$. Los 0,60 \$ son una tarifa de ejemplo, no un precio estándar para todos los métodos de pago saliente.

| Porcentaje | Fijo | Comisión de la subcuenta | Pago saliente neto | Whop recibe | Cambio en el saldo de la plataforma |
| - | - | - | - | - | - |
| 0.4% | \$2.00 | \$2.64 | \$7.36 | \$0.60 | +\$2.04 |
| 1% | −\$0.60 | \$0.10 | \$9.90 | \$0.60 | −\$0.50 |
| −5% | \$0.00 | \$0.10 | \$9.90 | \$0.60 | −\$0.50 |
| 0% | −\$100.00 | \$0.00 | \$10.00 | \$0.60 | −\$0.60 |

## Límites y financiación

| Regla | Comportamiento |
| - | - |
| Límites de recargo sobre pagos salientes | Cada componente puede ser negativo: de −100 % a 100 %, y de −100 $a 100$ fijos. La subvención real no puede superar la comisión de Whop. |
| Otros límites de recargo | De 0 % a 100 %, y de 0 $a 100$ fijos. Los valores negativos se rechazan en los recargos que no son de pagos salientes. |
| Saldo de la plataforma | Mantén suficiente saldo disponible en la moneda de la retirada para cubrir la subvención. La comprobación del saldo y el cargo se producen a la vez. |
| Saldo insuficiente | El pago saliente queda pendiente mientras Whop reintenta. Aporta fondos a la plataforma antes del plazo de creación, unos 10 minutos. De lo contrario, el pago saliente falla sin mover fondos. |
| Cobertura total de la comisión | Cuando `covered_payout_fees` cubre el método de pago saliente, la plataforma paga toda la comisión de Whop y el recargo se ignora. |

Para una retirada desde un saldo en EUR, tu plataforma necesita EUR para financiar la subvención. Un saldo en USD no la cubre automáticamente.

Revisa un [presupuesto de pago saliente](https://docs.whop.com/es/api-reference/payouts/create-payout-quote.md) antes de crear el pago saliente. Un presupuesto muestra las comisiones, pero no reserva fondos de la plataforma. El saldo de la plataforma se comprueba cuando se carga el pago saliente. Las comisiones reales dependen del método de pago saliente y de las tarifas de tu cuenta.


## Related topics

- [API de Accounts](https://docs.whop.com/es/api-reference/accounts/account.md)
- [Recargo de comisión](https://docs.whop.com/es/api-reference/legacy/fee-markups/fee-markup.md)
- [Create fee markup](https://docs.whop.com/es/api-reference/legacy/fee-markups/create-fee-markup.md)
