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

# Activar Apple Pay y Google Pay

> Aloja el archivo de verificación de Apple Pay y registra tu dominio para que Apple Pay y Google Pay funcionen en Whop Elements en tu sitio.

Apple Pay y Google Pay permiten a los clientes pagar con el monedero que ya tienen en su dispositivo. Cuando un elemento de checkout o de pago de [Whop Elements](https://docs.whop.com/es/elements/latest/getting-started.md) se renderiza en tu propio sitio, ambos monederos requieren que Apple Pay esté listo en el dominio de la página. Un dominio con Apple Pay listo habilita ambos monederos para todos los elementos de esa página.

> [!NOTE]
>
> La verificación del dominio solo es necesaria para las páginas que alojas tú. Las páginas de checkout
> alojadas por Whop y whop.com ya están aprobadas.

## Requisitos previos

Antes de configurar Apple Pay, comprueba que tienes:

* Un dominio en el que vas a montar Whop Elements
* La posibilidad de alojar un archivo en ese dominio (para servir el archivo de verificación de Apple Pay)

## Verificación autoalojada

Para verificar tu dominio, sirve el archivo de asociación de dominio del ID de comerciante de Apple Pay en una ruta concreta de tu dominio y, después, registra el dominio en Whop.

### Paso 1: Descarga el archivo de verificación

Descarga el [archivo de verificación de Apple Pay](https://whop.com/.well-known/apple-platform-integrator/apple-developer-merchantid-domain-association).

### Paso 2: Aloja el archivo

Aloja este archivo en la siguiente ruta de tu dominio:

```
https://<your-domain>/.well-known/apple-developer-merchantid-domain-association
```

El archivo debe:

* Servirse a través de HTTPS
* Ser accesible sin autenticación
* Servirse con el contenido correcto (sin modificaciones)

> [tab] Next.js
>
> Coloca el archivo en tu carpeta `public`:
>
> ```
> public/
> └── .well-known/
>     └── apple-developer-merchantid-domain-association
> ```

> [tab] Nginx
>
> Añade un bloque location para servir el archivo:
>
> ```nginx theme={null}
> location /.well-known/apple-developer-merchantid-domain-association {
>     alias /path/to/apple-developer-merchantid-domain-association;
>     default_type application/octet-stream;
> }
> ```

> [tab] Vercel
>
> Crea un `vercel.json` con una regla de reescritura que redirija al archivo alojado en whop.com:
>
> ```json theme={null}
> {
>   "rewrites": [
>     {
>       "source": "/.well-known/apple-developer-merchantid-domain-association",
>       "destination": "https://whop.com/.well-known/apple-platform-integrator/apple-developer-merchantid-domain-association"
>     }
>   ]
> }
> ```

> [tab] Cloudflare Pages
>
> Coloca el archivo en tu directorio de salida:
>
> ```
> dist/
> └── .well-known/
>     └── apple-developer-merchantid-domain-association
> ```

### Paso 3: Verifica el acceso al archivo

Comprueba que puedes acceder al archivo visitando:

```
https://<your-domain>/.well-known/apple-developer-merchantid-domain-association
```

El archivo debería descargarse o mostrar su contenido sin errores.

### Paso 4: Registra tu dominio

Registra el dominio desde el panel o a través de la API. En ambos casos, Whop comprueba que el archivo sea accesible antes de registrar el dominio en Apple.

> [tab] Panel
>
> Abre **Websites** en tu panel y selecciona el dominio. Selecciona **Fix Apple Pay**, sigue los pasos y, después, selecciona **Check now**.

> [tab] API
>
> Añade el dominio con Apple Pay a través de la [API de dominios](https://docs.whop.com/es/api-reference/domains/domain). Si tu cuenta ya tiene el dominio, [actualízalo](https://docs.whop.com/es/api-reference/domains/update-domain.md) con `apple_pay: {}` en su lugar. Tu clave de API necesita el permiso `domain:manage`.
>
> ```typescript TypeScript theme={null}
> import { WhopClient } from "@whop/sdk";
>
> const client = new WhopClient({ token: process.env.WHOP_API_KEY });
>
> const domain = await client.domains.create({
>   domain: "shop.example.com",
>   apple_pay: {},
> });
>
> console.log(domain.apple_pay?.state); // "pending" while Whop registers the domain with Apple
> ```
>
> ```python Python theme={null}
> import os
> from whop_sdk import Whop
>
> client = Whop(token=os.environ["WHOP_API_KEY"])
>
> domain = client.domains.create(domain="shop.example.com", apple_pay={})
>
> print(domain.apple_pay.state)  # "pending" while Whop registers the domain with Apple
> ```
>
> Whop registra el dominio en Apple en segundo plano. [Obtén el dominio](https://docs.whop.com/es/api-reference/domains/retrieve-domain.md) hasta que `apple_pay.state` sea `ready`, o `action_required` si Apple no pudo obtener el archivo. Una vez que alojes el archivo, vuelve a registrar un dominio con estado `action_required` mediante [Check Domain](https://docs.whop.com/es/api-reference/domains/check-domain.md):
>
> ```typescript TypeScript theme={null}
> await client.domains.check({ id: domain.id });
> ```
>
> ```python Python theme={null}
> client.domains.check(id=domain.id)
> ```
>
> La API de dominios sustituye a la API obsoleta Payment Method Domains. El [registro de cambios de la API](https://docs.whop.com/es/developer/api/versioning.md) indica la equivalencia de cada una de sus solicitudes en la API de dominios.

## Solución de problemas

> [accordion] El botón de Apple Pay o Google Pay no aparece
>
> * Asegúrate de que tu dominio aparezca como verificado en **Payment domains** o devuelva `apple_pay.state: "ready"` desde la [API de dominios](https://docs.whop.com/es/api-reference/domains/retrieve-domain.md).
> * El [ExpressCheckoutElement](https://docs.whop.com/es/elements/latest/checkout/expressCheckout.md) solo renderiza los monederos con los que puede pagar el dispositivo del comprador y no renderiza nada cuando no hay ningún monedero disponible. Prueba Apple Pay en Safari en un dispositivo Apple real, no en un simulador.
> * Si usas **Framer**, carga el script de Elements mediante Custom Code en las cabeceras de tu sitio, no mediante el componente Embed. El componente Embed de Framer usa un iframe `srcdoc`, que Safari trata como un contexto no seguro y en el que bloquea Apple Pay.

> [accordion] El archivo autoalojado devuelve un error 404
>
> * Verifica que el archivo esté en la ubicación correcta:
>   `/.well-known/apple-developer-merchantid-domain-association`.
> * Comprueba que tu servidor web sirva archivos sin extensión.
> * Asegúrate de que la configuración de tu alojamiento no bloquee el directorio `.well-known`.

## Próximos pasos

> [card] [Express Checkout](https://docs.whop.com/es/developer/guides/express-checkout.md)
>
> Añade a tu sitio botones de Apple Pay y Google Pay de un solo toque

> [card] [Enlaces de checkout](https://docs.whop.com/es/payments/create-checkout-link.md)
>
> Crea enlaces de checkout que se pueden compartir para tus productos


## Related topics

- [Primeros pasos con Elements](https://docs.whop.com/es/elements/latest/getting-started.md)
- [Referencia del SDK de Checkout para iOS](https://docs.whop.com/es/developer/guides/ios/checkout-reference.md)
- [Acepta pagos únicos](https://docs.whop.com/es/developer/guides/ios/accept-one-time-payments.md)
