Utilisez
Checkout.ApplePayButton pour accepter des paiements ponctuels pour des biens physiques ou des services réels avec Apple Pay. Whop traite les paiements à 2,7 % + 0,30 $ au lieu des frais d’achat intégré de 15 à 30 % d’Apple.
Ce que vous allez créer
- Un écran de détail produit avec un bouton Apple Pay natif
- Un parcours d’achat qui gère la réussite, l’échec et l’annulation
- La configuration des variantes dans le tableau de bord Whop pour vos biens physiques
Prérequis
- Installer le SDK WhopCheckout
- Une clé API limitée à
iap:read: consultez Créer une clé API - Un produit Whop avec une variante ponctuelle (voir l’étape 5)
Étape 1 : configurer le SDK
Initialisez le SDK au lancement de l’app. Pour des biens physiques ponctuels, vous n’avez pas besoin de la propriété de compatibilitéplanMappings : elle ne sert qu’au repli sur StoreKit pour les abonnements.
Étape 2 : ajouter le bouton Apple Pay
Placez Checkout.ApplePayButton dans la vue de votre produit. Le composant affiche le bouton Apple Pay officiel d’Apple, conforme aux Human Interface Guidelines : vous ne pouvez pas le remplacer par un bouton au style personnalisé.
onCompletion n’est pas appelé lorsque l’utilisateur annule : la feuille se ferme simplement. Aucun nettoyage n’est nécessaire.Étape 3 : choisir un libellé de bouton
Le paramètrelabel contrôle le texte du bouton. Choisissez celui qui correspond à l’action :
La liste complète provient de
PayWithApplePayButtonLabel d’Apple : consultez la documentation d’Apple pour connaître toutes les options.
Étape 4 : gérer le résultat de l’achat
onCompletion reçoit un Result<CheckoutPurchaseResult, Error>. En cas de réussite, vous récupérez :
Utilisez-le pour afficher un écran de confirmation, lancer l’expédition ou conserver le reçu dans vos propres registres.
Étape 5 : configurer votre variante
Chaque article achetable nécessite une variante dans votre tableau de bord Whop :1
Créer une variante
Accédez à votre tableau de bord > Products > sélectionnez votre produit > Variants > Create variant.
2
La définir comme ponctuelle
Choisissez One-time payment et définissez le prix.
3
(Facultatif) Définir des limites de stock
Pour les éditions limitées, définissez un plafond de stock. Le checkout l’applique automatiquement : lorsque le stock est épuisé, les achats s’arrêtent.
4
Copier l'ID de la variante
L’ID conserve le préfixe
plan_. Transmettez-le via le paramètre de compatibilité Checkout.ApplePayButton(planId:).Gérer le traitement des commandes avec les webhooks
Pour les biens physiques, vous aurez besoin d’un webhook côté serveur pour déclencher l’expédition après un achat réussi. Écoutez l’événementpayment.succeeded :
Le callback
onCompletion côté client confirme le paiement à l’utilisateur, mais c’est votre serveur qui doit traiter la commande via les webhooks : ne vous fiez pas uniquement au client. Consultez le guide des webhooks complet pour la configuration.Exemple complet
Une vue minimale de détail d’article avec sélection de taille et Apple Pay :Prochaines étapes
Webhooks
Gérez les événements de paiement et déclenchez le traitement des commandes
Éligibilité à Apple Pay
Vérifiez que votre app est éligible selon les App Store Review Guidelines
Créer un paywall
Vendez des abonnements plutôt que des achats ponctuels
Référence de l'API
Documentation complète du SDK

