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.
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
- Instala el SDK WhopCheckout
- Una clave de API restringida a
iap:read: consulta Crea una clave de API - Un producto de Whop con una variante de pago único (consulta el Paso 5)
Paso 1: Configura el SDK
Inicializa el SDK al iniciar la app. Para bienes físicos de pago único no necesitas la propiedad de compatibilidadplanMappings: solo se usa para el fallback a StoreKit en las suscripciones.
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.
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ámetrolabel 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 eventopayment.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

