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

# Personalización de marca del checkout

> Personaliza el aspecto de tus páginas de checkout con colores de botón, fuentes y estilos de borde

La personalización de marca del checkout te permite adaptar tus páginas de checkout a tu marca. Elige un color de fondo, un color de botón, una fuente y un estilo de borde a nivel de cuenta y, opcionalmente, sobrescríbelos para cada enlace de pago o para cada sesión de checkout mediante la API.

> [card] [Prueba el entorno de pruebas del checkout](https://whop.com/checkout-playground)
>
> Previsualiza el color de fondo, el color de botón, la fuente y el estilo de borde en un checkout real antes de aplicarlos.

## Qué puedes personalizar

| Ajuste | Descripción |
| - | - |
| **Color de fondo** | Un código de color hexadecimal que se aplica al panel de resumen del pedido en la página de checkout (p. ej., `#F4F4F5`) |
| **Color del botón** | Un código de color hexadecimal para el color del botón (p. ej., `#FF5733`) |
| **Familia de fuente** | `system` (predeterminada), `roboto` u `open_sans` |
| **Estilo de borde** | `rounded` (predeterminado), `pill` o `rectangular` |

## Personalización de marca global

La personalización de marca global se aplica a todos los enlaces de pago de tu negocio. Cada enlace hereda estos ajustes salvo que tenga sus propias sobrescrituras.

1. Ve a **Dashboard** > **Settings** > **Checkout Branding**
2. Elige tu **color de fondo**, **color de botón**, **fuente** y **estilo de borde**
3. Usa la vista previa en directo para ver cómo se verá tu checkout
4. Selecciona **Save**

## Sobrescrituras por enlace

Sobrescribe la personalización de marca global en un enlace de pago concreto. Resulta útil cuando un producto o una campaña necesita un aspecto distinto.

1. Ve a **Dashboard** > **Checkout Links**
2. Edita el enlace de pago que quieras personalizar
3. En la sección **Checkout branding**, ajusta cualquier opción
4. Guarda los cambios

Cualquier ajuste que se deje en **Global default** hereda la personalización de marca de la cuenta. Solo se sobrescriben para ese enlace los ajustes que cambies explícitamente.

> [!NOTE]
>
> La personalización de marca por enlace tiene prioridad sobre la global. Si más
> adelante actualizas tus ajustes globales, cualquier enlace con sus propias
> sobrescrituras conserva sus valores personalizados en los ajustes sobrescritos.

## Personalizar sesiones de checkout individuales

Define la personalización de marca en sesiones de checkout individuales con el parámetro `checkoutStyling` al crear una sesión de checkout. La personalización a nivel de sesión tiene la máxima prioridad.

El orden de resolución es: **sesión de checkout** > **enlace de pago (plan)** > **valores predeterminados de la cuenta**.

```graphql theme={null}
mutation {
	createCheckoutSession(
		input: {
			planId: "plan_XXXXXXXXX"
			checkoutStyling: {
				backgroundColor: "#F4F4F5"
				buttonColor: "#FF5733"
				fontFamily: roboto
				borderStyle: pill
			}
		}
	) {
		id
		purchaseUrl
		checkoutStyling {
			backgroundColor
			buttonColor
			fontFamily
			borderStyle
		}
	}
}
```

### Parámetros

| Campo | Tipo | Descripción |
| - | - | - |
| `backgroundColor` | String | Un código de color hexadecimal (p. ej., `#F4F4F5`). `null` para heredar. |
| `buttonColor` | String | Un código de color hexadecimal (p. ej., `#FF5733`). `null` para heredar. |
| `fontFamily` | enum | `system`, `roboto` u `open_sans`. `null` para heredar. |
| `borderStyle` | enum | `rounded`, `pill` o `rectangular`. `null` para heredar. |

Pasa `null` en cualquier campo para heredar del siguiente nivel de la cadena de resolución.

## Añadir una dirección de correo electrónico conocida

Controla el campo de correo electrónico de las páginas de checkout con parámetros de URL. Esto es útil cuando ya conoces el correo de un cliente gracias a una landing page o a un sistema de gestión de relaciones con clientes (CRM). Así evitas volver a pedirle la dirección de correo.

| Parámetro | Efecto |
| - | - |
| `email` | Rellena el campo de correo electrónico |
| `email.disabled=1` | Bloquea el campo de correo para que el cliente no pueda editarlo |
| `email.hidden=1` | Oculta por completo el campo de correo |

### Ejemplos

Rellenar y bloquear:

```
https://whop.com/checkout/plan_XXXXXXXXX?email=customer@example.com&email.disabled=1
```

Rellenar y ocultar:

```
https://whop.com/checkout/plan_XXXXXXXXX?email=customer@example.com&email.hidden=1
```

> [!NOTE]
>
> Indica el parámetro `email` para usar `email.hidden` o `email.disabled`. Si activas
> ambas opciones, el checkout oculta el campo.

Cuando integres el [elemento Checkout](https://docs.whop.com/es/elements/latest/checkout/checkout.md) en tu propio sitio, pasa `buyerEmail` para rellenar la dirección y `lockBuyerEmail` para impedir que el comprador la edite.

## Añadir un número de teléfono y una dirección conocidos

Rellena el número de teléfono, los datos de facturación y la dirección de envío del cliente con parámetros de URL. El cliente puede seguir editando todos los campos rellenados.

| Parámetro | Efecto |
| - | - |
| `phone` | Rellena el número de teléfono, incluido el teléfono de facturación para los métodos de pago que lo requieren |
| `name` | Rellena el nombre de facturación |
| `address.line1`, `address.line2`, `address.city` | Rellenan la dirección de facturación |
| `address.state`, `address.postal_code`, `address.country` | Rellenan la dirección de facturación |
| `shipping.name` | Rellena el nombre del destinatario del envío |
| `shipping.address.line1`, `shipping.address.city`, … | Rellenan la dirección de envío, con los mismos campos que la dirección de facturación |

Incluye el prefijo internacional en `phone` y codifica el signo más como `%2B`, por ejemplo `phone=%2B14155552671`. Usa un código de país de dos letras para `country`, como `US`.

### Ejemplo

```
https://whop.com/checkout/plan_XXXXXXXXX?email=customer@example.com&phone=%2B14155552671&name=Ada+Lovelace&address.country=US&address.postal_code=94107
```

## Correos electrónicos a clientes

Whop envía correos electrónicos a tus clientes sobre sus compras y suscripciones. El nombre del remitente es el nombre de tu negocio seguido de **via Whop**, por ejemplo **Acme via Whop**. La dirección del remitente es `no-reply@businesses.whop.com`. Si has añadido un logotipo de negocio, aparece en la parte superior de cada correo.

Las subcuentas que una plataforma crea a través de la API empiezan con los correos a clientes desactivados. La plataforma puede activarlos con el campo `send_customer_emails`.

| Correo | Cuándo lo envía Whop |
| - | - |
| **Confirmación de pedido** | Tras una compra única o el primer pago de una membresía. Las compras gratuitas no lo reciben. |
| **Recibo de renovación** | Tras cada cargo de renovación, incluido el primer cargo después de una prueba gratuita, y tras un cargo por cambio de plan. Muestra el importe, el descriptor del extracto de la tarjeta cuando Whop lo tiene y un enlace para actualizar la tarjeta o cancelar. |
| **Próxima renovación** | Una vez por periodo de facturación, antes de que se renueve la suscripción. Las pruebas gratuitas de más de 7 días lo reciben 7 días antes del primer cargo. Los planes facturados cada 6 meses o con menos frecuencia lo reciben 30 días antes de la renovación. Todos los demás lo reciben unas 24 horas antes de la renovación. Whop no lo envía si el miembro ha cancelado o si pausaste sus pagos. |
| **Pago fallido** | Cuando falla un pago de suscripción y [Whop lo reintentará](https://docs.whop.com/es/payments/payment-declines.md). Whop no lo envía en el último intento fallido que cancela la membresía. Algunos métodos de pago, como PayPal, no reciben este correo. |
| **Membresía cancelada** | Cuando tú o el miembro cancelan una membresía, aunque el acceso continúe hasta el final del periodo de facturación. |
| **Reembolso** | Cuando reembolsas un pago. |

En el caso de una prueba gratuita, el correo de próxima renovación es el recordatorio de fin de prueba. Whop no envía un correo de bienvenida aparte. Para dar la bienvenida por correo a los nuevos miembros, configura un [mensaje **User joins**](https://docs.whop.com/es/manage-your-business/growth-marketing/automated-messaging.md) y marca **Send email to user when triggered**.

### Desactivar los correos a clientes

1. Ve a **Dashboard** > **Settings** > **Checkout**
2. Desactiva **Send transactional emails to your members**

> [!WARNING]
>
> Cuando los correos a clientes están desactivados, tus clientes no reciben de Whop confirmaciones de pedido, recibos de renovación, recordatorios de renovación o de fin de prueba ni avisos de pagos fallidos. Estos correos ayudan a los clientes a reconocer los cargos, lo que puede evitar solicitudes de reembolso y disputas.

Esto detiene los correos de esta tabla. Los correos de facturas y los avisos sobre cambios en el calendario de facturación se siguen enviando, al igual que tus mensajes automatizados.

No puedes editar el texto de los correos de Whop. Para enviar tus propios correos, actívalos desde [webhooks](https://docs.whop.com/es/developer/guides/webhooks.md).


## Related topics

- [Controles de pago](https://docs.whop.com/es/trust-and-safety/account-health/controls.md)
- [Opciones de financiación](https://docs.whop.com/es/payments-and-billing/financing/all-bnpl-options.md)
- [Datos de registro del IVA y del GST](https://docs.whop.com/es/payments-and-billing/fees/vat-gst-registration.md)
