Skip to main content
Usa Checkout.ApplePayButton para aceptar pagos únicos por bienes físicos o servicios del mundo real con Apple Pay. Whop procesa los pagos a 2.7% + $0.30 en lugar de las comisiones del 15–30% de Apple por compras dentro de la app.
Para ventas web, usa enlaces de checkout o el elemento Checkout con más de 100 métodos de pago en 195 países.
Apple Pay no es para contenido digital. Usa Checkout.ApplePayButton solo si tu app vende bienes físicos (merchandising, comida, hardware) o servicios del mundo real (entradas para eventos, entregas). Las apps que venden contenido digital (funciones premium, suscripciones, moneda dentro de la app, desbloqueo de contenido) deben usar StoreKit. Consulta la sección Elegibilidad de Apple Pay para más detalles.

Qué vas a crear

  • Una pantalla de detalle de producto con un botón nativo de Apple Pay
  • Un flujo de compra que gestiona el éxito, el fallo y la cancelación
  • La configuración de variantes en el panel de Whop para tus bienes físicos

Requisitos previos

Paso 1: Configura el SDK

Inicializa el SDK al iniciar la app. Para bienes físicos de pago único no necesitas la propiedad de compatibilidad planMappings: solo se usa para el fallback a StoreKit en las suscripciones.
Consulta la guía de instalación para ver la configuración completa y las notas de seguridad sobre la clave de API.

Paso 2: Añade el botón de Apple Pay

Coloca Checkout.ApplePayButton en la vista de tu producto. El componente renderiza el botón oficial de Apple Pay que cumple las Human Interface Guidelines de Apple; no puedes sustituirlo por un botón con estilo personalizado.
Cuando el usuario toca el botón, aparece la hoja nativa de Apple Pay. Face ID o un doble clic confirman, y el pago fluye a través de Whop.
onCompletion no se llama cuando el usuario cancela: la hoja simplemente se cierra. No hace falta limpiar nada.

Paso 3: Elige una etiqueta para el botón

El parámetro label controla el texto del botón. Elige el que mejor se ajuste a la acción: La lista completa proviene de PayWithApplePayButtonLabel de Apple: consulta la documentación de Apple para ver todas las opciones.

Paso 4: Gestiona el resultado de la compra

onCompletion recibe un Result<CheckoutPurchaseResult, Error>. Si tiene éxito, recibes: Úsalo para mostrar una pantalla de confirmación, iniciar el envío o guardar el recibo en tus propios registros.

Paso 5: Configura tu variante

Cada artículo que se puede comprar necesita una variante en tu panel de Whop:
1

Crea una variante

Ve a tu panel > Products > selecciona tu producto > Variants > Create variant.
2

Configúrala como pago único

Elige One-time payment y establece el precio.
3

(Opcional) Establece límites de inventario

Para lanzamientos limitados, establece un tope de stock. El checkout lo aplica automáticamente: cuando se agota el stock, se detienen las compras.
4

Copia el ID de la variante

El ID conserva el prefijo plan_. Pásalo mediante el parámetro de compatibilidad Checkout.ApplePayButton(planId:).

Gestiona el fulfillment con webhooks

Para bienes físicos, necesitarás un webhook del lado del servidor que active el envío tras una compra correcta. Escucha el evento payment.succeeded:
El callback onCompletion del lado del cliente confirma el pago al usuario, pero tu servidor debe gestionar el fulfillment mediante webhooks: no dependas solo del cliente. Consulta la guía de webhooks completa para configurarlos.

Ejemplo completo

Una vista mínima de detalle de merchandising con selección de talla y Apple Pay:

Próximos pasos

Webhooks

Gestiona eventos de pago y activa el fulfillment

Elegibilidad de Apple Pay

Confirma que tu app cumple los requisitos de las App Store Review Guidelines

Crea un paywall

Vende suscripciones en lugar de compras únicas

Referencia de la API

Documentación completa del SDK